Section context files

Definition

Section context files are per-market overrides for a theme's section groups and templates. A file carrying a .context.<market> suffix replaces the settings of its base file when the storefront is serving that market. The layout stays single — one header, one footer, one template — while the content, ordering and copy inside it differ per market without a Liquid conditional.

Documented at https://shopify.dev/docs/storefronts/themes/markets/multiple-currencies-languages.

How we've used it

This is where market-specific copy belongs when it is copy rather than logic. The footer is the clearest case: the same blocks, the same newsletter capture, but marketing-consent language that has to read differently in Canada than in the US. Putting that difference in a context file keeps it in the theme editor, where the people accountable for the wording can read and change it, instead of burying it in a conditional only a developer will find. An announcement bar running a different offer per market is the same shape. The rule we work to: if two markets need different words, that's a context file; if they need different behavior, that's code, and it belongs in the section.

Builds using it

One gated build uses it; its page follows.

Related entities

Shopify Markets · Section groups · Theme locales and internationalization · JSON templates