Skip to main content

Page Templates

Ronin ships 20 page templates (JSON) plus a gift card template. A template defines which sections a page starts with and in what order. You can edit any template in the theme editor, and you can create further variants of your own from the same starting points.

Homepage templates​

Ronin comes with five complete homepages. Index is the default homepage; the four Home templates are alternate homepages that you can copy onto the index page or assign to any page. Each one is a full story built from hero, product, editorial, and media sections.

TemplateSections included
Index (default) — index.jsonHero exhibit, Video, Collection scroll, Statement, Featured products, Trust badges, Product specs, Statement punch-in, Shop clips, Testimonial, Program, FAQ accordion, Social grid, Nav feature
Home 2 — page.home-2.jsonHero move, Featured products, Collection index, Press marquee, Spec reveal sticky, Program, Social grid, Collection tabs, Product specs, Statement punch-in, Combo product, Quote switcher, Statement, FAQ accordion
Home 3 — page.home-3.jsonHero slideshow, Collection carousel, Shop the look (two, the second reversed), Scroll story, Statement, Promo countdown, Hotspot, Lookbook depth, Press marquee, Journal, Testimonial depth, FAQ accordion
Home 4 — page.home-4.jsonHero panels, Collection scroll, Process (sticky), Featured products, Statement, Product specs, Lookbook gallery, Video stack, Trust badges, Testimonial, Journal, FAQ accordion
Home 5 — page.home-5.jsonHero split, Press marquee, Collection scroll, Hotspot, Process (sticky), Featured products, Quote switcher, Combo product, Statement, Spec reveal sticky, Lookbook gallery, Photo shrink promo, FAQ accordion

To switch your store to one of the alternate homepages, follow Change the homepage preset.

Product templates​

Ronin includes three product page layouts. All three use the Product information section with the same product blocks (Vendor, Title, Price, Variant picker, Buy button, Inventory status, Description, and three Collapsible rows) and a sticky quick-add cart. They differ in the sections that follow the product and, for Product 3, in how the media is laid out.

TemplateMedia layoutSections included
Product (default) — product.jsonCarousel, stickyProduct information, Trust badges, Product specs, Statement punch-in, Testimonial, FAQ accordion, Product recommendations
Product 2 — product.product-2.jsonCarousel, stickyProduct information, Product specs, Spec reveal sticky, Statement punch-in, Quote switcher, FAQ accordion, Product recommendations
Product 3 — product.product-3.jsonStackProduct information, Statement, FAQ accordion, Product recommendations

The Stack media layout shows every product image at once in a justified wall instead of one slide at a time, while the product details stay pinned beside it. See Product information for all product page settings, and Change the product template for assigning a template to a product.

Collection templates​

TemplateSections included
Collection (default) — collection.jsonCollection banner, Main collection

Ronin ships a single collection template. The Main collection section renders the product grid, filters, sorting, and pagination, with an Editorial banner block placed inside the grid. Its Filter type setting switches the filters between Horizontal (the default, a bar above the grid), Vertical (a column beside the grid), and Drawer (a side drawer opened from a button), so you can change the filter layout without a separate template.

Blog and article templates​

TemplateSections included
Blog — blog.jsonBlog intro, Main blogs
Article — article.jsonMain article, Article list

The blog listing uses the Main blogs section, and each post uses the Main article section with an Article list beneath it to suggest more reading.

Page templates​

TemplateSections includedBest for
Page (default) — page.jsonMain pageAny standard page: policies, shipping information, general content
About — page.about.jsonAbout hero, About story, About values, Trust badges, ProgramBrand story pages
Contact — page.contact.jsonContactA contact form with store details

Assign these from the page's Theme template dropdown in Online Store > Pages. The Main page section also accepts theme blocks, so you can add content below the page text without creating a new template.

Special page templates​

TemplateSections includedDescription
Cart — cart.jsonMain cartThe full cart page, with optional cart attribute fields
Search — search.jsonSearch, Main search, Article listSearch header, results with filters and sorting, and recent articles
List collections — list-collections.jsonCollectionsThe /collections page listing every collection
404 — 404.jsonMain 404Page not found
Password — password.jsonMain passwordThe storefront password page shown while the store is locked; the password layout adds the Password footer beneath it
Gift card — gift_card.liquid—A Liquid template that renders the gift card and its code

Customer account templates​

Ronin 1.0.0 does not ship customer account templates; the templates/customers folder is empty. Login, registration, order history, and address pages are served by Shopify's new customer accounts, which you manage in Settings > Customer accounts. Those pages use Shopify's own layout and branding settings rather than theme sections.

Main page sections​

Each template is anchored by a main section that renders the page's core content. These sections have no presets (Main page is the one exception) and come with their template.

SectionTemplateWhat it renders
Product informationProduct, Product 2, Product 3Gallery, title, price, variant picker, buy button, and the product blocks
Main collectionCollectionProduct grid, filters, sorting, and pagination
Main cartCartLine items, cart attributes, notes, discounts, and the order summary
Main articleArticleTags, title, published date, featured image, content, share links, and comments
Main blogsBlogThe article listing for a blog, as a carousel, grid, or masonry
Main pagePagePage title and rich text content, plus any theme blocks you add
CollectionsList collectionsThe grid of all collections
SearchSearchThe search header and heading
Main searchSearchSearch results, with filters and sorting
Main 404404The error code, not found message, and a button back into the store
Main passwordPasswordThe logo, message, and optional newsletter signup; Password footer is its companion, rendered by the password layout beneath it

How to assign a template​

Templates are assigned per resource in the Shopify admin, not in the theme editor.

  1. In your Shopify admin, open the resource you want to change, for example Products > [product] or Online Store > Pages > [page].
  2. Scroll to the Theme template card in the right-hand column (on some pages it is titled Online store).
  3. Open the dropdown and choose the template, for example product-2 for a product or about for a page.
  4. Click Save. The page now renders with the sections of that template.

For step-by-step walkthroughs, see Change the homepage preset and Change the product template.

tip

To create a new template variant, open the theme editor, pick the page type from the top dropdown, and click Create template. Base it on the existing template that is closest to what you want, then adjust its sections.