LiquidGlobals

Purpose

This page documents the main global objects that are available to Noir Liquid templates.

These objects are not created by the theme; they are provided by the platform runtime and are used across Structure/, Components/ and Reusables/.

Root

Root is the main global object used by templates to access storefront runtime data.

Typical usage patterns:

Root.Page (page metadata and per-page data)

Root.Settings (runtime settings)

Root.Translations (global translations)

Notes:

The exact shape of Root depends on the current page and the services that delivered its view model.

GlobalData

GlobalData contains global storefront data that is shared across pages.

Typical usage patterns:

GlobalData.Settings (global feature flags and settings)

GlobalData.Header / GlobalData.Footer (data backing global layout areas, when present)

Notes:

Some settings are used as fallbacks in templates (example: a global “no image” setting used when a specific image is missing).

GlobalData.Settings.ShowStockQuantity — when true, the stock endpoint returns stockQuantity and Noir shows the quantity next to the availability label. Stock is loaded client-side through servicesreusabledefault.hydrateProductStock; see the Services reusable.

Product reviews flags. All three are false unless the store collects reviews and the company has the Product reviews module:

GlobalData.Settings.EnableProductReviews — the store collects and shows product reviews.

GlobalData.Settings.ShowRatingOnProductCards — product cards show the rating (product.rating).

GlobalData.Settings.ShowRatingOnProductPage — the product details (ProductSingle) show the rating (productData.rating).

The platform applies the two ShowRating… flags itself: product.rating and productData.rating are null while their flag is false. The ProductReviews component does not depend on them; it shows the rating and the reviews whenever the store collects reviews.

Settings (theme/page/component settings)

In most component and reusable templates, configuration is passed via a model object.

Common patterns:

model.Settings.Id — used for deterministic DOM ids.

model.Settings.CssClass — optional extra CSS classes.

Notes:

This is distinct from Root.Settings / GlobalData.Settings, which are global runtime settings.

LiquidGlobals

Purpose#

Root#

GlobalData#

Settings (theme/page/component settings)#

Purpose

Root

GlobalData

Settings (theme/page/component settings)