Templates Reference

Templates

Mast ships with the full Shopify standard template set plus 13 specialized page templates for brand storytelling, editorial content, and customer service.


How templates work

Mast uses Shopify Online Store 2.0 JSON templates. A template is a JSON file that declares which sections appear on that page and in what order. Templates do not contain markup: they are configuration, not code.

Because templates are JSON, merchants can add, remove, and reorder sections on any page using the theme editor without editing any files. This applies equally to standard and specialized templates.

Specialized templates (the page.* variants) are assigned to specific pages in the Shopify admin. From the Pages section, open any page and use the Theme template dropdown to select which template it uses.


Standard templates

Required by Shopify. Every theme must include these templates.

Home

index.json

The store homepage. Designed for editorial storytelling with a full-page composition of sections arranged like a magazine issue.

Sections: Image Banner, Chapter, Featured Collection, Lookbook, Press, Rich Text, Newsletter

  • Begins with an Image Banner or Chapter opener for a strong first impression
  • Featured Collection section drives product discovery without feeling like a catalog
  • Lookbook section adds editorial credibility
  • Newsletter and Press sections round out a complete homepage composition

Product

product.json

The product detail page (PDP). Designed to showcase individual products with editorial weight while maintaining a clear path to purchase.

Sections: Product media gallery, product info, collapsible content, related products

  • Gallery supports grid, carousel, and filmstrip layouts
  • Sticky form: the variant picker and add-to-cart button stick while the gallery scrolls
  • Variant picker supports dropdown, button tile, and swatch display modes
  • Collapsible Content blocks for care, shipping, and returns below the fold
  • Related products section with algorithmic or manual product selection
  • Recently viewed products section
  • App block zones above and below the add-to-cart form

Collection

collection.json

The collection listing page. Balances product discovery with editorial framing through a header banner, configurable grid, and filtering sidebar.

Sections: Collection banner, product grid, pagination

  • Optional collection header with image, title, and description
  • Configurable grid: 2, 3, or 4 columns on desktop
  • Filtering sidebar or horizontal filter bar with active filter tags
  • Sort dropdown: manual, best selling, price, newest, featured
  • Infinite scroll or pagination with customizable page size
  • Quick-add support on product cards

Blog

blog.json

The blog listing page (journal archive). Renders article cards in a magazine-style layout with category filtering.

Sections: Blog header, article grid, tag filter, pagination

  • Magazine layout: first article large and featured, subsequent articles in a grid
  • Tag-based category filtering rendered as a tab or pill strip
  • Author, date, and reading time shown on each card
  • Pagination with configurable articles per page

Article

article.json

Individual blog article template. Designed for long-form editorial reading with a clean typographic presentation.

Sections: Article header, article body, related articles

  • Full-width hero image above the article header
  • Narrow reading column with generous line height and paragraph spacing
  • Author byline and publication date in the article header
  • Table of contents generated from h2 headings in the article body
  • Share buttons for social platforms
  • Related articles section at the end
  • Comment section vía Shopify Comments (optional)

Cart

cart.json

The full cart page. An alternative to the cart drawer for stores that prefer a dedicated cart experience.

Sections: Cart items, cart summary, upsells

  • Line items with inline quantity editor and remove button
  • Order notes field
  • Shipping estimate calculator
  • Upsell product suggestions below the cart summary
  • Accepts the same app blocks as the cart drawer

Page (default)

page.json

The default page template. A clean reading template for About, Contact, and other informational pages.

Sections: Page header, page content

  • Page header with title derived from the Shopify page title
  • Rich text content area for the page body
  • Section zones above and below the content for additional sections

Search

search.json

The search results page. Displays matched products, articles, and pages in separate tabs.

Sections: Search form, search results

  • Search bar pre-filled with the current query
  • Results segmented by type: Products, Articles, Pages
  • Product results use the same card component as collection pages
  • No-results state with suggested queries and a newsletter capture

404

404.json

The not-found page. Uses editorial design to turn an error into a brand moment.

Sections: 404 hero, search, featured collection

  • Large typographic 404 rendered in heading font at display scale
  • Brand-appropriate copy suggesting next steps
  • Search bar for immediate recovery
  • Featured collection or homepage link as fallback navigation

Password

password.json

The coming-soon page shown when the store is password protected. Full editorial presentation for pre-launch campaigns.

Sections: Password hero, newsletter

  • Full-screen background image with overlay
  • Store name and tagline
  • Countdown timer (optional) for launch date
  • Newsletter signup to capture early interest
  • Admin login link

Gift Card

gift_card.liquid

The gift card confirmation page shown after a gift card purchase. Displays the card value, code, and print/share options.

Sections: Gift card display

  • Gift card code displayed prominently
  • QR code for mobile redemption
  • Print button
  • Share by email option

Specialized page templates

Alternate templates for the Shopify Page resource. Assign them to pages from the Pages admin: open a page and select the template from the Theme template dropdown in the sidebar.

Template nameFileUse case
Studiopage.studio.jsonA portfolio-style page for showcasing the brand's atelier, studio, or production process with large imagery and minimal text.
Craftpage.craft.jsonAn editorial deep-dive on materials, techniques, and craftsmanship. Suited for brands with a strong artisanal story.
Carepage.care.jsonA product care guide page with collapsible sections per material type and clear visual instructions.
Lookbookpage.lookbook.jsonA standalone lookbook page for seasonal campaigns or editorial shoots. Functions like a magazine spread.
Stockistspage.stockists.jsonA retail stockist directory organized by region, with map embed support.
Presspage.press.jsonA press kit page with media coverage, press assets, and contact information for journalists.
FAQpage.faq.jsonA dedicated FAQ page with topic-grouped accordion sections for comprehensive customer support coverage.
Manifestopage.manifesto.jsonA brand manifesto or values page with long-form editorial typography and full-bleed image breaks.
Mendingpage.mending.jsonA repair and mending services page for brands that offer garment repair or customization services.
Archivepage.archive.jsonA seasonal collection archive page with a chronological grid of past collections and campaign imagery.
Circlepage.circle.jsonA membership or loyalty program landing page explaining the brand's community program.
Shippingpage.shipping.jsonA shipping and delivery information page with rates, timelines, and carrier details by region.
Size Guidepage.size-guide.jsonA comprehensive size guide with measurement tables, fit notes, and how-to-measure instructions.

Studio

page.studio.json

A portfolio-style page for showcasing the brand's atelier, studio, or production process with large imagery and minimal text.

  • Full-viewport image sections for immersive presentation
  • Process steps in a numbered editorial layout
  • Craftsperson or team profiles section
  • Optional video embed for studio footage

Craft

page.craft.json

An editorial deep-dive on materials, techniques, and craftsmanship. Suited for brands with a strong artisanal story.

  • Chapter openers for each material or technique
  • Alternating image-text layout for detailed explanations
  • Material specification tables
  • Image caption system for attributing photographers and locations

Care

page.care.json

A product care guide page with collapsible sections per material type and clear visual instructions.

  • Material category tabs (Wool, Cotton, Leather, Silk, Synthetics)
  • Step-by-step care instructions in an icon-supported list
  • Warning callout blocks for common care mistakes
  • Downloadable care guide PDF link (manual)

Lookbook

page.lookbook.json

A standalone lookbook page for seasonal campaigns or editorial shoots. Functions like a magazine spread.

  • Contents section with chapter navigation
  • Image Banner openers per chapter
  • Lookbook grid sections with hotspot product tagging
  • Chapter section dividers between editorial segments
  • Credits section at the close

Stockists

page.stockists.json

A retail stockist directory organized by region, with map embed support.

  • Region tabs or accordion groups
  • Store entries with name, address, phone, and URL
  • Optional Google Maps embed per region
  • Search/filter by country or city

Press

page.press.json

A press kit page with media coverage, press assets, and contact information for journalists.

  • Publication logo grid with links to articles
  • Featured pull quotes from major coverage
  • Downloadable press kit link
  • Press contact information
  • High-resolution image gallery for media use

FAQ

page.faq.json

A dedicated FAQ page with topic-grouped accordion sections for comprehensive customer support coverage.

  • Topic navigation anchors at the top (Ordering, Shipping, Returns, Product Care)
  • Multiple FAQ sections, one per topic, each with up to 20 questions
  • Search bar for filtering questions by keyword
  • Contact CTA at the end for unanswered questions

Manifesto

page.manifesto.json

A brand manifesto or values page with long-form editorial typography and full-bleed image breaks.

  • Opening Chapter section for the manifesto title
  • Narrow reading column for focused prose reading
  • Full-bleed image breaks between sections
  • Pull quote blocks for key statements
  • Colophon-style closing with brand attribution

Mending

page.mending.json

A repair and mending services page for brands that offer garment repair or customization services.

  • Service listings with pricing and turnaround times
  • Before/after image pairs
  • Submission form for repair requests
  • FAQ section for common repair questions

Archive

page.archive.json

A seasonal collection archive page with a chronological grid of past collections and campaign imagery.

  • Year-grouped collection entries
  • Campaign image thumbnails linking to collection pages
  • Season and year labels in accent font
  • Masonry or uniform grid layout options

Circle

page.circle.json

A membership or loyalty program landing page explaining the brand's community program.

  • Tier breakdown in a comparison layout
  • Member benefits list with visual icons
  • Testimonials from current members
  • Join CTA with account creation link

Shipping

page.shipping.json

A shipping and delivery information page with rates, timelines, and carrier details by region.

  • Domestic and international rate tables
  • Estimated delivery timeline infographic
  • Carrier name and tracking instructions
  • Customs and duties disclosure for international orders

Size Guide

page.size-guide.json

A comprehensive size guide with measurement tables, fit notes, and how-to-measure instructions.

  • Measurement tables for each garment category
  • How-to-measure illustrated guide
  • Model measurements and what size they wear
  • Fit philosophy note (true to size, size up, etc.)
  • Unit converter (cm / inches)

Creating additional templates

You can create additional page templates directly in the Shopify theme editor. From any template, click the duplicate button to create a copy with a new name. The duplicate starts with the same section configuration as the original and can be customized independently.

For developers, templates can also be created by adding new JSON files to the templates/ directory of the theme. The file must be named page.custom-name.json for a page template, or product.custom-name.json for a product template.