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.jsonThe 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.jsonThe 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.jsonThe 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.jsonThe 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.jsonIndividual 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.jsonThe 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.jsonThe 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.jsonThe 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.jsonThe 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.jsonThe 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.liquidThe 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 name | File | Use case |
|---|---|---|
| Studio | page.studio.json | A portfolio-style page for showcasing the brand's atelier, studio, or production process with large imagery and minimal text. |
| Craft | page.craft.json | An editorial deep-dive on materials, techniques, and craftsmanship. Suited for brands with a strong artisanal story. |
| Care | page.care.json | A product care guide page with collapsible sections per material type and clear visual instructions. |
| Lookbook | page.lookbook.json | A standalone lookbook page for seasonal campaigns or editorial shoots. Functions like a magazine spread. |
| Stockists | page.stockists.json | A retail stockist directory organized by region, with map embed support. |
| Press | page.press.json | A press kit page with media coverage, press assets, and contact information for journalists. |
| FAQ | page.faq.json | A dedicated FAQ page with topic-grouped accordion sections for comprehensive customer support coverage. |
| Manifesto | page.manifesto.json | A brand manifesto or values page with long-form editorial typography and full-bleed image breaks. |
| Mending | page.mending.json | A repair and mending services page for brands that offer garment repair or customization services. |
| Archive | page.archive.json | A seasonal collection archive page with a chronological grid of past collections and campaign imagery. |
| Circle | page.circle.json | A membership or loyalty program landing page explaining the brand's community program. |
| Shipping | page.shipping.json | A shipping and delivery information page with rates, timelines, and carrier details by region. |
| Size Guide | page.size-guide.json | A comprehensive size guide with measurement tables, fit notes, and how-to-measure instructions. |
Studio
page.studio.jsonA 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.jsonAn 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.jsonA 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.jsonA 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.jsonA 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.jsonA 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.jsonA 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.jsonA 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.jsonA 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.jsonA 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.jsonA 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.jsonA 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.jsonA 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.