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.page.about — Heritage / brand story
Every block is editable from the Theme Editor — replace the founders’ photograph, retune the manifesto, swap the trust strip icons.
page.lookbook — Seasonal 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
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:
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 newpage.[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.