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).

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)