River — editorial fashion theme docs →

Theme settings

Global controls that shape River storewide — Logo, Color palette, Typography, Layout, Style, Product card, Badges, Swatches, Cart, Search, Social media, Botanical Art, Decorative art, and Back to top.

Path: Online Store → Themes → Customize → Theme settings (gear icon)

Open Theme settings, expand a group, edit a control, then Save. The preview updates as you change values so you can judge the look before publishing.

Shopify theme editor showing River Theme settings: gear icon marked, setting groups in the left panel, and home page preview
Theme settings open in the Shopify editor (gear icon). Expand each group to edit logo, Color palette, typography, and more.
  • Use the gear icon (or Ctrl + 2 / ⌘ + 2) to open Theme settings.
  • Expand one group at a time — names match the editor list (Logo, Color palette, Typography…).
  • Click any screenshot to view it full size. Where a topic has several related shots, use the image slider (and lightbox arrows).
  • Always Save when you are happy with the preview.

Color palette

Path: Theme settings → Color palette

Storewide background, text, surface, accent, and button colors. Groups match the editor headers.

Theme settings Color palette open: Background, Surface, Accent, and Buttons color pickers with hex values
Theme settings → Color palette: Background, Surface, Accent, and Buttons. Accent/Button colors drive CTAs in the preview.
  • Background
    • Background — Page canvas (screenshot: #F7F4EF).
    • Text — Primary copy on the background (screenshot: #1C1917). Keep strong contrast.
  • Surface
    • Surface — Panels and soft structure (screenshot: #EDE8E0).
    • Surface text — Text on surface areas (screenshot: #1C1917).
  • Accent
    • Accent — Brand highlight for bars, links, and emphasis (screenshot: #6B2D3C).
    • Accent text — Text/icons on accent (screenshot: #F7F4EF).
  • Buttons
    • Button — Primary CTA fill (screenshot: #6B2D3C).
    • Button label — Text on primary buttons (screenshot: #F7F4EF). Keep high contrast, then Save.

Typography

Path: Theme settings → Typography

Fonts plus Desktop / Mobile sizes for each Text style. Editorial contrast: refined headings with readable body copy.

Theme settings Typography: Body font Jost, Heading font Libre Baskerville, and Text Styles Font Size for Eyebrow Display Title
Theme settings → Typography: Fonts and Text Styles Font Size. Screenshot shows Jost + Libre Baskerville.
  • Fonts
    • Body font — Navigation, paragraphs, UI (screenshot: Jost).
    • Heading font — Heroes and titles (screenshot: Libre Baskerville).
  • Text Styles Font Size — Each style has Desktop and Mobile. Screenshot values:
    • Eyebrow — 12 px / 11 px
    • Display — 48 px / 36 px
    • Title — 40 px / 30 px
    • Subtitle — 22 px desktop (scroll for mobile, default 18 px)
    • Normal — Body size further down the panel (defaults 16 px / 15 px). Adjust, preview, then Save.

Layout

Path: Theme settings → Layout

How wide content can grow, edge padding, and space between sections — storewide wherever River uses page-width layout.

Theme settings Layout with Page width dropdown open showing Narrow Standard Wide
Theme settings → Layout: Page width options open. Screenshot selects Standard; Spacing scale 8 px; Section spacing 48 px.

Page width

Maximum width for content on product, collection, cart, blog, and other page-width templates. Clearest on large desktop monitors.

Option Max width Feel
Narrow (90rem ≈ 1440px) Smaller More centered, editorial
Standard (100rem ≈ 1600px) Default (screenshot) Balanced for most stores
Wide (120rem ≈ 1920px) Larger Grids stretch closer to the edges
  • Page margin — Padding from the screen edge (16–64 px). Separate from Page width — keeps text and cards off the sides.
  • Spacing scale — Base unit for consistent theme spacing (screenshot: 8 px).
  • Section spacing — Vertical space between stacked sections (screenshot: 48 px). Mobile scales this down automatically. Preview on a large monitor, then Save.

Style

Path: Theme settings → Style

Corner radius on form inputs and buttons so interactive elements share one polish language.

Theme settings Style group open: input corner radius and button corner radius
Theme settings → Style: Input corner radius and Button corner radius.
  • Input corner radius — Rounds form fields such as newsletter email (0–16 px; default 2 px). Higher = softer.
  • Button corner radius — Rounds Subscribe and primary CTAs (0–40 px; default 0 px for a crisp fashion edge). Match input radius for one shared look, then Save.

Product card

Path: Theme settings → Product card

Controls the Quick add button on every product card and the Quick add popup.

Theme settings Product card Quick add with Image icon overlay selected and cart icon on product image
Theme settings → Product card → Quick add: Image icon overlay selected. Preview shows the cart icon on the product image.
  • Enable Quick add — Master switch for card Quick add + popup (on in the screenshot). Off sends shoppers to the product page to buy.
  • Quick add button label — Text for text-based styles (screenshot: Quick add). Keep it short.
  • Quick add button style — Same options as the screenshot dropdown:
    • Primary button — Full primary CTA under product info.
    • Secondary button — Quieter button under product info.
    • Image text overlay — Label text on the product image.
    • Image icon overlay — Cart icon on the image (selected in the screenshot).
  • Show Quick add on hover only — Only for Image text / Image icon overlay. Desktop hover; on touch the button stays visible (off in the screenshot).
  • Show description in Quick add — Short description inside the Quick add flow (off in the screenshot).
  • Show view details link — Link to the full product page from Quick add (on in the screenshot). Test on a grid, then Save.

Badges

Path: Theme settings → Badges

Shows on product cards when the product has a matching tag. Leave a badge name blank to disable that slot. Sale % and sold out use the product card block toggles in each section — not this Theme settings group.

Theme settings Badges group with Badge 1 New and Badge 2 Bestseller, and collection cards showing matching badges
Theme settings → Badges: Badge name, Position, Text color, Background color. Matching tags appear on cards.
  • Badge 1–4 — Four slots (e.g. Badge 1 = New, Badge 2 = Bestseller). Each slot has:
    • Badge name (product tag) — Must match a product tag (case-insensitive). Same text shows on the badge.
    • Position — Top left, Top right, Bottom left, or Bottom right.
    • Text color / Background color — Keep strong contrast on product photos.

Connect Admin tags to Badges

Admin path: Products → [product] → Tags

Theme settings alone is not enough. Add the matching tag on each product in Admin.

Shopify Admin product page Tags panel with bestseller and other product tags
Admin → Products → Tags: add the same tag used in Theme settings (e.g. bestseller).
  • Open the product in Admin → Tags.
  • Add a tag that matches Badge name (e.g. bestseller for “Bestseller”). Case-insensitive.
  • Save the product, then check the collection or home preview for the badge.

Swatches

Path: Theme settings → Swatches

Applies on product pages and cards with swatches. Color uses Admin color/name. Image uses Admin or variant image.

Theme settings Swatches with Image swatch selected and circular image swatches under product prices
Theme settings → Swatches: Image swatch, max 5, sizes 40 / 30 px. Preview shows image chips under prices.
  • Swatch style
    • Color swatch — Solid chip from Admin option color/name.
    • Image swatch — Mini photo from Admin swatch image or variant image (selected in the screenshot).
  • Maximum swatches — Chips before overflow (screenshot: 5). Extra options can show as “+N”.
  • Swatch size — Desktop (screenshot: 40 px).
  • Mobile swatch size — Phone (screenshot: 30 px). Keep large enough to tap.
  • Size style — Square or Capsule for card swatch corners (same options as product page Size style). Capsule + high Border radius makes round chips.
  • Border radius — Only when Size style is Capsule. 0 ≈ square; 100 = full pill/circle (default 100 %). Try both styles, then Save.

Cart

Path: Theme settings → Cart

Slideshow

Choose how the cart opens after add to cart. Drawer and popup are always included by the theme — merchants do not add a cart section. In the screenshot, Cart type is Drawer.

Theme settings Cart: Cart type Drawer open, Drawer options, Free shipping bar, and Your bag drawer preview
Theme settings → Cart: Cart type = Drawer, Drawer options, Free shipping bar, and the Your bag preview.
  • Cart type — Same three options as in the screenshot dropdown:
    • Drawer — Slides in from the side (selected in the screenshot).
    • Popup notification — Brief add confirmation, then it hides. Replaces Drawer options with Popup options.
    • Page — Goes to the full cart page.
  • Drawer options — Only when Cart type is Drawer (as in the screenshot):
    • Heading — Drawer title. Screenshot shows Your bag.
    • Enable order note — Order note field in the drawer (off in the screenshot).
    • Show secure checkout note — Secure checkout line near checkout (off in the screenshot).
    • Show accelerated checkout buttons — Shop Pay, Apple Pay, Google Pay, and other accelerated buttons Shopify provides for the cart (off in the screenshot). Do not restyle those branded buttons.
    • Show payment icons — Payment icons under checkout (on in the screenshot).
  • Free shipping bar — Only when Cart type is Drawer:
    • Show free shipping progress — Progress bar at the top of the drawer (on in the screenshot — “Almost free shipping”).
    • Free shipping threshold — Amount in store currency. Screenshot shows 800 (means 800.00).
    • Progress message / Success message — Scroll the Cart panel below the threshold to edit these (e.g. “Almost free shipping” / “Free shipping unlocked”), then Save.
  • Popup options — Only when Cart type is Popup notification: Heading and Auto-hide after (2–6 seconds). Not shown while Drawer is selected.

Social media

Path: Theme settings → Social media

Icons appear in the footer only when a URL is entered. Set URLs under Accounts.

Theme settings Social media Accounts with Instagram Facebook Pinterest TikTok YouTube filled, and footer social icons in the preview
Theme settings → Social media: Accounts URLs. Filled profiles show as icons in the footer (Instagram, Facebook, Pinterest, TikTok, YouTube in the screenshot).
  • Accounts — Paste a full profile URL for each network you use. Empty fields stay hidden in the footer.
  • Instagram, Facebook, Pinterest, TikTok, YouTube — Filled in the screenshot; those five icons appear in the footer preview.
  • X (Twitter), Vimeo, Tumblr, Snapchat — Empty in the screenshot, so no icons show for them.
  • Use https:// links so icons open correctly. Scroll the footer in preview to check, then Save.

Botanical Art

Path: Theme settings → Botanical Art

Line-art motifs on promo panels (for example a Products Highlight intro). Pick a design and tune how it fills the panel. This is not a full-page wallpaper — it sits behind copy on colored promo panels when a section allows it.

Theme settings Botanical Art with Design style Vine and leaf, and New Arrivals promo showing vine motifs
Theme settings Botanical Art with Design style Wild branches, and New Arrivals promo showing branch motifs
Theme settings Botanical Art with Design style Bloom scatter, and New Arrivals promo showing bloom motifs
Theme settings Botanical Art with Design style Fern fronds, and New Arrivals promo showing fern motifs
Theme settings Botanical Art with Design style Deco bloom, and New Arrivals promo showing deco motifs
  • Enable botanical art — Master switch for the whole theme. Off removes the motif everywhere. On in the screenshots.
  • Design style — Motif shape (each has a different rhythm). Use the slider above to compare all five:
    • Vine & leaf — Climbing vines and leaves.
    • Wild branches — Branching line strokes.
    • Bloom scatter — Scattered flower motifs.
    • Fern fronds — Fern leaf pattern.
    • Deco bloom — Geometric deco blooms, circles, and triangles.
  • Appearance — How the chosen design sits on the panel:
    • Coverage layout — Where the pattern sits: Full background, Left & right edges, Four corners, or Bottom wash. Screenshot uses Full background.
    • Art color — Line color of the motif (screenshot: #F7F4EF). Use a light tint on dark panels, or a deeper tint on light panels.
    • Opacity — Strength of the lines (8–45%). Screenshot: 18%. Keep modest so headlines and buttons stay readable.
    • Pattern scale — Larger = fewer, bigger motifs. Smaller = denser tiling (70–160%). Screenshot: 90%.
    • Mirror overlay layer — Adds a flipped second layer for richer depth (on in the screenshot).
  • Where it shows — Promo / intro panels that opt in (Products Highlight, Related products, Testimonials, Collapsible rows, Editorial / Media with text when decoration is on, Password card, and similar). Many of those sections also have their own Enable botanical art toggle — Theme settings chooses the look; the section toggle can turn that panel off.
  • Try each Design style on a dark promo panel, adjust Opacity and Art color for contrast, then Save.

Decorative art

Path: Theme settings → Decorative art

Global decorative letter used on sections that support it (e.g. Media with text). Position is set per section. Separate from Botanical Art line motifs.

Theme settings Decorative art with Show decorative art on and Decorative letter R, preview showing large faint R behind Media with text copy
Theme settings → Decorative art: Show decorative art on, letter R. Preview shows the large faint R behind the text column.
  • Show decorative art — Master switch for the decorative letter across the theme. On in the screenshot. Individual sections can still turn it off.
  • Decorative letter — The character shown as a large watermark-style mark (screenshot: R). Use one letter for a brand monogram look.
  • Where it shows — Sections that support it (e.g. Media with text). Those sections can enable/disable the letter and set Letter position — vertical / Letter position — horizontal (0–100).
  • Turn the master switch on, set your letter, open a supporting section in the editor to place it, then Save.

Back to top

Path: Theme settings → Back to top

Shows a floating control on long pages so shoppers can return to the top quickly. In the screenshot it sits in the bottom-right of the preview.

Theme settings Back to top with Soft glass style, Circle shape, and floating back to top button in the preview
Theme settings → Back to top: Soft glass + Circle. Preview shows the floating button in the bottom-right.
  • Enable back to top — Turns the floating control on or off. On in the screenshot.
  • Arrow style — Look of the control:
    • Soft glass — Soft translucent look (screenshot).
    • Solid cream — Solid filled control.
    • Outline — Bordered, lighter look.
  • Arrow shape — Outer shape:
    • Circle — Round button (screenshot).
    • Square — Squared corners.
    • None — Icon only, no shape behind it.
  • Icon color — Arrow color (screenshot: #1C1917).
  • Background — Button fill behind the icon (screenshot: #F7F4EF). Keep strong contrast with Icon color.
  • Scroll down in preview until the button appears, try style/shape/colors, then Save.