Home Sections

Sections

25 articles

Featured collections

Featured collections Featured collections shows a row or grid of collections you pick, each as a card linking to that collection, under a heading. It lives under the Products group in Add section. Add the section 1. In the theme editor, open the page where you want it, usually the home page. 2. Click Add section and open the Products group. 3. Choose Featured collections. Section content The heading area is a content slot named Header in the block list. Expand it to edit the blocks inside: - An Eyebrow: the small label above the heading. - A heading, built from an Accent text block so you can italicize part of it for an accent color. - A Rich text intro line below the heading. Edit, reorder, or remove these the same way you would any block. To learn how content slots work, see Sections, blocks, and groups. Settings - Collections: pick the collections to show, in the order you want them. You can add up to 6. Each one becomes a card linking to that collection. Leaving it empty shows placeholder cards so you can build the layout; fill it in before you publish. - Button label: the text on the call-to-action pill inside each collection card (it also feeds each card's accessible name). The default is View collection. Common settings Featured collections uses the standard Color, Padding, Margin, and Visibility controls. See Common section settings. Tips - A card uses the collection's image. Set one in the Shopify admin under Products > Collections, or the card falls back to the first product's image, then to a placeholder. - The layout rebalances to the number of collections, on a 12 column grid. Two collections show as two half width plates, three as equal thirds in one row, four as a two row mosaic (a wider plate, two narrower ones, then a wider one again), and five or six as a uniform four across grid. So the row stays even at every count, but the shape changes as you add cards. - To feature individual products instead of collections, use the Featured products section.

Last updated on Jun 24, 2026

Hero slideshow

Hero slideshow The Hero slideshow is a full-width banner that rotates through one or more slides at the top of a page. Each slide carries its own background image or video and its own stacked content (heading, subheading, eyebrow, button). You add it from the Banners group under Add section. Add the section 1. In the theme editor, open the page where you want the banner. The home page is the usual spot. 2. Click Add section and open the Banners group. 3. Choose Hero slideshow. It arrives with three example slides you can edit, reorder, add to, or remove. Build a slide Each slide is a Slide block inside the section. The slide holds two things: a background (the Background settings) and the content stacked on top of it. That content is itself made of blocks you add inside the slide, such as a heading, a rich text paragraph, an eyebrow, and a button. 1. In the section, open a Slide block. 2. Set its background under Background (see Slide settings below). 3. Add or edit the content blocks inside the slide, then drag them to set their stacking order. 4. To add another slide, use Add block in the section and pick Slide. To reorder slides, drag them in the block list. A slideshow holds up to 20 slides. Keep one clear message per slide. Long headings fight the image and read poorly on phones. Section settings These controls sit in the section panel and apply to the whole slideshow. Section below scrolls over Controls what happens as the page scrolls past the slideshow. The control appears only while Overlay this section with the header is on, and only works when the slideshow is at the top of the page. It is on for a new slideshow. - Section below scrolls over: the slideshow stays in place while the next section slides up over it with rounded corners. Turn it off and the slideshow scrolls away like any other section. - Shadow under the next section: on by default. Casts a shadow along the top edge of the section that slides over the hero, so the overlap reads as depth rather than a flat seam. Turn it off for a cleaner join. It appears only while Section below scrolls over is on. Color - Color scheme: sets the colors for the slideshow frame and any content that is not overridden per slide. - Overlay this section with the header: lets the slideshow sit behind a transparent header. This only works when the slideshow is at the top of the page. While it is on, the section's own Margin controls are hidden, because the section runs under the header instead of below it. Size - Desktop height: the slideshow height on desktop, as a percent of the screen height (70 to 100). - Mobile height: the slideshow height on phones, as a percent of the screen height (65 to 100). Navigation - Show thumbnails: shows small slide previews a visitor can click to jump between slides. Thumbnails appear only when the slideshow has more than one slide. - Thumbnail side: places the thumbnail rail on the Right or the Left. Available when Show thumbnails is on. Autoplay - Auto-rotate slides: advances the slides on their own. - Rotate every: how long each slide stays before the next one appears, in seconds (3 to 20). Available when Auto-rotate slides is on. - Pause on hover: stops the rotation while a visitor hovers over the slideshow. Available when Auto-rotate slides is on. This section also uses the standard Use dark header theme over this section and Margin controls. See Common section settings. Slide settings These controls live on each Slide block, so every slide can differ. Background - Media type: choose Image or Video for the background. - Image: the desktop background image. Shown when Media type is Image. - Mobile image: a separate image for phones. Falls back to the desktop image when not set. Shown when Media type is Image. - Video: the background video, played muted and looping. Shown when Media type is Video. Color - Color scheme: the color scheme for this slide. Set it per slide so the text reads against that slide's background. Overlay A tint laid over the media so light text stays readable. - Overlay: choose None, Solid, or Gradient. - Color: the overlay color, with transparency. Shown when Overlay is Solid. - Overlay strength: how strong the gradient tint is, from 0 to 150 percent. Shown when Overlay is Gradient. Layout - Content alignment: Side aligns the content to the edge opposite the thumbnails. Center places it in the middle. - Gap: vertical space between the stacked content blocks, in pixels. - Mobile gap: the same spacing on phones, in pixels. Animation - Image animation: a slow motion on the background image. Choose None, Drift, or Zoom. Tips - The first slide loads first and is the largest image the browser has to paint, so it sets how fast the page feels. Pick a sharp, well-composed shot for it, and keep the heading short. - For the overlay header look, give the first slide a dark image or a stronger Overlay so the header links stay readable, and leave Use dark header theme over this section on. - On a slide with a video background, the overlay still applies. Raise Overlay strength or switch to a Solid overlay if the text gets lost in busy footage. - Two or three focused slides usually convert better than many. Put your most important slide first, since many visitors never reach the second one: the new season's oil, then the gift boxes, then the story.

Last updated on Sep 09, 2026

Featured articles

Featured articles Featured articles shows recent posts from one blog as a row of cards. Each card links to its post and can show the image, category, title, excerpt, date, and author. Add it from Add section, where it appears under Storytelling. Add the section 1. Open the page in the theme editor and click Add section. 2. Under Storytelling, choose Featured articles. 3. In the section settings, set Blog to the blog you want to pull posts from. The section starts with a header and a card. The cards fill in from the blog you pick, newest first, so you do not add them one by one. The header is a content slot, and the card is the layout each post uses. Section settings - Blog: the blog the section reads posts from. Leave it unset and the section shows placeholder cards in the editor so you can arrange the layout while you set things up. - Articles to show: how many posts appear, from 2 to 6. Set 2 and the cards form a two column row, otherwise a three column row. On phones the cards stack. Header The header sits above the cards. It is a content slot holding an eyebrow (From the blog by default) and a heading (Keep reading. by default). Select those blocks under the section to change their text, or remove them for cards on their own. See Sections, blocks, and groups. Card (Blog post card) One Blog post card block sets the look of every card in the row. Select it under the section to change these controls. - Aspect ratio: the shape of each card image. Landscape (3:2), Square (1:1), Portrait (4:5), or Wide (16:9). - Show category: shows the post's first tag above the title, as a category. - Show excerpt: shows the post excerpt. When a post has no excerpt set, the start of its content is used. - Show author: shows the post author. Off by default. - Show date: shows the published date. The card image, title, and link come from the post itself, so you set those in the blog post, not here. When Show author and Show date are both on, they appear together separated by a dot. This section also uses the standard Color, Padding, Margin, and Visibility controls. See Common section settings. Tips - The category is each post's first tag alphabetically. Article tags cannot be reordered, so to change which one shows, rename or prefix the tag you want to sort first. - One section reads one blog. To feature posts from a second blog, add a second Featured articles section. - For the same cards beside a heading and a link to the whole blog, use Articles with slider instead.

Last updated on Sep 09, 2026

Countdown banner

Countdown banner Countdown banner is a starting layout for the flexible Section. It places a Countdown timer beside a heading and a call to action, all on a rounded image panel. Use it for a launch, a delivery cut-off, or a sale that ends on a set date. For how presets and blocks fit together, see Sections, blocks, and groups. Add it 1. In the theme editor, open the page where you want the countdown. 2. Click Add section. 3. Under Layout, choose Countdown banner. It arrives as a Section holding one Parallax pane. Inside the pane sit two things side by side: - A Group with an Eyebrow, an Accent text heading, a Separator, and a Pop-up button. The button opens a dialog with an Email signup form, so shoppers can be told when the date arrives. - The Countdown timer block. On phones the two stack. Swap, add, or remove any block inside the pane. Set the background The background image, overlay, and rounded corners live on the Parallax pane inside the section, not on the section itself. Select the Parallax pane in the block list to set its Background image, Overlay, and Corner radius. Those are the standard container controls covered in Common section settings. Countdown timer block Select the Countdown timer block to set the target and how it counts. Date and time - Date: the day the timer counts down to. Format is YYYY-MM-DD. - Time: the time of day on that date, in 24-hour HH:MM format. The timer uses your store timezone. - Show days: show a days unit alongside hours, minutes, and seconds. Turn it off for a countdown shorter than a day. - Show separator: show a colon between each unit. Appearance - Alignment: where the timer sits in its space. Left, Center, or Right. - Size: scales the timer from 50% to 150% of its default size. - Show illustration: shows the timer's Illustration child as a backdrop. Open that child block to choose the illustration, size, and color. When the timer expires - Hide when expired: on by default. Read the warning below before you leave it on. - Expired message: shown in place of the timer after it reaches zero. This field appears only when Hide when expired is off. Use it for a line like "Now open" or "Orders resume Monday". The timer disappears, and the editor does not show it This is the one thing to get right about the Countdown banner. With Hide when expired on (the default), the Countdown timer block stops rendering entirely the moment the target date and time pass. Not a zeroed timer, not an empty box: no block at all. Everything else in the section stays, so the panel is still there, still padded, with a gap where the timer was. The theme editor does not reproduce this. In the editor an expired block keeps its place and shows the line "This countdown has expired." so that you can still select it and change the date. That note is editor-only. Your customers see nothing there. So: - Set a reminder for the date you picked, and edit the section on that day. - Or turn Hide when expired off and write an Expired message, so the space says something instead of collapsing. - If you turn Hide when expired off and leave Expired message empty, the timer stays on the page reading all zeros. Usually you want the message. Check the live storefront, not the editor, to confirm what an expired countdown looks like on your page. Section settings The Section that wraps the timer uses the standard Color, Layout, Size, Appearance, Border, Padding, Margin, and Visibility controls. See Common section settings. Tips - Set the Date and Time in your store timezone, not the customer's. A shopper in another timezone sees the same remaining time, counting to the same moment. - Give the countdown a real deadline: the day the new harvest ships, the last order date before a holiday, the hour a limited batch goes live. A countdown that a shopper can tell is fake costs you more trust than it buys you urgency. - One countdown per page is enough. Two on the same page compete and neither reads as important.

Last updated on Sep 09, 2026

Image banner

Image banner Image banner is a heading and short text centered over a background image, the full width of the page. It is a preset of the theme's flexible Section, so once you add it you have the section's full set of controls. It lives under the Banners group in Add section. Add the section 1. In the theme editor, open the page where you want the banner. 2. Click Add section and open the Banners group. 3. Choose Image banner. It starts with an eyebrow, a heading, and a caption over an empty background. Add your image and edit the text. Set the background image The image is the section's background, under Appearance. Select the section, set Background to Image, then pick your Image and, if a wide photo crops badly on phones, a Mobile image. A dark gradient Overlay is already on so the text stays readable. See Common section settings for the background and overlay controls. Edit the content The banner ships with three blocks, stacked and centered. Select each one in the section's blocks to edit it: - An Eyebrow: the small label above the heading. - A heading: the large line, built from an Accent text block so you can italicize part of it for an accent color. - A Rich text caption: the supporting line below the heading. Add a Button block if you want a call to action, or remove any block you do not need. Size and height The banner ships at 70% of the screen height on desktop and 60% on phones, set under Size with Minimum height. Width starts at Full. Set it to Page if you want the content to line up with the rest of the page instead of spanning the screen. Video and parallax variants The Banners group has two siblings that share Image banner's look. They differ in the background, and one of them differs in how it is built: - Video banner: identical to Image banner, except Background is set to Video. The video plays muted and looped behind the text. - Parallax image banner: the background image drifts slowly as the page scrolls. This one puts its content inside a Parallax pane block rather than on the section itself, so the Image, Overlay, and Corner radius are on the pane, not on the section. It starts at 70% of the screen height on desktop and 60% on phones, with a dark gradient already on. Its blocks are an Accent text heading, a Separator rule, and an Eyebrow caption. See Animations and parallax. Pick whichever background suits the section. Common settings Image banner uses the standard Layout, Size, Appearance, Border, Color, Padding, Margin, and Visibility controls. See Common section settings. Tips - Pick an image with room for text. A busy center (a full table of jars and produce, say) makes the heading hard to read even with the overlay, so shoot or crop with an empty corner. - Keep the heading to one line or two. A long heading competes with the image and wraps awkwardly on phones. - For two banners side by side, use the Split banners preset instead. For a banner with the header sitting over it, see the Hero slideshow.

Last updated on Aug 15, 2026

FAQ section

FAQ section The FAQ section pairs a heading area with a list of expandable questions. Each question opens to reveal its answer. Use it on the homepage, a page, a product page, or anywhere shoppers look for common answers without leaving the page. Add the section 1. In the theme editor, open the page where you want the section. 2. Click Add section. 3. Pick the preset that fits: - FAQ, in the Storytelling group, for store-wide questions such as shipping, returns, and care. - Product details, in the Products group, for the facts every product on a template shares: materials, dimensions, care, shipping. Both presets are the same section with different starting content, so everything below applies to either one. You can add up to 24 questions in one section. The heading area The heading area is a content slot named Header at the top of the section. In the FAQ preset it comes preloaded with an illustration, an eyebrow, a heading, a short intro paragraph, and a link button. In the Product details preset it holds an eyebrow, a short statement, and a caption. These are blocks: click any one to change its text, remove the ones you do not want, or add more. Add and edit questions Each question is a Question block in the section's blocks. 1. Select the FAQ section. 2. Click Add block and choose Question. 3. Type the question in the block's settings. 4. Expand the Question in the block list and select the Answer block inside it to write the answer. 5. Drag blocks in the block list to reorder them. Question settings Open a Question block to set: - Icon: the icon shown next to the question. Pick one from the grouped list. Groups include Shipping & delivery, Payments, Trust & guarantees, Service & contact, Products & services, Sustainability, Materials & care, Sizing, Seasonal & promotions, Store & location, and General. - Category: a short topic label above the question, such as Shipping or Returns. Leave it empty to hide it. - Question: the text on the row shoppers click to expand. - Open by default: shows the row already expanded when the page loads. Off by default. The answer The answer is not a setting on the Question. It is built from blocks nested inside the question, so an answer can hold more than plain text. A new Question arrives with one block inside it, named Answer. It is a rich text block, so you can write links, bold, and lists in it. To build a richer answer, select the question and click Add block: you can add an image, a button, a group of columns, or an app block. Everything you nest there appears when the shopper opens the row. A question with nothing nested inside it opens to an empty space. If a row looks blank when you expand it, check that its Answer block is still there. Section settings - Width: how wide the question list runs. Narrow (the default) keeps it to a readable column. Page widens it to the store's page width. This section also uses the standard Color, Padding, Margin, and Visibility controls. See Common section settings. Tips - Leave Open by default off for most rows. A list that starts fully expanded reads as a wall of text, so let the questions do the scanning work. - Use Category only when a one-word topic helps shoppers scan the list. Leave it blank for a cleaner row. The Product details preset leaves it blank on purpose. - Long answers are fine. The answer reveals at full height when a shopper opens the row, so you do not need to keep them short. - On a product page the section belongs to the template, so every product using that template shows the same rows. Keep the content template-wide (care, shipping, guarantees). For text that changes per product, use the product description or Collapsible rows fed from the product itself. - For a collapsible row on a product page rather than a standalone section, use the Collapsible row block in the Details column instead. See Product page layout.

Last updated on Sep 09, 2026

Video with text

Video with text Video with text is a preset of the flexible Section. It places a video on one side and a caption (eyebrow, heading, text, button) on the other, built from a Proportional group. On phones the two sides stack, video first. It lives in Add section under the Storytelling group. Because it is a Section preset, the section itself carries the controls in Common section settings. This article covers the two pieces inside it: the Video block and the caption. Add it 1. In the theme editor, open the page you want to edit. 2. Click Add section and pick Video with text under Storytelling. 3. The section comes with a video on the left and a caption on the right. Edit each in the steps below. Edit the video Select the Video block in the section's blocks. Its settings are grouped under the editor's own headings. Media - Source: where the video comes from. Uploaded uses a file from your Shopify Files. External URL uses a YouTube or Vimeo link. - Video: shown when Source is Uploaded. Pick or upload a video file. - URL: shown when Source is External URL. Paste a YouTube or Vimeo URL. - Video alt text: shown when Source is External URL. Describe the video for screen readers. - Poster image: the still frame shown before the video plays. Leave it empty to fall back to the video's own preview frame. Hidden when Autoplay is on, because an autoplaying video never shows a poster. Playback - Autoplay: starts the video on load. Autoplay always plays muted, so turning it on hides Mute. - Loop: restarts the video when it ends. - Show controls: shows the play, pause, and volume controls. On by default. - Mute: starts the video with no sound. On by default. Shown only when Autoplay is off. Appearance - Aspect ratio: the shape of the video frame. Landscape (16:9), Classic (4:3), Square (1:1), or Portrait (9:16). The Video block also has standard Margin controls (top and bottom). See Common section settings. Edit the caption The caption side is a Proportional part holding four blocks you edit one by one: - Eyebrow: the small label above the heading (the preset reads "Watch"). - Accent text: the heading. Wrap a word in emphasis to give it the accent color. - Rich text: the body copy under the heading. Say what the video shows and why it matters, for example how the oil is pressed the same day the olives come in. - Button: the link below the text. Each of these is a standard content block. Add, reorder, or remove them like any block in the section's blocks, and swap in others (image, icon) if you want a different caption. Adjust the split and spacing The video and caption sit in a Proportional group. The video part starts at a Proportion of 3 and the caption at 2, so the video takes the wider share. Select a Proportional part to change its Proportion or its mobile stacking. See Proportional group for how the proportion values compare. The section itself uses the standard Color, Layout, Size, Appearance, Border, Padding, Margin, and Visibility controls. See Common section settings. Tips - Use a real Poster image for an externally hosted video. The poster is what shows until a visitor clicks play, so it sets the first impression. - For a looping background-style clip, turn on Autoplay and Loop and turn off Show controls. Autoplay forces mute, which is what lets it start without a click. - Set Aspect ratio to Portrait (9:16) for phone-shot vertical video so it is not letterboxed.

Last updated on Aug 15, 2026

Media card slider

Media card slider Media card slider is a horizontal carousel of editorial cards. Each card carries its own image or video, an overlay, and stacked content (eyebrow, heading, text, button). It suits lookbooks, category highlights, or campaign callouts. Add it from Add section under the Media group. It cannot go in the header, footer, or overlay groups. Add the section 1. Open your store theme in the Shopify theme editor. 2. Pick the page where you want the slider (for example, the home page). 3. Click Add section. 4. Choose Media card slider. The section starts with a header content slot and three sample Slide blocks. Click a slide in the section's blocks to edit it, or use Add block to add another Slide. The header content slot holds your title and intro text as ordinary blocks. For how slots and blocks fit together, see Sections, blocks, and groups. Section settings These control the slider as a whole. Per-card content lives on each Slide block (below). Layout - Slides per view: how many cards show side by side on desktop, from 1 to 4. With 1 selected, one large card leads and the next card peeks in from the edge. On narrow screens the carousel becomes a single-card row you swipe through. - Gap: the space between cards in pixels, from 0 to 32. - Aspect ratio: the shape every card uses on desktop. Pick Wide (16:9), Landscape (3:2), Portrait (4:5), or Square (1:1). This applies to all cards, so it is the one place to change card proportions for the whole slider. This section also uses the standard Color, Padding, Margin, and Visibility controls. See Common section settings. Slide settings Each Slide block holds one card. Open a slide to set its media, overlay, and layout. The text inside a slide (eyebrow, heading, paragraph, button) comes from blocks you add within the slide, so you control the wording and order there. Background - Media type: choose Image or Video for the card background. - Image: the desktop background image. Shown when Media type is Image. - Mobile image: an optional image for small screens. It falls back to the desktop image when not set. Shown when Media type is Image. - Video: the background video. It autoplays muted and loops. Shown when Media type is Video. Overlay The overlay is a tint over the media that keeps text readable. - Overlay: choose None, Solid, or Gradient. - Color: the tint color and opacity for a solid overlay. Shown when Overlay is Solid. - Overlay opacity: how strong the gradient tint is, from 0 to 100 percent. Shown when Overlay is Gradient. Layout - Content position: where the text sits on the card. Nine options run from Top left through Middle center to Bottom right. - Text alignment: align the text Left, Center, or Right. - Content width: the maximum width of the text block on the card, from 320 to 960 px. A slide also uses the standard Color, Padding, and Margin controls. See Common section settings. The slide ships with separate desktop and mobile padding turned on, so you will see a Desktop padding and a Mobile padding group from the start. Tips - The first slide loads its video right away. Later video slides defer their download until you swipe to them, so put the slide you most want seen first. - Card shape comes from the section's Aspect ratio, not the slide. Change it on the section to reshape every card at once. - The navigation arrows appear only when the slider holds more than one slide. - A slide with no image or video shows a placeholder graphic, so an empty slide will not break the layout while you build. Media card block The Media card block is a single-card block you add inside container sections. It pairs one image or video with stacked text and an optional link. Its settings mirror the slide with a few additions: - A Media group (Media type, Image, Mobile image, Video). - Aspect ratio with the four shapes above plus Adapt to image and Custom (which reveals a Custom ratio field, for example 16/9). - Overlay style: Gradient or Caption bar, with Overlay strength when set to Gradient. - Link, which makes the whole card clickable. It also uses the standard Color, Padding, and Margin controls. See Common section settings.

Last updated on Jul 30, 2026

Testimonials

Testimonials Testimonials shows customer quotes in a horizontal slider. Each quote is a Testimonial block with an author, an optional role, an avatar, and a star rating. Add it from Add section under Storytelling. Add the section 1. In the theme editor, open the page where you want the testimonials. 2. Click Add section, then choose Testimonials under Storytelling. 3. The section loads with a header and three sample quotes. Edit them, then add or remove Testimonial blocks in the section's blocks. When the section holds more than one Testimonial block, slider dots appear so visitors can move between quotes. A single quote sits on its own with no dots. Section header The text above the slider lives in a content slot, not in section settings. Open it in the section's blocks to edit the eyebrow and heading, or remove them to show the quotes on their own. See Sections, blocks, and groups for how content slots work. Layout - Gap: the space between testimonials in the slider, in pixels. Testimonial blocks Each quote is its own Testimonial block. Add, reorder, or remove them in the section's blocks. Each block has these settings. - Quote: the testimonial text. This is a rich text field, so you can italicize or bold words inside it. - Style: how an emphasized word inside the quote is treated. None leaves it plain, Color tints it with the accent color, and Shimmer gives it a moving sheen. To emphasize a word, italicize it in the Quote field. - Author: the name shown under the quote. - Role: a line under the author, for a job title, company, or location. Leave it empty to hide it. - Avatar: a photo shown beside the byline. Leave it empty to show the name on its own. A square image gives the cleanest round crop. - Show rating: turns the row of stars on or off above the quote. - Rating: the number of filled stars, from 1 to 5. This appears only when Show rating is on. Common settings This section also uses the standard Color, Padding, Margin, and Visibility controls. See Common section settings. Tips - Keep quotes short. One or two sentences read better in the slider than a full paragraph, and similar lengths keep the cards even. - Use the same Style across every testimonial for a consistent row. - Avatars are optional. A set of quotes without photos still reads as a clean row, so leave Avatar empty if you do not have headshots.

Last updated on Jun 24, 2026

Scroll-driven sections

Scroll-driven sections The theme ships two sections built for long-form stories that respond to scrolling. Each one pairs text with media in its own way. - Scrolling content is a full-bleed card: a field of images drifts behind a column of text as the page scrolls, and the section after it can slide over the top. - Vertical tabs stacks tabs on the left and swaps the panel on the right as the reader clicks through. Each section is built from blocks. The text, images, and buttons inside come from the theme's shared content blocks, covered in Content blocks reference. This article documents what is unique to each section. Scrolling content A large rounded card that fills the page width. Behind it, your images tile across a tilted field that drifts as the reader scrolls. On top of it sits a column of editorial text. Most of the tiles are faded back so the text stays readable, and the ones nearest the text are the sharpest. In the editor, Scrolling content appears in the Add section list under the Storytelling group. Add it 1. Open the page you want in the theme editor. 2. Click Add section. 3. Choose Scrolling content. 4. Edit the text and swap the images in the section's blocks. How it is built The section holds a single block called Image rail, and everything else sits inside it: - Content: a content slot with the editorial column. It comes prefilled with an Eyebrow, an Accent text heading, a Rich text paragraph, and a Button. Edit, reorder, or remove these like any content blocks. - Nine Image blocks. These are the pictures the field is built from. Add, remove, or reorder them; there is no count setting. The theme repeats your images across the field, so you do not need a picture per tile. Fewer images means more repetition, and the pattern reads best when neighboring tiles are not the same shot. Image block Each Image block has its own settings under Media. - Image: the picture for that tile. Left empty, the block shows a placeholder. - Mobile image: an alternate picture for small screens. It falls back to the desktop image when not set. The Image block also uses the standard Padding controls. See Common section settings. Image rail settings Select the Image rail block to shape the card. - Corner radius: how rounded the card's corners are, from 0 to 100 pixels. Default is 40. - Height: the card's height as a percentage of its natural size, from 60 to 160. - Content width: how wide the text column runs, from 60 to 160 percent of its normal width. Default is 100. Raise it when the copy is long, lower it to leave more of the image field showing. - Image size: how large each tile is drawn, from 60 to 160 percent. Larger tiles mean fewer are visible at once. - Image position: puts the text column on the Left or the Right of the card. - Faded strips opacity: how visible the dimmed rows of tiles are, from 0 to 60 percent. Default is 26. Raise it for a busier card, lower it if the text is hard to read. - Inherit color scheme: off by default, so the card carries its own Color scheme separate from the section around it. Turn it on to follow the section. Next section The section can hand off to whatever comes after it. - Overlap with section below: on by default. The next section slides up over the card as the reader scrolls, so the two read as one movement. Turn it off to keep them as separate stacked sections. While it is on, the section's bottom padding and margin are ignored, because the next section's edge lands on the card. - Edge shadow: draws a soft shadow along the incoming edge so the next section reads as a separate layer. Available while Overlap with section below is on. This section also uses the standard Color, Padding, Margin, and Visibility controls. See Common section settings. Vertical tabs A row of tabs down the left side with a content panel on the right. The tab list stays in view as the page moves through the panels. On small screens the panels reflow into an accordion. A section header (eyebrow, heading, subtitle) sits above the tab list. In the editor, Vertical tabs appears in the Add section list under the Storytelling group. Add it 1. Open the page in the theme editor. 2. Click Add section. 3. Find Vertical tabs under Storytelling and choose it. 4. It starts with a header, three tabs (Tab one, Tab two, Tab three), and a footer. Edit each, or add more tabs with Add block. The section has two static content slots: a Header above the tab list, prefilled with an eyebrow, a heading, and a subtitle, and a Footer below it holding a closing note. Edit either like any other content, or empty it if you do not want it. Tab block Each Tab block is one entry in the tab list plus the panel it opens. The panel holds its own content: by default an Illustration and a Parallax photo pair block. Add anything else the theme offers to build a richer panel. Tab - Title: the main label in the tab list. - Caption: a short line under the title. - Description: a longer supporting line that shows when the tab is open. Layout The panel is laid out like a group, so a tab carries the full Direction, Gap, and alignment controls, plus Use different layout on mobile to set a separate arrangement for phones. These are the shared layout controls: see Common section settings. The tab also has a Color group with Inherit color scheme (on by default, so the panel uses the section's colors) and a Color scheme that appears when you turn inheritance off, plus the standard Padding controls for space inside the panel. Settings This section uses the standard Color, Padding, Margin, and Visibility controls. See Common section settings. Tips - These sections read their layout from the number and order of their blocks. Reorder or remove Image or Tab blocks to change the story instead of looking for a count setting. - If the header menu washes out over a dark section image, turn on Use dark header theme over this section in the section's Color group.

Last updated on Sep 09, 2026

Storytelling presets

Storytelling presets The Storytelling group in Add section holds prebuilt layouts of the flexible Section. Each one arrives finished, with groups and content blocks already arranged, so your work is editing the words and images, not building the structure. They are presets, so every control on a plain Section applies once you want to adjust the design. This article covers the four that have no page of their own: Brand ethos, Quote, Highlights, and Rich text with button. The rest of the Storytelling group is documented elsewhere: - Collage and Lookbook: see Collage. - Video with text: see Video with text. - Marquee, Text and images, Logos: three starting points for the same scrolling row. It is also a block you can add inside any section, and it is documented once in Sections, blocks, and groups and Content blocks reference. - Testimonials: a slider of customer quotes. See Testimonials. - Articles with slider: blog post cards beside a heading and a link. See Articles with slider. Add one 1. In the theme editor, open Add section. 2. Under the Storytelling group, pick the preset you want. 3. The layout appears with placeholder copy and empty image slots. Open the section's blocks in the editor sidebar to edit them. To replace text, click a block (such as Eyebrow, Accent text, Rich text, Text, or Quote) and type your own. To add a picture, click an Image or Illustration block, or set a background on a group. The illustrations are decorative and you can remove them. Brand ethos A wide statement of what your brand stands for. At the top, a Proportional group puts your headline on the left and a single decorative Illustration on the right. Below it a Separator, then a Horizontal content block with three columns for your principles. What to edit: - The top block: an Eyebrow ("Our principles") and an Accent text headline. - The three columns. Each holds an Eyebrow label ("Feature", "Benefit", "Detail"), a Text title, and a Rich text paragraph. Rename the labels to what you actually promise: "Sourcing", "Milling", "Packing". - The first column also has a Button. Add one to the other two columns if you want each principle to link somewhere. - The side Illustration, or remove it. Quote A customer or press quote given a band of its own. A large pull quote sits beside a signature illustration, with a byline under it. On phones the two stack. Use it to feature a review, a quote, or a line that sums up your shop. What to edit: - The Quote block: your quotation. The decorative quote mark is part of the block. - The byline: an Eyebrow with the attribution ("Anna M., repeat customer") and a Button ("Shop the same") pointing wherever the quote should lead. - The signature Illustration beside the quote, or remove it. Highlights Four promises in a row inside a panel with a dashed border and rounded corners: a common pattern for quality, delivery, packaging, and support. A centered heading introduces the panel, and each of the four cells has an Illustration, an Eyebrow tag, a Text title, and a Text description. On phones the four cells stack. What to edit: - The heading ("What stays with you.") and the intro line above the panel. - Each cell's tag, title, and description. Rewrite them for the four things you most want customers to know, for example "Pressed to order", "Cold chain shipping", "Glass, not plastic", and "Talk to a real person". - Each cell's Illustration, or remove it. Rich text with button The plainest of the four: an Eyebrow, an Accent text heading, a Rich text paragraph, and a Button, stacked and centered at page width. Use it to introduce your shop, open a collection page, or break up a run of image-heavy sections with words. Settings These presets carry no settings of their own beyond the standard Section controls: Color, Layout, Size, Appearance, Border, Padding, Margin, and Visibility. See Common section settings. The arrangement inside each preset comes from group blocks (a Proportional group, Group, or Styled group), which have their own copies of those controls. Adapt the starting layouts - A preset is a starting point. You can add, reorder, or remove any block inside it, and every cell or column is a separate block in the sidebar. - To add or drop a Highlights cell, duplicate or delete one of the four Group blocks inside the panel. The remaining cells re-space to fill the row. - To add or drop a Brand ethos column, duplicate or delete a Column block inside the Horizontal content block. - The illustrations are decorative defaults. Swap them for your own under each Illustration block, or remove them for a cleaner, text-only look.

Last updated on Sep 09, 2026

Collage

Collage Collage arranges a set of media cards into a grid: one large feature card with smaller cards around it, or an even mosaic. Each card holds an image or video with its own heading, text, and link. It is a preset of the flexible Section, so it shares the standard section controls. Add a Collage 1. In the theme editor, open the page you want to edit. 2. Click Add section. 3. Under Storytelling, choose Collage. The section arrives with a Collage block holding three Media card blocks. The cards show placeholders until you add an image to each one. The Collage block Select the Collage block in the section's blocks to set how the cards are arranged. Layout - Layout: how the cards are placed. - Featured left, Featured right, Featured top, Featured bottom: one large card with two smaller cards beside or below it. The name says where the large card sits. These use the first three cards in the block list. - Two columns: an even grid built from four cards. - Three columns: a row of three cards. - Size: Normal or Compact. Compact tightens the cards for a smaller block. - Gap: the space between cards, in pixels. The layout decides how many cards fill the grid. Add or remove Media card blocks to match: three for the featured layouts and Three columns, four for Two columns. Extra cards wrap to a new row. The block also has its own Size group (Width and Minimum height), plus the standard Color, Padding, Margin, and Visibility controls. See Common section settings. It starts on a Custom width, so raise or lower Max width to change how wide the grid runs. Each Media card Each card is a Media card block under the Collage block. Select one to set its image and content. Media - Media type: Image or Video. - Image: the card image. Shown when Media type is Image. - Mobile image: an optional image for phones. Falls back to the desktop image when not set. - Video: the card video. Shown when Media type is Video. - Aspect ratio: the card shape. Adapt to image follows the image's own proportions. The rest are fixed: Square (1:1), Portrait (4:5), Landscape (3:2), Wide (16:9), or Custom. - Custom ratio: your own ratio (for example 16/9 or 1.5). Shown when Aspect ratio is Custom. - Overlay style: how text sits over the media. Gradient fades the lower edge dark so text reads over the image. Caption bar places the text in a band below the image. - Overlay strength: how dark the gradient is behind overlaid text. Shown when Overlay style is Gradient. - Link: a destination for the card. Set it to make the whole card clickable. Card content The heading, text, and any button live as blocks inside the card. Add, reorder, or remove them under the Media card in the block list. See Sections, blocks, and groups. This card also uses the standard Color, Padding, and Margin controls. See Common section settings. Common settings The Collage section also uses the standard Color, Layout, Size, Appearance, Border, Padding, Margin, and Visibility controls. See Common section settings. The Lookbook variant The Storytelling group has a Lookbook preset built on the same Collage block, for a longer editorial run. It arrives as two Collage rows with a heading above each one: 1. An Accent text heading and a Text subtitle, aligned left. 2. A Collage set to Featured left with three Media card blocks. 3. A second heading and subtitle, aligned right. 4. A second Collage set to Featured right, again with three cards. It is a Collage underneath, so every setting on this page applies to each row. Use it for a story told in two parts: the harvest and the kitchen, or the producers and the finished jars. Tips - Over-image text stays readable through each card's Overlay style, not its color scheme. Gradient darkens the lower edge of the image so light text reads on top. - Give the cards in one collage a consistent Aspect ratio so the grid lines up. Mix ratios only when you want an irregular look. - Use Caption bar when the image is busy and a gradient would not give enough contrast for the text. A close-up of a cheese board is the case where a gradient usually fails.

Last updated on Aug 15, 2026

Multicolumn

Multicolumn Multicolumn is a row of text columns: a heading and a short paragraph in each. It is a preset of the flexible Section, built from one Horizontal content block that holds the columns. See Sections, blocks, and groups for how presets and blocks fit together. It appears in the Add section list under Layout. Add it 1. In the theme editor, open the page you want it on. 2. Click Add section. 3. Under Layout, choose Multicolumn. It starts with three columns, each holding a title and a short description as Text blocks. Open each Column in the section's blocks to edit its text. To add or remove a column, add or delete a Column block under the Horizontal content block. Reorder columns by dragging them in the block list. How columns wrap The columns sit in one row that fits as many as the width allows. The Horizontal content block controls when they reflow, on its own settings. - Minimum column width: the narrowest a column gets before the row changes, from 160 to 500 pixels. Below this width the row becomes a swipeable carousel with dots, instead of squeezing the columns. Raise it to force the carousel sooner (wider columns), lower it to keep more columns in a row. It starts at 280. - Gap: the space between columns, in pixels. - Column content alignment: where the text sits inside each column. Left, Center, or Right. - Accessibility label: text read by screen readers when the row collapses to a carousel. Leave it blank to use the default. The block also has a Size group with Limit width and, once that is on, Max width, plus its own Inherit color scheme and Color scheme controls and standard Padding and Margin. See Common section settings. Section settings Multicolumn is the Section, so the band around the columns uses the full set of section controls: the standard Color, Layout, Size, Appearance, Border, Padding, Margin, and Visibility. See Common section settings. Multicolumn mobile grid The Layout group has a second preset, Multicolumn mobile grid. It is the same section tuned for narrow items: - Four columns instead of three. - Minimum column width set to 160 (the lowest the control goes) instead of 280, so the columns stay in a two-up grid on phones instead of collapsing to a swipeable carousel. - A tighter Gap (20 instead of 32), and smaller text sizes in each column. Pick Multicolumn when each column carries a title and a real paragraph. Pick Multicolumn mobile grid for short items that read fine at half a phone's width: origin, weight, roast level, allergens. Everything else on this page applies to both. Tips - The starting columns hold Text blocks, but a column can hold any block. Add an image, a button, or an icon inside a Column to build a richer card. - To keep every column in a row on tablet instead of dropping to a carousel, lower Minimum column width. To give each column more room, raise it. - For uneven column widths (one wide, one narrow), use a Proportional group instead. See Sections, blocks, and groups.

Last updated on Aug 15, 2026

Split banners

Split banners Split banners is a preset of the flexible Section: two image cards side by side, each with a heading over a background image, and each one a link to a collection or page. Add it from Add section under Banners. Because it is the Section underneath, the section itself has no settings unique to this preset. Everything that makes a split banner lives in the two cards inside it, which are Styled group blocks. See Sections, blocks, and groups for how the Section and its blocks fit together. Add it 1. In the theme editor, open the page where you want the banners. 2. Click Add section and choose Split banners under Banners. 3. The section arrives with two cards already set up. Open each card in the section's blocks to add its image, heading, and link. How it is built The section is set to a Horizontal direction so the two cards sit in a row, and it stacks them on phones. Inside it are two Styled group blocks (the cards). Each card holds three blocks: - An Eyebrow (the small accent label above the heading). - An Accent text heading. - A Text block used as the link cue. To change a card, open it in the section's blocks. The settings that make it a banner are on the Styled group card itself, covered next. To edit the wording, open the Eyebrow, Accent text, or Text block inside the card. Each card (Styled group) Each card is a Styled group, so it carries that block's full set of controls. The ones that shape a split banner: - Link: the collection or page the whole card opens. Both cards start pointing at /collections/all, so change them to the collections you want, for example your oils and your preserves. Because the link sits on the card, the entire image is clickable, not only the text. Open in new tab and Link label appear once you set a link. Link label is the accessible name screen readers announce for the card, so write it to describe the destination. - Background: set to Image, with the card's photo in Image. This is the picture behind the heading. - Overlay: set to Gradient, which darkens the lower part of the image so the heading stays readable over it. Adjust the gradient if your photo is lighter or darker than the default. - Corner radius and Shadow: the preset rounds the corners (24 pixels) and adds a Subtle shadow to give each card its raised look. - Minimum height: set to Custom, at 880 pixels on desktop and 460 on phones, so both cards match whatever text you put in them. Change both cards together to keep the row even. To make the two cards different sizes instead of equal, adjust each card's height and the section's alignment, or swap the cards for a Proportional group if you want a width split. Common settings Both the section and the Styled group cards use the standard Color, Layout, Size, Appearance, Border, Padding, Margin, and Visibility controls. See Common section settings. Tips - Keep the two cards' images close in tone and crop. Side by side, a mismatch in brightness or framing shows. Two pantry shelves lit the same way read as a pair; one studio shot next to one kitchen snapshot does not. - Set the same Minimum height on both cards so the row stays even. If one card's content is taller, the fixed height holds them level. - To turn this into three banners, copy one of the cards and drop it into the row. On phones the section stacks the cards. On desktop a third card narrows the row; to let it wrap to a new line instead, turn on Wrap elements when space is limited.

Last updated on Aug 15, 2026

Shoppable image

Shoppable image Shoppable image places one lifestyle photo next to a list of products. Each product gets a dot (a hotspot) on the image, so a shopper can tap a spot in the scene to open that product's card and add it to cart. Add it from Add section under the Products group in the theme editor. Add the section 1. In the theme editor, open the page where you want the section. 2. Click Add section and choose Shoppable image. It loads with a heading area, a button, and three hotspots. 3. In the section, set Image to your lifestyle photo. 4. Click each Hotspot block, assign a Product, and set its position on the image. Image - Image: the main lifestyle photo the hotspots sit on. This is the scene shoppers tap. Until you set it, the section shows a placeholder. - Mobile image: a separate photo for phones. Falls back to the desktop image when not set, so leave it empty unless your main photo is wide and you want a tighter crop for small screens. - Aspect ratio: the shape the photo is shown in. Original keeps the file's own proportions. Landscape (3:2), Classic (4:3), Square (1:1), and Portrait (4:5) crop it to a fixed shape. Header and Footer The text beside the image and the button below it live in two content slots you fill with blocks. See Sections, blocks, and groups. - Header: the intro above the product list. It starts with an eyebrow line, a heading, and a description. Click each block to change its text or remove what you don't need. - Footer: the area below the list. It starts with a button. Click it to set its label and link, for example a link to the full collection. Hotspot blocks Each dot on the image is a Hotspot block. The section holds up to 10. Add or remove them under the section in the block list. - Product: the product this dot links to. Its image, title, and price fill the card and the matching row in the product list. Until you pick a product, the hotspot shows a placeholder. Under Position: - Horizontal: how far across the image the dot sits, from left (0) to right (100). - Vertical: how far down the image the dot sits, from top (0) to bottom (100). The dot is centered on the point you set, so 50 and 50 puts it in the middle of the photo. Values at the extremes work too: a dot at 0 or 100 sits on the edge of the image and stays fully visible. A shopper who taps a dot opens that product's card, and the row in the side list scrolls to match. The price, availability, and the small bag (add to cart) button come from the product you assign. A sold out product shows a sold out label and a disabled bag button. Common settings This section also uses the standard Color, Padding, Margin, and Visibility controls. See Common section settings. Tips - Place each dot on or near the item it sells so the link between the dot and the product reads clearly. On a laid table, put the dot on the jar itself, not on the bread beside it. - The hotspots sit at the same percentage positions on every screen. If your Mobile image crops the scene differently from the desktop Image, check that every dot still lands on its item on mobile. - Order the Hotspot blocks in the block list the way you want the side list to read, since the rows follow that order. - Keep the number of hotspots low enough that the dots do not overlap and crowd the photo. Four or five on a full table shot is usually the limit.

Last updated on Sep 09, 2026

Featured products

Featured products Featured products shows a row of product cards, drawn from a collection or hand-picked one by one. Above the cards it carries a Header content slot for a heading and supporting text. The row becomes a swipeable carousel with dots whenever the cards do not fit in one row: always on phones, and on desktop when there are more products than fit. Add the section 1. In the theme editor, open the page where you want it (the home page is typical). 2. Select Add section. 3. Under Products, choose Featured products. The section ships with a heading and product cards in place, so it shows a preview row before you change anything. Layout - Layout: where the header sits relative to the cards. Content above products stacks the header over a full-width row, which suits a wide row of cards. Content beside products puts the header in a column next to the cards, which suits a shorter row with more to say about it. Choose which products show The section has two pickers at the top. You fill in one of them. - Collection: pick a collection and the section shows its products in the collection's order. Use this when you want the row to track a collection automatically. - Products: hand-pick up to 12 products, in the order you want them, when you need an exact lineup rather than a whole collection. If you set both, the Collection wins and the hand-picked Products list is ignored. The row shows up to 12 products. With both pickers empty, it shows placeholder cards so you can see the layout while you build the page. The Header content slot The Header is a content slot above the product row. It comes prefilled with an eyebrow line and a heading. Edit, reorder, add, or remove the blocks inside it the same as any content slot: select a block in the section's blocks and change its text. Leave the slot empty to show only the products. The product cards Each card is built from blocks (image, title, price, and optional label, rating, and swatches). Select a card's blocks to add, remove, or reorder these parts. Card content such as the label and rating comes from your product data, not from text you type here. The cards inherit the section's color scheme. Settings This section also uses the standard Color, Padding, Margin, and Visibility controls. See Common section settings. Tips - Use Collection for a row that updates itself when the collection changes (a "New arrivals" or "Best sellers" feed). Use Products when the exact items and their order matter. - If you hand-picked products but the row shows different items, check the Collection picker. A collection overrides the Products list, so clear it to use your picks. - The carousel dots appear only with two or more products. A single product shows as one card with no dots.

Last updated on Aug 15, 2026

Image compare

Image compare Image compare shows two images stacked in one frame with a slider the shopper drags to wipe between them. Use it for a before and after: a product worn versus unworn, a room before and after a restyle, an edit versus the original. Add it from Add section under Storytelling. Add the section 1. In the theme editor, open the page where you want the comparison. 2. Click Add section and choose Image compare from the Storytelling group. 3. The section drops in with placeholder images. Set your two images in the settings below. The section starts with a Header content slot above the frame, holding an illustration, an eyebrow, a heading, and a short paragraph. Edit or remove those blocks, or add your own, the same way you edit any block. See Sections, blocks, and groups. Left side The left side is the image the shopper sees first, before they move the slider. - Image: the picture for the left side. When empty, the section shows a placeholder. - Label: a short caption pinned to the left of the frame, for example Before. Leave it empty to hide it. Right side The right side is revealed as the slider moves toward the start. The editor notes this side is visible when the slider is at the start. - Image: the picture for the right side. When empty, the section shows a placeholder. - Label: a short caption pinned to the right of the frame, for example After. Leave it empty to hide it. Slider - Starting position: where the slider sits when the section loads, from 0 to 100 percent. The default is 53, near the middle. A lower value reveals more of the right image at first, a higher value more of the left. - Footnote: a short line of text under the frame, set between two rules. Leave it empty to hide it. - Desktop alignment: places the footnote Left, Center, or Right under the frame. On phones it is always centered, whatever you pick. This section also uses the standard Color, Padding, Margin, and Visibility controls. See Common section settings. Tips - Use two images shot at the same size, angle, and crop. The slider lines them up edge to edge, so any shift in framing shows as the shopper drags. - Set descriptive alt text on each image in the file picker. When an image has no alt text, the section uses its Label as the alt text for accessibility. - Keep labels to one or two words. They sit inside the frame, so long captions crowd the image.

Last updated on Aug 15, 2026

Spacing and Scroll to top

Spacing and Scroll to top Two small sections that solve one job each: Spacing inserts an empty vertical gap between two sections, and Scroll to top adds a floating button that returns the shopper to the top of the page. Spacing Add it from Add section under Layout, then drag it between the two sections you want to separate. It cannot go in the header group or the Overlays group. - Height: the gap's height in pixels, from 10 to 200. It starts at 100. - Color scheme: the gap's background, so it can blend with the section above or below. Reach for it when two specific sections need extra distance on one page. When every section needs more breathing room, adjust the sections' own Margin instead (Common section settings); a page full of Spacing sections is harder to maintain than a few margin values. Scroll to top The button lives in the Overlays group, which sits at the bottom of the section list on every page. The theme already includes it there, hidden. Rather than adding a second one (a store can have only one), expand Overlays, find Scroll to top, and click the eye icon to show it. If it is missing from your store: 1. In the theme editor, expand Overlays at the bottom of the sidebar. 2. Click Add section inside the group and choose Scroll to top. The button appears once the shopper has scrolled down and floats in the chosen corner. - Color scheme: the colors for the button. - Button style: Primary or Secondary, matching your theme's button styles. It starts on Secondary. - Alignment: which corner holds the button, Left or Right. It starts on Right. - Show on home page, Show on pages, Show on product pages, Show on blog posts, Show on other pages: pick the page types that get the button. Out of the box only Show on pages and Show on blog posts are on. The section also uses the standard Visibility control. See Common section settings. Tips - On long pages (a collection with infinite scroll, a long recipe post) the Scroll to top button saves the most work; that is where to turn it on first. - Keep the button on the side opposite any chat widget so the two do not overlap.

Last updated on Aug 15, 2026

Pop-up

Pop-up The Pop-up is a dialog that opens over the page: a newsletter signup, a promotion, an announcement. You fill it with the same content blocks you use anywhere else, choose what makes it open, and set how often it may reopen for the same visitor. A shopper closes it with the close button or the Escape key. Add the section The Pop-up lives in the Overlays group, which sits at the bottom of the section list on every page. The theme does not ship one, so you add it. 1. In the theme editor, expand Overlays at the bottom of the sidebar. 2. Click Add section inside the group and choose Pop-up (under Promotional). 3. Select the section in the sidebar. The dialog opens in the preview so you can style it, and closes again when you select something else. A store can have one Pop-up. It arrives with an Accent text heading and an Email signup block, ready to use as a newsletter signup. Swap or extend those with your own blocks: the Pop-up accepts the standard content blocks (text, image, buttons, and so on). See Content blocks reference. The Email signup block is the same one the footer uses: see Footer. Trigger These settings decide when the pop-up opens and for whom. - Open pop-up: what triggers it. Load opens it when the page loads. Scroll opens it once the shopper scrolls far enough down the page. Delay opens it after a timer. It starts on Scroll. - Delay: the wait in seconds before the pop-up opens, from 0 to 30. Shown when Open pop-up is Delay or Load. - Scroll trigger point: how far down the page the shopper must scroll before the pop-up opens, from 10 to 90 percent. Shown when Open pop-up is Scroll. - Show pop-up: how often the pop-up may open again for the same visitor, from Once every hour to Once per year. It starts on Once every 30 days. Once a visitor has seen it, it stays away until the chosen period passes. - Show only on home page: limits the pop-up to the home page. On by default. Turn it off to let it open on any page. - Hide for logged-in customers: keeps the pop-up away from shoppers with a customer account who are signed in. On by default. Appearance - Size: the dialog width, Small or Medium. - Color scheme: the colors for the dialog surface and its content. The section also uses the standard Padding controls, including separate mobile paddings. See Common section settings. A pop-up on a button, anywhere on the page The section above is the automatic pop-up: one per store, opened by a timer or a scroll. When you instead want a button that a shopper clicks, use the Pop-up block. Add it inside any section, the same way you add a Button. It comes as a pair: - Pop-up trigger: the button itself. Set its Label, its Style (Primary, Secondary, Primary outline, Secondary outline, or Link), its Size, and its desktop and mobile widths. - Pop-up dialog: what opens. Fill it with content blocks. Its own settings are: - Title: read by screen readers only. Put the visible heading in a block inside the dialog. - Size: Small, Medium, or Large. Wider than the Pop-up section allows. - Image: an optional picture beside the content. Once you set one, Content position appears (Left, Right, or Full), along with Overlay strength, which darkens the picture behind the content from 0 to 150 percent. - The standard Appearance, Layout, and Padding controls. See Common section settings. The theme uses this pair for things like a "Join the waitlist" button next to a countdown, or a "How we ship" panel on a product page. Unlike the section, it never opens on its own, so there is no frequency cap and no page filter. There is also an Inline pop-up block, which is the same dialog opened by a small text link instead of a button. Its one setting is Link label. It is built to sit beside a variant picker, for a jar-size table or a measurements chart: see Variant pickers and swatches and Add a size chart. Tips - Show pop-up is the setting that keeps a pop-up polite. A visitor who has already seen it will not see it again until the period passes, so a longer interval reads as less pushy. - For a newsletter pop-up, Scroll with a trigger point around 50 percent tends to interrupt less than Load: the shopper has shown interest before you ask for their email. - While testing, remember the frequency cap applies to you too. If the pop-up does not reopen on the storefront, you have most likely seen it within the chosen period. In the theme editor it does not open on its own at all; select the section to open it. - Keep the content short. One heading, one line of text, and one action fit the dialog; a long stack of blocks forces it to scroll.

Last updated on Sep 09, 2026

Seasonal shelf

Seasonal shelf Seasonal shelf presents up to eight seasonal items beside a month wheel. Each item has its own start and end month. The section marks items that include the current month as in season and shows when the other items return. Add the section 1. In the theme editor, open the page where you want the shelf. 2. Click Add section. 3. Under Storytelling, choose Seasonal shelf. The section starts with a header and four Shelf item blocks. Add, remove, or reorder the items to match your calendar. The header Above the wheel is a content slot named Header, prefilled with an eyebrow, a heading, and a short intro. Edit, reorder, or remove those blocks like any other content, or empty the slot to show only the wheel. Shelf item settings Each Shelf item has: - Collection: pick a collection and the item takes its title, image, link, and product count from it, so the shelf follows the collection as you edit it in the admin. - Title: the item name. Fill this to override the collection's title, or to name an item that has no collection behind it. - Image: the image shown beside the item. Fill this to override the collection's image. - Link: where the title and its matching arc on the wheel go. This is used only when no Collection is picked. With a collection picked, the item always links to that collection. - In season from: the first month in the item's season. - In season until: the last month in the item's season. A range can cross the end of the year. For example, set In season from to November and In season until to February for a winter item. Set the range from January through December for an item available all year. This section also uses the standard Color, Padding, Margin, and Visibility controls. See Common section settings.

Last updated on Aug 15, 2026

Product cards with deck

Product cards with deck Product cards with deck pairs a product listing with a large editorial Sticky card. On desktop, the product cards scroll while the editorial card stays in view. On smaller screens the sticky card moves above the product list, and the products become a swipeable row. Add the section 1. In the theme editor, open the page where you want the section. 2. Click Add section. 3. Under Products, choose Product cards with deck. The section includes a Header, a button, the reusable product card design, and a Card deck holding three Sticky card blocks. Select those entries in the block list to change their content. Products - Collection: uses products from the selected collection. - Products: lets you choose individual products. - Products to show: how many products appear, from 2 to 8. Default is 6. - Card size: Normal or Large. Large gives each product card more room, so fewer sit in a row. When both sources are set, Collection supplies the products. Leave Collection empty to use the products selected under Products. The product cards follow the card design stored in the section's Product card block. Open it to use the global product-card settings or configure this placement separately. Card deck The editorial side is a Card deck block rather than a single card, so you can rotate through several without adding another section. Add or remove Sticky card children inside it to decide how many cards the deck holds. With one card the deck stands still; with more than one it cycles through them. - Rotate cards automatically: cycles through the deck on its own. On by default. - Change cards every: how long each card stays on screen, from 3 to 20 seconds. Available while Rotate cards automatically is on. - Pause on hover: holds the current card while the pointer is over it. Available while Rotate cards automatically is on. Sticky card Each card in the deck is a Sticky card block inside Card deck. Open one to set: - Image: the desktop image. - Mobile image: an optional replacement on smaller screens. - Overlay strength: adjusts the fade behind the card's content, from 50 to 150 percent. The text and button over the image are child blocks inside Sticky card. Edit, remove, or reorder them like other content blocks. This section also uses the standard Color, Padding, Margin, and Visibility controls. See Common section settings.

Last updated on Sep 09, 2026

Content with slider

Content with slider Content with slider puts a column of text beside a slider of image cards. The text stays put while the reader moves through the cards, so it suits anything told in steps: how something is made, what goes into it, the parts of a collection. Each card carries its own image and its own text over it, so a card can stand on its own rather than just illustrating the column beside it. Add the section 1. In the theme editor, open the page where you want it. 2. Click Add section. 3. Under Storytelling, choose Content with slider. The section arrives with the text column filled in and four cards in place, so you can see the shape before changing anything. The text column The column on the left is a content slot named Content. It comes prefilled with a heading, a short intro paragraph, and a button. Edit, reorder, or remove those blocks, or add others. Leave it empty to show only the slider. The cards Each card is a Slider slide block in the section's blocks. Add one with Add block, remove one, or drag to reorder. The order in the block list is the order the reader sees. With more than one card, the slider gains arrows and a row of progress dots under the text column. Shoppers can also swipe. With a single card there is no navigation. Open a slide to set: - Image: the picture for that card. - Color scheme: the colors for the text sitting on that card. Give a card with a dark image a scheme with light text so the words stay readable. The text on a card is built from blocks nested inside the slide. Each one starts with an eyebrow, a heading, and a button. Select any of them to edit the text, or add other blocks to build a richer card. Layout - Content width: how much of the row the text column takes, from 24 to 48 percent. Default is 30. The slider fills the rest. - Gap: the space between the text column and the slider, from 24 to 120 pixels. - Aspect ratio: the shape of every card. Choose Wide (16:9), Landscape (3:2), Square (1:1), or Portrait (4:5). Default is Portrait (4:5). - Corner radius: how rounded the cards are, from 0 to 64 pixels. Other settings This section also uses the standard Color, Padding, Margin, and Visibility controls. See Common section settings. Tips - The cards share one Aspect ratio, so crop your images to a consistent shape before uploading. A portrait ratio with landscape photos crops them hard at the sides. - Keep the eyebrow on each card short. It works as a small tag over the heading (for example "Detail"), and a long one competes with the heading under it. - Set each card's Color scheme from the image, not from the section. Cards with different images often need different schemes even though they sit in the same slider.

Last updated on Sep 09, 2026

Decorated statement

Decorated statement Decorated statement is a short piece of writing with small images arranged loosely around it. Use it for a brand introduction, a note about a collection, or anything that would read as flat text on its own. The images are decoration, not content: they set a mood around the words rather than illustrating a point, and screen readers skip them. Do not put information in them. Add the section 1. In the theme editor, open the page where you want it. 2. Click Add section. 3. Under Storytelling, choose Decorated statement. The section arrives with placeholder text and six decoration slots, so you can see the arrangement before adding your own images. The statement The words sit in a content slot named Header, prefilled with an eyebrow, a heading, a paragraph, and a button. Edit, reorder, or remove those blocks, or add others. This is ordinary content, so it follows the theme's usual text blocks. Keep it short. The section reserves space around the statement for the decorations, so a long block of text crowds them out. The decorations The images live in a block named Decorations. Each one inside it is a Decoration block. Add, remove, or reorder them; the order in the block list is the order they are placed around the statement, so moving a block moves the image. Open a Decoration to set: - Image: the picture. A cut-out subject on a plain or transparent background sits better here than a full photograph. - Link: optional. Turns the image into a link to the page you set. - Hover label: a short caption that unrolls over the image when the pointer is on it. One or two words fit best. It appears only when Link is filled in. - Size: how large it is drawn, from 40 to 320 pixels. Default is 150. - Rotation: tilts it, from -20 to 20 degrees. - Position, Horizontal: nudges it left or right from its place, from -20 to 20 percent. - Position, Vertical: nudges it up or down from its place, from -20 to 20 percent. The two Position sliders adjust a place the theme already chose. They are for fine-tuning a single image that sits awkwardly, not for laying the field out from scratch. The percentages are read against the section, which is wider than it is tall, so the same number moves an image further sideways than up or down. Height Height sets how far apart the upper and lower decorations are held, from 0 to 240 pixels. Default is 100. It is a minimum. A long statement pushes the section taller than the value on its own, so raising it only has an effect while the words leave room to spare. Raise it to give the statement more air, lower it to pull the section together. On a phone the decorations move into bands above and below the words, so Height no longer applies there. If the section feels busy on a small screen, remove a Decoration block or two rather than resizing the ones you have. Other settings This section also uses the standard Color, Margin, and Visibility controls. See Common section settings. It has no Padding group: Height above sets the space the decorations need. Tips - Images with a transparent background (PNG or WebP) read as objects scattered around the text. Rectangular photos read as a collage instead, which fights the statement. - The theme holds every decoration back from the words on its own. If one image still pulls too much attention, replace it with a paler cut-out or make it smaller rather than working around it. - A Hover label works best when it names what the link leads to, in the shopper's own words: a collection, an ingredient, a maker. Without a Link the field does nothing. - Small rotations do more than large ones. Past about 10 degrees an image reads as tipped over rather than casually placed.

Last updated on Sep 09, 2026

Articles with slider

Articles with slider Articles with slider puts a block of editorial copy on one side and a swipeable row of blog post cards on the other. The cards come from a blog you pick, newest first, so you fill the row by publishing posts rather than by adding blocks. It is a wider, more deliberate version of Featured articles. Use it when the blog deserves an introduction and a link to the whole blog; use Featured articles when a plain row of cards is enough. Add the section 1. Open the page in the theme editor and click Add section. 2. Under Storytelling, choose Articles with slider. 3. In the section settings, set Blog to the blog you want to read posts from. The section starts with a Content content slot and a Card block. The slot holds the copy, the card sets the look every post uses. Section settings - Blog: the blog the section reads posts from. Leave it unset and the section shows placeholder cards in the editor, so you can arrange the layout while you set things up. - Articles to show: how many posts load into the row, from 2 to 12. Default is 6. - Content width: how much of the row the copy column takes, from 24 to 48 percent. Default is 30. The cards fill the rest. - Gap: the space between the copy column and the cards, from 24 to 120 pixels. Default is 40. Content The copy sits in a content slot named Content, prefilled with a heading, an intro paragraph, and a button pointing at the blog. Edit, reorder, or remove those blocks, or add others. Select the slot itself to change its layout, its width, and the space around it. See Sections, blocks, and groups. Card (Blog post card) One Blog post card block sets the look of every card in the row. Select Card under the section to change these controls. - Aspect ratio: the shape of each card image. Landscape (3:2), Square (1:1), Portrait (4:5), or Wide (16:9). - Show category: shows the post's first tag above the title, as a category. On by default. - Show excerpt: shows the post excerpt. When a post has no excerpt set, the start of its content is used. On by default. - Show author: shows the post author. Off by default. - Show date: shows the published date. On by default. The card image, title, and link come from the post itself, so you set those in the blog post, not here. The slider The cards sit in a slider. Visitors swipe on a phone and use the arrows on desktop, and a row of dots in the copy column shows where they are. The dots and arrows appear only when the blog has more than one post. There is no setting for how many cards are visible at once: that follows Content width, Gap, and the screen size. This section also uses the standard Color (including Use dark header theme over this section), Padding, Margin, and Visibility controls. See Common section settings. Tips - Point the button at the blog itself, not at one post. The cards already carry the individual posts, so the button's job is to open the rest. - Set Articles to show higher than the number of cards that fit on screen. A slider with nothing to scroll to reads as a broken row. - The category on each card is the post's first tag alphabetically. Article tags cannot be reordered, so to change which one shows, rename or prefix the tag you want to sort first. - One section reads one blog. To feature a second blog, add a second Articles with slider section.

Last updated on Sep 09, 2026

Staggered content

Staggered content Staggered content lays out a run of items in two columns that sit at different heights, so the page reads down in a zigzag instead of a straight grid. Each item is a picture with a heading and a paragraph beside it. Use it for an About page, a maker profile, a set of places, or anything that is a list of things rather than a single statement. The offsets are not settings. The section reads how many items you added and where each one sits, then places them: even-numbered items drop lower than the ones beside them, and a final odd item widens and centers itself instead of sitting alone in a column. Add the section 1. Open the page in the theme editor and click Add section. 2. Under Layout, choose Staggered content. 3. The section arrives with a header and three items. Edit them, then add more with Add block. Section settings - Gap: the space between the two columns, from 0 to 120 pixels. Default is 80. - Row gap: the space between one row of items and the next, from 0 to 200 pixels. Default is 108. This section also uses the standard Color, Padding, Margin, and Visibility controls. See Common section settings. Header The heading and intro above the items sit in a Header content slot, prefilled with a heading and a paragraph, both centered. Edit or remove those blocks, or empty the slot for items on their own. Content blocks Each item is a Content block. Add, remove, and reorder them in the block list; the order is the order they are placed, so moving a block moves the item. A new Content block arrives with an Image and a Group holding a heading and a paragraph. Those are ordinary content blocks, so you can swap, add to, or remove them like anywhere else in the theme. Select a Content block to set how its own pieces sit: Desktop layout - Direction: Horizontal puts the picture beside the text, Vertical stacks them. - Gap: the space between the picture and the text, from 0 to 100 pixels. Default is 32. - Vertical alignment: with a horizontal direction, where the two line up against each other. - Horizontal alignment: with a vertical direction, where the pieces sit across the block. - Use different layout on mobile: on by default, so items stack on phones. It exposes a Mobile layout group with its own Direction, Gap, and Horizontal alignment. The block also uses the standard Padding controls, with separate mobile values. See Common section settings. How the layout responds - On phones the items run in one column, in block order. - On tablets each item takes about three quarters of the width, alternating which side it hangs from. - On wide screens the items sit in two columns, with every second item pushed down. A last item with no partner spans both columns and pulls up into the gap beside the one before it. Because the stagger is derived, an even number of items reads as a set of pairs and an odd number ends on a single wider item. Both work; pick the count for the content, not for the shape. Tips - Give the pictures a consistent shape. The default is a tall crop, and mixing tall and wide images in the same run breaks the rhythm the offsets are there to create. - Keep each paragraph short. The pairs read as a scan down the page, so an item that runs long stops the eye and flattens the stagger. - Row gap does more for the effect than Gap. Tightening the rows makes the zigzag read as one movement; opening them makes each item stand alone. - The section takes any content block, not only pictures and text. An item can hold an Illustration, a Button, or a Video if that suits the story better.

Last updated on Sep 09, 2026