Templates
JSON templates compose River’s sections into full pages — product, collection, cart, search, blog, and system pages. Merchants rearrange sections and blocks in the theme editor without code.
Path: Online Store → Themes → Customize → open a template from the top bar
Click any screenshot to view it full size. Use the sidebar to jump between templates.
Product
Path: Customize → Products → Default product
Gallery on the left, product info blocks on the right. Use the arrows under each screenshot set — only that slide’s notes show below.
- Section settings — gallery layout, zoom, sticky cart (slide 1).
- Blocks — vendor → buy buttons → upsell (table below).
- Product Details — Collapsible row + metafields (second slider).
1. Section & Variant picker
2. Blocks (top to bottom)
Reorder or hide any block under Product. Demo order:
| Block | Shows | Quick note |
|---|---|---|
| Vendor | Brand line (e.g. RIVER) | Text style / size / color |
| Product title | Product name | Main heading |
| Product price | $168 · $198 · 15% OFF | Compare-at + discount badge toggles |
| Product rating | 4.8 · 124 Reviews | From review app metafields |
| Description | Product description | From Admin → Products |
| Variant picker | Color + Size | See slide 2 above |
| Size chart | SIZE GUIDE link | Block settings (image + tables), not metafields |
| Buy buttons | Qty · Add to cart · Buy it now | Dynamic checkout / selling plans |
| Volume pricing | Bulk price breaks | Only if set in Admin |
| Service benefits | Free Shipping / Returns / Secure | Nested Icon with text blocks |
| Product upsell | Complementary products | Manual picks, collection, or Search & Discovery |
App blocks (@app) can be added where the section allows.
3. Metafields cheat sheet
| Used by | Metafield / source | Where you set it |
|---|---|---|
| Product rating | reviews.rating · reviews.rating_count |
Review app |
| Color swatches | Admin color / variant image | Theme settings → Product swatches |
| Product upsell | Complementary products | Search & Discovery (or manual picks) |
| Offer countdown (optional) | custom.offer_end · custom.offer_label |
Product → Metafields |
| Size & Fit row | custom.additional_information |
Product → Metafields |
| Care Instructions row | custom.care_instructions |
Product → Metafields |
Size Guide content and Sale badges are not metafields.
4. Product Details (Collapsible row)
Path: Default product → Collapsible row
“The Details” accordion under the buy area. Two custom metafields feed Size & Fit and Care.
5. Quick edit path
- Customize → Products → Default product.
- Click Product for gallery / sticky cart · expand blocks to reorder.
- For Details accordion: fill metafields in Admin, connect them on Accordion row Text.
- Preview desktop + mobile → Save.
Collection
Path: Customize → Collections → Default collection
Banner + filters + product grid. Select Collection for grid settings, or open Filters / Collection header / Product card for nested controls. Slider arrows show only that slide’s notes.
- Section settings — breadcrumbs, pagination, columns (first screenshot).
- Filters — Vertical · Horizontal · Drawer layouts (3-slide set).
- Header & product card — banner + card stack (table below).
1. Collection section
- Products per page — Screenshot:
16. -
Pagination
- Paged numbers — classic page links (screenshot).
- Load more — button loads the next page.
- Infinite scroll — loads as the shopper scrolls.
- Pagination always works without JavaScript. Load more and infinite scroll enhance it when JS is available.
- Columns — Desktop
4· Tablet/laptop3· Mobile1or2. - Grid spacing — Screenshot:
18 px. - Appearance — Background Default · Top/Bottom padding
48 px.
2. Filters (3 layouts)
Select Filters under Collection. Filter groups (Size, Color, Price…) come from Admin / Search & Discovery — the theme controls layout and sorting UI. On mobile, filters always open in a drawer.
3. Header & product card
| Block | What it does | Key settings |
|---|---|---|
| Collection header | Banner + collection title (screenshot: Dresses & Gowns) | Show image · optional override image · height · corner radius · title / description · content position |
| Filters | Filter & sort UI | See section 2 above |
| Product card | How each product looks in the grid | Gap · corner radius · badges · border · nested image / title / price / swatches |
- Card look also follows Theme settings → Product card and Badges.
- Swatch style → Theme settings → Swatches.
- Demo template may also include a Collection list section below the grid — see Sections → Collection list.
4. Admin filters
- In Shopify Admin, set up storefront filters (Search & Discovery or collection filters).
- Size, Color, Price, Product type, Category, etc. then appear in the theme Filters UI.
- If a filter group is missing in preview, check Admin filter availability for that collection — not a missing theme setting.
5. Quick edit path
- Customize → Collections → Default collection.
- Select Collection for columns / pagination · Filters for Vertical / Horizontal / Drawer.
- Edit Collection header for the banner · Product card for card layout.
- Preview desktop + mobile → Save.
Cart
Path: Customize → Cart (cart page template)
Full cart page: line items, quantity, totals, optional order note, free shipping progress, and checkout. The drawer/popup after add-to-cart is configured under Theme settings → Cart — this page is the dedicated cart template.
Cart page settings
-
Content
- Continue shopping link — Screenshot: All Products. Used for “Continue shopping” when the bag is empty or from the summary.
- Enable cart note — On in the screenshot (Order note in the summary column).
-
Free shipping bar
- Show free shipping progress — On in the screenshot (“Almost free shipping” / amount remaining).
- Uses the same threshold and messages as Theme settings → Cart drawer. Change the dollar threshold and copy there; this toggle only shows/hides the bar on the cart page.
-
Appearance
- Background — Default in the screenshot.
- Top padding / Bottom padding — Screenshot:
48 px/64 px.
What shoppers see
| Area | Shows |
|---|---|
| Line items | Product, price, quantity (− / +), total |
| Free shipping bar | Progress toward free shipping (Theme settings threshold) |
| Order note | Optional note when Enable cart note is on |
| Summary | Subtotal + Checkout → · Secure checkout |
- Quantity updates and remove work on the cart form; checkout submits the cart.
- Discounts / selling plans appear when the cart has them (Shopify cart behavior).
- For drawer vs page after add to cart, accelerated checkout buttons, and free-shipping threshold copy → Theme settings → Cart.
Quick edit path
- Customize → open the Cart template.
- Select Cart → set continue link, cart note, free shipping bar, padding.
- Set free-shipping threshold / messages in Theme settings → Cart if needed.
- Preview with items in the bag → Save.
Search
Path: Customize → Search (search results template)
Full search results page: query field, result count, filters/sort, and product grid. Header predictive search overlay is under Theme settings → Search — this template is the results page after submit.
Search section settings
-
Content
- Products per page — Screenshot:
16. - Enable filtering — On (sidebar Sort by, Size, Color, Price… in the preview).
- Enable sorting — On (screenshot sort: Relevance).
- Products per page — Screenshot:
-
Layout
- Columns on desktop — Screenshot:
3. - Columns on mobile —
1or2(screenshot:2). - Grid spacing — Screenshot:
18 px.
- Columns on desktop — Screenshot:
-
Appearance / Padding
- Background — Default.
- Top padding / Bottom padding — Screenshot:
48 px/48 px.
Product card on results
Under Search → Product card (image pointed in the screenshot): same card stack as collections — image, title, price, swatches. Badges and optional offer countdown follow Theme settings / product metafields.
- Card gap, corner radius, badges, border → Product card block.
- Global card / badge / swatch defaults → Theme settings → Product card, Badges, Swatches.
Filters on search
- When filtering is on, search uses the same filter types as collections (Size, Color, Price, etc.).
- Filter availability comes from Admin / Search & Discovery — same idea as the Collection Filters docs.
- Empty query or no matches shows the empty results state on this template.
Quick edit path
- Customize → open the Search template.
- Select Search → set products per page, filtering/sorting, columns, padding.
- Expand Product card to style result cards.
- For the header search overlay (popular searches, predictive results) → Theme settings → Search.
- Run a search in preview → Save.
Blog & article
Path: Customize → Blog posts → Default blog · Customize → Blog posts → Default blog post
Two templates: the journal index (Blog) and a single post (Article). Use the slider — each slide’s notes show below.
Quick edit path
- Blog index — Customize → Blog posts → Default blog → select Blog → eyebrow, cards, accent.
- Article — Customize → Blog posts → Default blog post → select Article → eyebrow, tips, pull quote, related.
- Write posts and featured images in Admin → Blog posts.
- Preview → Save.
404
Path: Customize → 404 page
Shown when a URL does not exist. Demo stack: Not found message + a Products Grid so shoppers can keep browsing.
Not found
- Shows 404, Page not found., and Back to shopping (links to all products).
- Copy comes from theme locale strings — the Not found section has no merchant settings in the right panel.
Products Grid (optional below)
In the screenshot this is a Products spotlight section renamed Products Grid. For layout, collection, columns, view all, and botanical art, see Sections → Products spotlight (Product Cards / Product Grid / Product Slider).
Quick edit path
- Customize → open the 404 page template.
- Keep or restyle Not found; edit or remove Products Grid as needed.
- Preview a bad URL on the storefront → Save.
Password
Path: Customize → Password
Shown when the online store is password-protected (Admin → Online Store → Preferences → password). Uses its own layout — centered logo + media/form card — not the normal header/footer.
Password section settings
-
Content
- Image — Arched panel photo (screenshot:
article-the-quiet-edit.jpg). - Heading — Screenshot:
This shop is private. - Subheading — Screenshot:
Please enter the password to access our store.If blank, River can use the Admin shop password message. - Show authorized access note — On in the screenshot (“Authorized access only”).
- Image — Arched panel photo (screenshot:
-
Appearance
- Show botanical decoration — On in the screenshot.
- Corner radius — Screenshot:
20 px.
- Logo on this page follows Theme settings → Logo.
- The storefront password value is set in Admin — the theme only styles the page and copy. Shoppers use Enter password → Enter →.
Quick edit path
- Enable the store password in Admin → Online Store → Preferences (or open Customize → Password while gated).
- Select Password → set image, heading, subheading, authorized note, botanical art, corner radius.
- Preview → Save.