River — editorial fashion theme docs →

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.

Theme editor Hero section with Add section Hero in Banners, content blocks Text Rich text and Button, and settings for width media height layout media and appearance
Home page → Hero: Add section → Banners → Hero. Preview shows campaign media with headline blocks; right panel shows Size, Layout, and 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

Theme editor Add section picker showing Slideshow under Banners with a Slide block selected
Add section → Banners → Slideshow. Select a Slide for image, position, and overlay.
  • 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

Theme editor Slideshow settings for size arrows dots and autoplay
Slideshow settings: size, arrows, dots, and autoplay.
  • 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.

Theme editor Marquee section with Marquee items New season edit Soft tailoring Complimentary shipping Made to last and settings for width font size direction scroll speed gap separator and colors
Home → Marquee: scrolling orange strip. Left list shows Marquee items; right panel shows Size, Layout, Appearance, Padding.
  • 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.
  • 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.

Theme editor Collection list with intro text collection cards circle images and settings for collections list type columns and image ratio
Collection list: intro heading plus collection cards. Screenshot uses circle images and Grid list type.
  • 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.

Theme editor Product Cards section settings with collection columns mobile carousel and botanical art
Theme editor Product card block settings for gap corner radius badges and borders
  • 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.

Theme editor Product Grid with intro container product cards and settings for collection columns mobile carousel and view all
Product Grid: intro heading above a multi-column product grid.
  • 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.

Theme editor Product Slider under Products with collection columns and show arrows settings
Add section → Products → Product Slider. Preview shows a horizontal product carousel.
  • 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.

Theme editor Image banner with Text Rich text Button blocks and settings for width media height content position image overlay
Image banner: content blocks over campaign media. Content position set to Middle center.
  • 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.

Logo list

Path: Customize → Add section → Logo list

Press, partner, or brand logos in a scrolling horizontal strip.

Theme editor Logo list with Logo blocks and settings for width direction scroll speed gap and pause on hover
Logo list: add Logo blocks, then set scroll direction, speed, and gap.
  • 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.

Theme editor Shop from videos with Video card blocks heading background and slides per view settings
Shop from videos: Add Video card blocks, set heading style, then choose how many slides show per breakpoint.
  • 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: #F7F4EF on #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.

Theme editor Media with text with Image and Container blocks plus layout direction gap and decorative art settings
Media with text: Image + Container (text, button, icon slider). Layout uses Horizontal direction and Gap.
  • 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.

Theme editor Editorial with Container intro Editorial card blocks and settings for columns gap and decorative art
Editorial: intro Container + Editorial cards. Columns on desktop include the intro column.
  • 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

  1. Go to Shopify Admin → Online Store → Blog posts.
  2. Click Create blog post (or open an existing post to edit).
  3. Add a title, featured image, and body content.
  4. Choose the Blog (for example News). Create a new blog under Manage blogs if you need one.
  5. Set visibility to Visible and Save.

2. Connect the section in the theme editor

Theme editor Blog posts section with heading From the journal Blog News and posts to show settings
Blog posts: pick the Admin blog (screenshot: News), then set how many posts and which details to show.
  • Heading / Text style / Alignment — Screenshot: From the journal, Title, Center.
  • Text color / Background — Screenshot: #F7F4EF on #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.

Theme editor Testimonials with Container intro Testimonial blocks and settings for columns mobile carousel arrows and dots
Testimonials: intro Container + Testimonial blocks. Use mobile carousel, arrows, and dots for browsing.
  • 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.

Theme editor Lookbook with hero banner and filter collections settings
Theme editor Look image block settings for size collection caption and link
  • 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).

Theme editor FAQ section with Container intro Collapsible row Accordion rows and decorative art settings
FAQ: intro Container plus Collapsible rows → Accordion row blocks for each question.
  • 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.)

Theme editor Newsletter section with Text Rich text Email form blocks and background image overlay settings
Newsletter: copy blocks + Email form over a background image panel.
  • 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, top 48 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.

Theme editor Video section with heading subheading Shopify video YouTube or Vimeo URL cover image autoplay and loop
Video: set heading copy, then Media — Shopify video or YouTube/Vimeo URL, and 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.

Theme editor Countdown timer with Container copy Countdown clock end date and appearance settings
Countdown timer: intro Container + Countdown clock. Set End date, then accent and border colors.
  • 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.

Theme editor Recently viewed with Container intro product columns botanical art and arrow settings
Recently viewed: intro Container plus a product carousel of browsed items.
  • 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.

  1. Open the template (home, page, product, etc.) in the theme editor.
  2. Click Add section → Custom Liquid.
  3. In the right panel, open the Liquid code field and paste your Liquid/HTML or app embed code.
  4. Set Width (Page or Full), optional Background, and Padding.
  5. 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.

  1. Open the template in the theme editor.
  2. Click Add section → Custom section.
  3. Click Add block and insert the blocks you need (Text, Rich text, Button, Image, Container, and other theme blocks).
  4. 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.
  5. Reorder blocks in the left panel. Nest blocks inside a Container when you need grouped columns or stacks.
  6. Set section Width, Gap, optional background color/image, and Padding.
  7. 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.

Theme editor Contact form with Help detail blocks eyebrow heading and subject field settings
Contact form: form on the left, help card + image on the right. Add Help detail blocks for care points.
  • 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.