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.
- 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.
Logo
Path: Theme settings → Logo
Controls the brand mark in the header, inverse logo on dark surfaces, logo height on desktop and mobile, and the favicon in browser tabs.
- Logo — Main brand mark (PNG or SVG) for light backgrounds. Check the header in preview after upload.
- Inverse logo — Light logo for dark backgrounds. Used when a section selects Inverse logo. Keep the same proportions as Logo.
- Logo height — Desktop height (16–120 px). Screenshot:
28 px. - Mobile logo height — Small-screen height (16–80 px). Screenshot:
28 px. Preview with the phone icon. - Favicon — Shown in browser tabs. Use a square PNG, then Save.
Color palette
Path: Theme settings → Color palette
Storewide background, text, surface, accent, and button colors. Groups match the editor headers.
-
Background
- Background — Page canvas (screenshot:
#F7F4EF). - Text — Primary copy on the background (screenshot:
#1C1917). Keep strong contrast.
- Background — Page canvas (screenshot:
-
Surface
- Surface — Panels and soft structure (screenshot:
#EDE8E0). - Surface text — Text on surface areas (screenshot:
#1C1917).
- Surface — Panels and soft structure (screenshot:
-
Accent
- Accent — Brand highlight for bars, links, and emphasis (screenshot:
#6B2D3C). - Accent text — Text/icons on accent (screenshot:
#F7F4EF).
- Accent — Brand highlight for bars, links, and emphasis (screenshot:
-
Buttons
- Button — Primary CTA fill (screenshot:
#6B2D3C). - Button label — Text on primary buttons (screenshot:
#F7F4EF). Keep high contrast, then Save.
- Button — Primary CTA fill (screenshot:
Typography
Path: Theme settings → Typography
Fonts plus Desktop / Mobile sizes for each Text style. Editorial contrast: refined headings with readable body copy.
-
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.
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.
- 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 pxfor 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.
- 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.
- 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.
- Open the product in Admin → Tags.
- Add a tag that matches Badge name (e.g.
bestsellerfor “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.
-
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
SlideshowChoose 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.
-
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).
- Heading — Drawer title. Screenshot shows
-
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.
Search
Path: Theme settings → Search
Controls the header search overlay content and style. Turn search on/off in the Header section.
- Eyebrow label — Small label above the heading (screenshot:
Search). - Editorial heading — Large overlay title (screenshot:
Find something you love.). - Search placeholder — Hint text in the search field (screenshot:
Search for dresses, tops, and more...). - Search button label — Button text next to the field (screenshot:
Search). - Popular searches — One suggestion per line. Shown in the Popular searches tab (screenshot: Dresses, Tops, Coats, Silk, Skirts, Journal).
- Suggested products collection — Products in the Suggestions tab before typing (screenshot: Dresses & Gowns). Falls back to all products if empty.
- Enable predictive search — Live product results while typing (on in the screenshot).
- Number of results — How many predictive products to show (4–8). Screenshot shows
4, matching the four cards in the preview. - Search button color — Button fill (screenshot:
#5C1D26). - Search button text / Search field background — Scroll the Search panel if needed to set button label color and field background, 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.
- 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.
- 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.
- 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.
Social media
Path: Theme settings → Social media
Icons appear in the footer only when a URL is entered. Set URLs under Accounts.
https://links so icons open correctly. Scroll the footer in preview to check, then Save.