A theme controls how your storefront looks and behaves — the layout (header, footer, cart), the sections on each page (hero banners, product grids, product pages), and a set of theme-wide settings (accent color, announcement bar text, and similar). Exactly one theme is active for your shop at a time.

Switching themes#

Go to Theme in the admin. You'll see your Active theme at the top, and an Available themes list below it with every other theme installed on the platform. Click Activate next to a theme, confirm in the dialog ("Switch the live storefront to {theme}?"), and the switch takes effect immediately — the next storefront request renders with the new theme's layout and sections.

Switching themes doesn't touch your products, images, or orders — only which theme renders them, and how that theme's own settings are configured.

Theme settings#

If the active theme has configurable settings (most do — things like an accent color or an announcement banner message), a Theme settings button appears on the active theme card. It opens a dialog with the theme's settings grouped by section (e.g. "Brand"); edit the fields and Save. Changes apply storefront-wide as soon as you save.

Each theme declares its own settings, so what you see here depends on which theme is active — a different theme may expose different fields entirely.

Page documents#

Further down the Theme page, Page documents shows the underlying JSON for any page your shop has customized beyond a theme's defaults (per template — index, product, collection, and so on). This is currently a read-only view for visibility into what's stored; a visual editor for page documents is coming in a later release.

What's next#

• Plugins — plugins contribute sections a theme doesn't provide itself (the cart drawer, search results, related products) — see how to enable and configure them.