Skip to main content
Every page in Voyager is a stack of sections. A section is one Liquid file (sections/*.liquid) with a JSON schema at the bottom — the schema is what the merchant configures in the Theme Editor. This page is the index. Each section lives in one of ten deep-dive pages, grouped by what it does.

The ten section groups

Hero & banners

Home hero, image banner, slideshow — full-bleed hero patterns.

Product sections

Main product (15 blocks), featured product, featured collection, new arrivals, related & complementary.

Editorial sections

Chapters, club, image-with-text, multicolumn, rich text, testimonials.

Commerce sections

Cart, collection (PLP), category archive, bundle.

Media sections

Video, logo list, map.

Engagement sections

Newsletter, contact form, blog posts, contact, blog index, article.

Custom & advanced

Custom Liquid and app blocks (@app).

Customer section templates

Login, register, account, order, addresses, password reset, activation.

Header & footer

Header, footer, announcement bar, and the two section groups that bind them.

The full catalog

47 sections in total, two section groups, and a handful of supporting partials (search, quick-view, password, 404). The table below is the master index.

Hero & banners

Product sections

Editorial sections

Commerce sections

Media sections

Engagement sections

Custom & advanced

Customer sections

These render only when Classic Customer Accounts is enabled in Shopify admin. Under New Customer Accounts, Shopify renders its own UI and these sections are bypassed.

Supporting sections

A few sections aren’t documented in the ten group pages because they render fixed UI rather than configurable layout. They’re listed here for completeness.

Template availability

Most sections can be added to any template, but several are pinned to a specific template by Shopify’s enabled_on schema field — usually the matching main-* section, plus product recommendation sections that only make sense on the PDP. The table below lists those constraints.

How section docs are organized

Each section reference page covers:
  1. Purpose — one-line summary of what the section does and when to use it.
  2. Template availability — where the section can live.
  3. Section settings — every schema setting, with its id, type, default, and what it controls.
  4. Block types — every block this section accepts, with its own settings.
  5. Max blocks — Shopify’s hard cap if one is set.
  6. When to use — practical guidance on which section to choose when several could fit.
Settings are documented using Mintlify’s <ParamField> component so each row is consistently typed and the defaults are explicit. Block types are listed with their limits where the schema sets a "limit".

Where to go next

Hero & banners

Start with the hero patterns — the loudest sections on the storefront.

Product sections

The longest page — main-product has 15 block types.

Header & footer

Every storefront has these. Configure them once and they’re everywhere.

Section schema tables

A reference-style compendium of every section’s settings in one place.