Sections
Page building blocks you add in the theme editor — heroes, product storytelling, lookbooks, trust content, and more. Use the sidebar to jump to any section.
Path: Online Store → Themes → Customize
Open a template, click Add section, pick a River section, then edit settings and blocks on the right. Click any screenshot in these docs to view it full size.
Hero
Path: Customize → Add section → Banners → Hero
Full-bleed opening for campaigns and seasonal drops. Lead with one message and one CTA over image or video media.
- Add section → Hero — Under Banners in the Add section picker (screenshot). You can also select an existing Hero in the left template list.
- Content blocks — Add, reorder, or remove theme blocks inside Hero (screenshot shows Text, Text, Rich text, Button). Typical stack: eyebrow → headline → supporting copy → CTA.
-
Size
- Width — Page or Full (screenshot: Page).
- Media height — Auto, Small, Medium, Large, Full screen, or Custom. Screenshot: Large. Custom unlocks a height slider in
vh.
-
Layout
- Content position — Nine placements (top / middle / bottom × left / center / right). Screenshot: Middle left.
- Gap — Space between stacked content blocks (screenshot:
18 px).
-
Media
- Media type — Image or Video (screenshot: Image).
- Image — Desktop / large-screen hero image (screenshot:
campaign-hero.jpg). Prefer a strong focal subject; this is often the LCP image. - Mobile image — Optional crop or alternate frame for small screens (screenshot:
campaign-hero-mobile.jpg). - When Media type is Video, use the Video settings group (Shopify video or YouTube/Vimeo URL, autoplay, loop, mute, controls, show on mobile).
-
Appearance
- Enable overlay — Soft color wash over media so text stays readable.
- Overlay opacity / Overlay color — Strength and tint of the wash.
- Background — Fallback color behind media.
-
Padding
- Top padding / Bottom padding — Vertical space inside the section.
- Keep one clear headline and one primary button. Preview desktop and mobile, then Save.
Slideshow
Path: Customize → Add section → Banners → Slideshow
Rotating slides for campaigns and look launches. Add Slide blocks; each slide has its own media and copy.
1. Add slides
- Add block → Slide — One frame per Slide (screenshot: three slides).
- Content — Nest Text, Rich text, and Button inside a Slide.
- Media type — Image or Video. Set Image and optional Mobile image.
- Content position — Where copy sits on the slide (screenshot: Middle left).
- Enable overlay — Soft wash for readable text (screenshot:
4%,#1C1917).
2. Section settings
- Width / Media height — Screenshot: Page, Large.
- Gap — Space between content blocks (screenshot:
16 px). - Show arrows — Style Soft glass, shape Circle (screenshot).
- Show dots — Pagination under the slides.
- Auto-rotate slides — Interval (screenshot:
5 s). Optional pause on hover. - Padding — Top and bottom space around the section.
Marquee
Path: Customize → Add section → Marquee
Scrolling strip for short promo lines — drops, shipping notes, brand values. Add Marquee items in the left panel; section settings control speed and look.
- Add Marquee item — Each item has text (and optional image / link). Screenshot items: New season edit, Soft tailoring, Complimentary shipping, Made to last.
-
Size
- Width — Page or Full (screenshot: Page).
- Font size — Screenshot:
16 px.
-
Layout
- Direction — Left or Right (screenshot: Left).
- Scroll speed — Full loop duration (screenshot:
30 s). - Gap — Space between items (screenshot:
40 px). - Pause auto-rotate on hover — On in the screenshot.
- Show separator — Decorative mark between items (on in the screenshot).
-
Appearance
- Fill color — Screenshot:
#C86A2C. - Text color — Screenshot:
#F7F4EF.
- Fill color — Screenshot:
-
Padding — Top / Bottom (screenshot:
16 px/16 px).
Collection list
Path: Customize → Add section → Collections → Collection list
Navigate shoppers into key collections with editorial imagery — grid or slider of collection cards.
- Collections — Pick which collections appear (screenshot: Dresses & Gowns, Tops, Outerwear…).
- List type — Grid or Slider (screenshot: Grid).
- Columns — Desktop / tablet / mobile (screenshot: 5 / 3 / 1).
- Gap — Space between cards (screenshot:
24 px). - Image ratio — Circle, Square, Portrait, or Landscape (screenshot: Circle).
- Width / Background / Arrows & dots — Section size and slider controls when needed.
Products spotlight
There are 3 types under Products spotlight. Screenshots for each type are in the sections below — this overview has no image.
- Product Cards — Multi-column card layout.
- Product Grid — Denser product grid.
- Product Slider — Horizontal carousel with arrows and dots.
Product Cards
Path: Customize → Add section → Products → Product Cards
Collection products in a multi-column card layout — good for featured edits and home merchandising.
- Collection / Products to show — Screenshot: Dresses & Gowns,
6. - Columns — Desktop, laptop, and mobile (screenshot: 3 / 2 / 1).
- Grid spacing / Mobile carousel — Screenshot:
18 px, carousel on. - Enable botanical art — Optional art on the intro panel.
- Product card — Gap, corner radius, badges, and border on each card (screenshot:
10 px,8 px).
Product Grid
Path: Customize → Add section → Products → Product Grid
Collection products in a denser grid for browsing more items at once.
- Collection / Products to show — Screenshot: Dresses & Gowns,
8. - Columns — Desktop, laptop, mobile (screenshot: 4 / 3 / 2).
- Grid spacing / Mobile carousel — Screenshot:
18 px, carousel on. - Show view all button — Optional link label (screenshot: Shop Dresses & Gowns).
- Enable botanical art — Optional art behind products (on in the screenshot).
Product Slider
Path: Customize → Add section → Products → Product Slider
Collection products in a horizontal carousel with arrows and dots.
- Collection / Products to show — Screenshot: New Arrivals,
11. - Columns — How many cards visible at once (screenshot: 4 / 3 / 2).
- Grid spacing / Alignment — Screenshot:
18 px, Center. - Show arrows — Previous / next controls for the carousel (on in the screenshot).
- Enable botanical art — Optional (off in the screenshot).
Image banner
Path: Customize → Add section → Banners → Image banner
A focused image band with text — useful between product grids or as a mid-page campaign break.
- Content — Nest Text, Rich text, and Button (screenshot: Special offer → headline → copy → Shop the edit).
- Width / Media height — Screenshot: Full,
55 vh. - Content position — Where copy sits on the image (screenshot: Middle center).
- Image / Mobile image — Desktop and optional mobile crops.
- Text color — Color for banner copy (screenshot:
#F7F4EF). - Enable overlay — Soft wash for readable text (screenshot:
#1C1917,30%). - Background / Padding — Fallback color and top/bottom space.
Featured product
Path: Customize → Add section → Products → Featured product
Highlight a single product with media and buy actions without leaving the page.
- Product — Choose the product to feature.
- Heading / View full details — Optional section title and product-page link.
- Media position / Thumbnail position — Gallery left or right; thumbs left or bottom.
- Image ratio / Corner radius / Show arrows — Media framing and gallery controls.
- Width / Background / Padding — Section size and spacing.
- Add theme blocks for title, price, variant picker, buy buttons, and more — plus app blocks when needed.
Logo list
Path: Customize → Add section → Logo list
Press, partner, or brand logos in a scrolling horizontal strip.
- Add block → Logo — Upload each logo image; optional link and image width per block.
- Width — Page or Full (screenshot: Page).
- Direction / Scroll speed — Screenshot: Left,
30 s. - Gap — Space between logos (screenshot:
48 px). - Pause auto-rotate on hover — Pauses the scroll on hover (on in the screenshot).
- Show separator / Fill color / Padding — Dividers, background, and spacing.
Shop from videos
Path: Customize → Add section → Shop from videos
Pair product cards with motion so shoppers can shop what they see. On each Video card you can add a video — Shopify-hosted video or a YouTube/Vimeo URL — plus an optional cover image.
- Add block → Video card — Pick a product, then add a Video (Shopify Files) or Video URL (YouTube/Vimeo), plus optional cover image.
- Heading / Text style / Alignment — Screenshot: Shop The Look, Title, Center.
- Text color / Background color — Screenshot:
#F7F4EFon#682D3C. - Width — Page or Full (screenshot: Page).
- Slides per view — Desktop / laptop / tablet / mobile (screenshot: 5 / 4 / 3 / 2).
Media with text
Path: Customize → Add section → Media with text
Classic split layout — image or video beside story copy, button, and optional icon slider.
- Blocks — Add Image (or media) and a Container for Text, Rich text, Button, Icon with text slider, and more.
- Width / Height — Screenshot: Page, Auto.
- Direction — Horizontal or Vertical (screenshot: Horizontal).
- Stack on mobile / Alignment / Position / Gap — Screenshot: stack on, Left, Center,
32 px. - Show decorative art — Optional letter backdrop; set vertical/horizontal position (screenshot: on,
20%/78%). - Panel background — Text-side fill (screenshot:
#F7F4EF).
Editorial
Path: Customize → Add section → Editorial
Magazine-style intro plus editorial cards for brand stories and fabric notes.
- Blocks — Container for intro copy/button, plus Editorial card blocks (image, title, text, link).
- Width / Height — Screenshot: Page, Auto.
- Direction / Stack on mobile — Screenshot: Horizontal, stack on.
- Columns on desktop — Intro + cards (screenshot:
3= intro + 2 cards). - Gap — Space between columns (screenshot:
10 px). - Show decorative art — Optional letter; set vertical/horizontal position (screenshot:
20%/15%). - Fill color / Soft wash — Background and optional wash overlay.
Blog posts
Path: Customize → Add section → Blog posts
Surface recent articles for editorial and lifestyle content. Create posts in Admin first, then connect the blog in this section.
1. Create posts in Admin
- Go to Shopify Admin → Online Store → Blog posts.
- Click Create blog post (or open an existing post to edit).
- Add a title, featured image, and body content.
- Choose the Blog (for example News). Create a new blog under Manage blogs if you need one.
- Set visibility to Visible and Save.
2. Connect the section in the theme editor
- Heading / Text style / Alignment — Screenshot: From the journal, Title, Center.
- Text color / Background — Screenshot:
#F7F4EFon#682D3C. - Blog — Select the same blog you used in Admin (screenshot: News).
- Posts to show — How many cards appear (screenshot:
3). - Show date / Show author / Show excerpt / Show read more link — Toggle post details (screenshot: date and excerpt on; author off).
- Excerpt length — Character limit when excerpt is on (screenshot:
120).
Testimonials
Path: Customize → Add section → Testimonials
Customer quotes and social proof — intro panel plus testimonial cards.
- Blocks — Container for intro copy/button; add Testimonial blocks for quote, author, role, and rating.
- Width — Page or Full (screenshot: Page).
- Columns on mobile / Grid spacing — Screenshot: 1,
18 px. - Mobile carousel / Alignment — Screenshot: carousel on, Left.
- Enable botanical art — Optional art on the intro panel (on in the screenshot).
- Show arrows / Show dots — Soft glass circle arrows in the screenshot.
- Padding — Top and bottom space around the section.
Lookbook
Path: Customize → Lookbook page (or Add section → Lookbook gallery)
Filterable look gallery with hero, collection filters, Look image blocks, and editorial quotes.
- Show hero banner — Image, eyebrow, heading, and subheading (screenshot: on).
- Show filters / Filter collections — Pills that filter looks by collection.
- Add block → Look image — Image, size (Tall/Medium/Short/Wide), collection, caption, link.
- Add block → Editorial quote — Text tiles mixed into the gallery.
- Gap — Space between gallery items (screenshot:
16 px).
FAQ
Path: Customize → FAQ page → FAQ (or Add section → FAQ)
Accordion answers for shipping, sizing, and care — keep questions merchant-real, not filler. FAQ uses a Collapsible rows block for the Q&A list (you can also add Collapsible rows as its own section on other pages for policies or long-form details).
- Container — Intro eyebrow, title, and description.
- Collapsible rows → Accordion row — Add one Accordion row per question and answer. Reorder rows in the left panel.
- Width — Page or Full (screenshot: Page).
- Show decorative art — Optional letter accents (on in the screenshot).
- Accent / Answer background — Screenshot:
#5C1D26,#F2E6DD. - Padding — Top and bottom space (screenshot:
40 px/72 px).
Newsletter
Path: Customize → Footer group → Newsletter (or Add section → Newsletter)
Inline email signup for list building — often above the footer. (Popup signup is separate: Storefront → Newsletter popup.)
- Blocks — Text, Rich text, and Email form for the signup panel.
- Width / Height — Screenshot: Page, Medium.
- Image — Background photo behind the panel (screenshot:
lookbook-newsletter.jpg). - Overlay color / Overlay opacity — Soft wash on the image (screenshot:
#1C1917,18%). - Fill color / Panel background — Section and card fills (screenshot:
#F7F4EF/#FFFCF8). - Corner radius / Padding — Screenshot:
0 px, top48 px.
Video
Path: Customize → Add section → Video
Standalone video for campaigns and brand films. Add a Shopify-hosted video or a YouTube/Vimeo URL, plus an optional cover image.
- Heading / Subheading — Screenshot: In motion / A closer look at fabric and form.
- Shopify-hosted video — Upload or select a video from Files.
- YouTube or Vimeo URL — External link if you are not using a Shopify video.
- Cover image — Poster shown before play.
- Autoplay / Loop video — Screenshot: autoplay off, loop on.
- Background / Padding — Section fill and spacing (screenshot: Default,
48 px).
Countdown timer
Path: Customize → Add section → Countdown timer
Timed promotions for launches. Use a real end date only — fake or endlessly resetting countdowns are not allowed.
- Blocks — Container for eyebrow/heading/text; Countdown clock for the days–hours–minutes–seconds display.
- End date — Real date/time the offer ends (screenshot:
2026-11-20 23:59). - Ended message — Shown when the timer reaches zero (screenshot: This offer has ended.).
- Background / Accent — Screenshot:
#F7F4EF,#682D3C. - Show border / Border color — Screenshot: on,
#D3D2C8. - Padding — Inner frame and top/bottom section space (screenshot:
36 px/48 px).
Recently viewed
Path: Customize → Add section → Recently viewed
Help returning shoppers pick up where they left off. Products appear after a shopper views product pages in their browser — the section stays empty until then.
- Container — Eyebrow, heading, and supporting copy above the products.
- Products to show — Max products in the strip (screenshot:
8). - Columns — Desktop / laptop / mobile (screenshot: 4 / 3 / 1).
- Grid spacing — Space between cards (screenshot:
18 px). - Enable botanical art — Optional art on the intro panel (on in the screenshot).
- Show arrows / Show dots — Soft glass circle arrows in the screenshot.
Custom Liquid
Path: Customize → Add section → Custom Liquid
Paste Liquid, HTML, or an app snippet when you need something the other sections do not cover. This section is code-based — it does not use theme blocks.
- Open the template (home, page, product, etc.) in the theme editor.
- Click Add section → Custom Liquid.
- In the right panel, open the Liquid code field and paste your Liquid/HTML or app embed code.
- Set Width (Page or Full), optional Background, and Padding.
- Preview on desktop and mobile, then Save.
- Use only trusted code. Invalid Liquid can break the page preview.
- For layouts built from Text, Button, Image, and other theme blocks (no code), use Custom section instead.
Custom section
Path: Customize → Add section → Custom section
Flexible layout built from theme blocks — good when you want a custom composition without writing Liquid. You can add blocks (and app blocks) inside this section.
- Open the template in the theme editor.
- Click Add section → Custom section.
- Click Add block and insert the blocks you need (Text, Rich text, Button, Image, Container, and other theme blocks).
- You can also add a Custom Liquid block for a small code snippet inside the layout, or an App block when an app provides one.
- Reorder blocks in the left panel. Nest blocks inside a Container when you need grouped columns or stacks.
- Set section Width, Gap, optional background color/image, and Padding.
- Preview, then Save.
- Blocks — Theme blocks + Custom Liquid block + app blocks (@app).
- Prefer Custom section for visual layouts; prefer Custom Liquid only when you must paste code.
Contact form
Path: Customize → Contact page → Contact form (or Add section → Contact form)
Customer contact form with optional help details beside an image. Submissions go to your store contact email in Admin.
- Eyebrow / Heading / Text — Intro copy above the form (screenshot: We'd love to hear from you / Let's talk).
- Show subject field / Subject options — Dropdown choices separated by
|(screenshot: Order support|Size & fit|…). - Add block → Help detail — Icon, heading, and text for the “Here to help” card (screenshot: Customer care, Response time, Styling assistance).
- Also set the side image, help card title, hours line, and colors further down in section settings.
- Preview the form, then Save. Test a message from the live storefront when you can.