River — editorial fashion theme docs →

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.

  1. Section settings — gallery layout, zoom, sticky cart (slide 1).
  2. Blocks — vendor → buy buttons → upsell (table below).
  3. Product Details — Collapsible row + metafields (second slider).

1. Section & Variant picker

Theme editor Default product template with Product section layout media sticky cart settings and preview of Minimal Slip Dress
Theme editor Variant picker block settings Buttons Capsule swatch size and size chip size on product page

Select Product in the left list. Right panel settings in the screenshot:

  • Layout — Breadcrumbs on · Media aspect Portrait · Thumbnails Left
  • Media — Image zoom on · Corner radius 8 px
  • Sticky cart — On (bar after you scroll past Add to cart)
  • Appearance — Background Default · Top padding 32 px

Sale / % OFF on the image = compare-at price (not a metafield).

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.

Shopify Admin product Metafields panel with Care instructions and Additional information fields highlighted
Theme editor Collapsible row Size and Fit accordion with Additional information dynamic source connected

Admin steps

  1. Settings → Custom data → Products — add (or use) Additional information (custom.additional_information) and Care instructions (custom.care_instructions).
  2. Open the product → Metafields → fill both fields → Save.
  • Top category chips (Color, Fabric, Care instructions…) are Shopify category attributes — not the custom accordion metafields.
  • Offer label / Offer end on this panel = card countdown, not the accordion.

5. Quick edit path

  1. Customize → Products → Default product.
  2. Click Product for gallery / sticky cart · expand blocks to reorder.
  3. For Details accordion: fill metafields in Admin, connect them on Accordion row Text.
  4. 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.

  1. Section settings — breadcrumbs, pagination, columns (first screenshot).
  2. Filters — Vertical · Horizontal · Drawer layouts (3-slide set).
  3. Header & product card — banner + card stack (table below).

1. Collection section

Theme editor Default collection with Collection section selected showing breadcrumbs products per page pagination columns and padding
Select Collection in the left list. Layout, appearance, and padding appear on the right.
  • 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/laptop 3 · Mobile 1 or 2.
  • 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.

Theme editor Filters block with Desktop filter layout Vertical sidebar and preview of FILTER and SORT sidebar
Theme editor Filters block with Desktop filter layout Horizontal top bar and preview of filter dropdowns above the grid
Theme editor Filters block with Desktop filter layout Drawer and FILTER and SORT drawer open over the collection

Vertical (sidebar) — filters sit left of the grid (Sort by, Size, Color, Price…).

  • Desktop filter layout — Vertical (sidebar)
  • Sticky sidebar on desktop — keeps the filter column in view while scrolling (off in the screenshot)
  • Enable filtering / Enable sorting / Show product count — all on
  • Filter button label — Filter & Sort (also used on drawer / mobile)

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

4. Admin filters

  1. In Shopify Admin, set up storefront filters (Search & Discovery or collection filters).
  2. Size, Color, Price, Product type, Category, etc. then appear in the theme Filters UI.
  3. If a filter group is missing in preview, check Admin filter availability for that collection — not a missing theme setting.

5. Quick edit path

  1. Customize → Collections → Default collection.
  2. Select Collection for columns / pagination · Filters for Vertical / Horizontal / Drawer.
  3. Edit Collection header for the banner · Product card for card layout.
  4. 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.

Theme editor Cart page with Continue shopping link cart note free shipping progress and padding settings, preview showing Your bag with line items and summary
Select Cart in the left list. Content, free shipping bar, and padding appear on the right.

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

  1. Customize → open the Cart template.
  2. Select Cart → set continue link, cart note, free shipping bar, padding.
  3. Set free-shipping threshold / messages in Theme settings → Cart if needed.
  4. Preview with items in the bag → 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.

Theme editor Default blog with Blog section settings eyebrow articles per page card background and breadcrumbs
Theme editor Default blog post with Article section eyebrow breadcrumbs tips image pull quote and related articles

Blog (index)

Select Blog under the Default blog template.

  • Content
    • Eyebrow — Screenshot: Journal (small label above the blog title).
    • Show article count — Off in the screenshot.
    • Articles per page — Screenshot: 9.
    • Card background — Screenshot: #F4EFE8.
  • Layout — Show breadcrumbs (on in the screenshot).
  • Appearance
    • Accent — Screenshot: #5E2D33.
    • Background — Default.

Article title, image, and date on each card come from the blog posts in Admin. The large page title (e.g. News) is the blog name.

Quick edit path

  1. Blog index — Customize → Blog posts → Default blog → select Blog → eyebrow, cards, accent.
  2. Article — Customize → Blog posts → Default blog post → select Article → eyebrow, tips, pull quote, related.
  3. Write posts and featured images in Admin → Blog posts.
  4. 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.

Theme editor 404 page with Not found section and Products Grid settings for Dresses and Gowns collection
404 page: Not found + Products Grid below.

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

  1. Customize → open the 404 page template.
  2. Keep or restyle Not found; edit or remove Products Grid as needed.
  3. 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.

Theme editor Password template with Password section selected showing image heading subheading authorized note botanical decoration and corner radius
Password template: select Password. Preview shows RIVER logo, arched image, and Enter password form.

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”).
  • 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

  1. Enable the store password in Admin → Online Store → Preferences (or open Customize → Password while gated).
  2. Select Password → set image, heading, subheading, authorized note, botanical art, corner radius.
  3. Preview → Save.