Glossary

Block — A reusable component defined in blocks/. Merchants add, remove and reorder blocks inside a section.

Static block — A theme block rendered at a fixed spot in a section’s layout rather than in the reorderable collection. Defined in the same blocks/ files; only the rendering differs.

Section — A full-width page component from sections/. What a merchant adds when they click “Add section” in the customizer.

Snippet — Shared Liquid code in snippets/, rendered with {% render %}. Takes parameters, has no schema, never appears in the customizer.

Schema — The JSON block inside a section or block file that defines its customizer settings.

Preset — Default settings and blocks applied when a merchant first adds a section. Changing a preset does not affect sections already on a page.

color_background — A Shopify setting type giving merchants a CSS background field with a gradient picker. Supports arbitrary colour stops, unlike a pair of colour swatches.

Color scheme — Shopify’s grouped colour settings (background, text, button). This theme mostly uses direct settings instead; see Conventions.

Theme editor sync — The --theme-editor-sync flag on shopify theme dev. Writes customizer changes back into local template JSON.

Metaobject — Shopify’s structured custom content. Used here for product tags and similar merchandising data.

visible_if — Schema property that conditionally shows a setting based on another setting’s value. Keeps the customizer uncluttered.

Dark context — A section marked data-theme="dark". Components inside invert their colours through shared CSS rather than each carrying its own dark variant.