theme.liquid shell) and the predictive search endpoint (which returns JSON to the storefront’s predictive-search island).
JSON vs Liquid
The 24 templates
Voyager ships with twenty-four template files spanning storefront, customer, system, and alternate-page routes.Homepage
templates/index.json — six sections: hero, new arrivals, archive, bundle, chapters, club.Product page
templates/product.json — block-based main section with fifteen draggable blocks.Collection page
templates/collection.json — chip nav, filter sidebar, view-mode picker, product grid.Cart
templates/cart.json — drawer and page parity, accelerated checkout, notes.Blog and article
templates/blog.json and templates/article.json — editorial journal layout.Customer pages
Seven editorial templates — login, register, account, order, addresses, reset, activate.
Gift card
templates/gift_card.liquid — standalone passport with QR and Apple Wallet.Search and 404
templates/search.json, templates/404.json, templates/search.json.liquid.Alternate templates
page.about, page.lookbook, page.contact — three editorial page variants.Complete file list
Strictly twenty-three discrete files; the gift card is counted once. Shopify also auto-resolves a few additional endpoints (the cart drawer fragment, section refresh routes) that do not need a template file.
Assigning alternate templates
Voyager ships three alternatepage.* templates designed for specific editorial layouts — an About / Heritage page, a Lookbook gallery, and a Contact form. To use them, the merchant assigns the template on a per-page basis in admin.
1
Create the page in admin
Online Store → Pages → Add page. Give it a title (for example “Heritage” or “Lookbook”).
2
Pick the template in the sidebar
On the right side of the page editor, find the Theme template dropdown. Voyager’s alternate templates appear there:
page.about, page.lookbook, page.contact.3
Save, then customize in the Theme Editor
Once saved, open the page in the Theme Editor. The sections defined in
page.about.json, page.lookbook.json, or page.contact.json are now editable for that one page.page.json template stays in place for every other page — terms of service, privacy, FAQ — and renders the standard main-page section.
A note on customer accounts
Shopify offers two customer-account modes: Classic and New customer accounts. Voyager ships seven editorial templates for the Classic experience. If the merchant switches to New customer accounts in admin, Shopify takes over rendering and Voyager’s templates no longer appear. The trade-off is covered in detail on the Customer pages page.Voyager’s templates ship pre-wired with sensible defaults — most merchants never need to edit JSON directly. Everything that lives in a JSON template can be reordered, toggled, or replaced from the Theme Editor.
What’s next
Homepage in detail
Tour the six default sections and learn how to rearrange them.
Product page blocks
Every PDP block, what it renders, and which settings drive it.