BrandListStructuredData

Purpose

BrandListStructuredData emits Schema.org JSON-LD (ItemList of Brand) for the brand listing page, so search engines can index the full brand set and their page URLs.

Where it's rendered

Rendered from Components/BrandList/Default.liquid:

{% render 'Reusables\BrandListStructuredData\Default', brands: brands, canonicalUrl: canonicalUrl, companyDomain: companyDomain %}

Inputs (Liquid render parameters)

Named parameters:

brands

The list of brand objects shown on the page.

canonicalUrl

Used to derive the site origin (scheme + host) for building absolute brand URLs.

companyDomain

Fallback used to derive the site origin when canonicalUrl isn't available.

Model shape (storefront example)

[
  {
    "name": "Sample brand",
    "alias": "sample-brand",
    "mediaItem": { "link": "https://example.com/sample-logo.png" }
  }
]

Template behavior (Liquid + Alpine)

Renders nothing when brands is empty/missing.

Derives siteOrigin by splitting canonicalUrl (scheme://host), falling back to https://{companyDomain} when canonicalUrl isn't present.

Builds each brand's absolute URL as {siteOrigin}/brand/{brand.alias}, only when both brand.alias and siteOrigin are available.

Includes logo per item only when brand.mediaItem.link is present.

Data contract (JS runtime)

No client-side runtime state; all data is read directly from the Liquid render parameters at render time.

JavaScript

File: Reusables/BrandListStructuredData/Default.js
Exposes: brandliststructureddatareusabledefault (currently an empty object)

The JSON-LD block is fully server-rendered; the global only reserves a unique name in the concatenated componentscripts.js bundle.

Global Alpine stores

None. This reusable does not read or update any Alpine store.

Services / API calls

None. All data (brand list) is passed in as a render parameter; there are no client-side API calls.

Dependencies

Liquid: Reusables/BrandListStructuredData/Default.liquid

JS: Reusables/BrandListStructuredData/Default.js

Translations: Reusables/BrandListStructuredData/Default.json

Notes

If a brand has no alias, its ListItem.item is emitted without a url field rather than being skipped entirely.

BrandListStructuredData

Purpose#

Where it's rendered#

Inputs (Liquid render parameters)#

Model shape (storefront example)#

Template behavior (Liquid + Alpine)#

Data contract (JS runtime)#

JavaScript#

Global Alpine stores#

Services / API calls#

Dependencies#

Notes#