Skip to main content
Beyond the default templates/page.json, Voyager ships three alternate page templates — each designed for a specific editorial purpose. They’re available to merchants from the Theme template dropdown in the page admin, so any page can be reassigned to one of these layouts with a single click.

Assigning an alternate template

The merchant assigns the template from Shopify admin, not from the Theme Editor.
1

Create the page in admin

Online Store → Pages → Add page. Give it a title (for example “Heritage”, “Spring 2026 Lookbook”, “Contact”).
2

Open the Theme template dropdown

In the page editor’s right sidebar, find the section labelled Theme template. The dropdown lists every page.* template Voyager ships with.
3

Choose the right template

Pick page.about, page.lookbook, or page.contact. The page reloads with the chosen template applied.
4

Customize in the Theme Editor

Open the page in the Theme Editor (/pages/heritage?_pb=0). The sections from the chosen alternate template are now editable.
The default page.json template still applies to every page that hasn’t been explicitly reassigned — terms of service, privacy, FAQ, shipping. Only pages with a non-default template route to the alternate layouts.

page.about — Heritage / brand story

The About template renders a long-form editorial page — designed for the brand story, the founders’ note, the manifesto. Layout: Every block is editable from the Theme Editor — replace the founders’ photograph, retune the manifesto, swap the trust strip icons.
The Lookbook template renders a fashion-house-style editorial gallery — designed for a season drop, a campaign, or an immersive product gallery. The grid uses a deliberate vertical rhythm: full-bleed image, then two-up, then one-up with a caption, then two-up again. The pattern can be tuned in the Theme Editor — each row is a block.

page.contact — Contact form

The Contact template renders Shopify’s built-in contact form helper inside Voyager’s editorial vocabulary. Form submissions route to Shopify’s built-in contact endpoint and arrive in the merchant’s email. Spam protection is handled by Shopify automatically.

What the default page.json looks like

For comparison — the plain page.json template:
The main-page section renders a single centered column with page.content as rich text, prefixed by a page.title heading. It’s intentionally generic — designed for legal pages, FAQ, shipping policy, anywhere a clean reading layout is the priority.

Creating new alternate templates

A merchant — or developer — can add more alternate templates by creating new page.[name].json files in the code editor. Common additions: Each new template appears in the Theme template dropdown automatically — no admin configuration required.

What’s next

Section reference

The main-page-* sections in detail.

Customization recipes

How to fork an alternate template into a new page variant.