241 min read

The Section Library: Hero, Product, Category, Social-Proof, Content & Conversion Sections

A reference tour of every section category available in the Landing Page Editor — what each one is for and when to reach for it.

This page is a reference, not a step-by-step guide — use it to browse what's available, then head to the Landing Page Editor to actually add and configure a section. Click + Add Section in the editor to open the same library, with a search box and a mini visual preview on every card. The same dialog also has a Start from template tab — for starting or replacing your whole page with one of the pre-built templates instead of adding sections one at a time, see Template gallery.

Screen: Online Store → Landing Page Editor → Add section → Library.

What's in the library

  • Over a hundred section types across eight categories in + Add Section (Hero, Products, Navigation, Content, Social Proof, Conversion, Style, and Lifestyle), from hero banners to FAQ accordions.
  • Every section is theme-aware — it inherits your store's colours, fonts, and spacing from the Theme Hub.
  • Sections are searchable by name — type "countdown" or "review" and matching cards appear instantly.
  • Every section has a Content tab (headline, text, images, product/category data) and a Design tab (colours, shape, layout), plus a Behaviour tab for motion and scheduling where the section has any.

Finding your way around the dialog

The eight categories run down a vertical sidebar on the left of the dialog, each with a count of how many section types it holds — click a category to filter the grid to just that group, the same job the old row of tabs across the top used to do.

Two extra rows appear above the categories, but only once you have something in them:

  • Recently used — the last few section types you've added, most recent first.
  • Favorites — any section you've starred, from that section's card in the grid.

Both are per-user, not per-store — a teammate sees their own recently-used and favorites, not yours — and neither row shows up at all until it has at least one item in it.

Section tiles show real previews

When you browse All sections in the Store Editor's Library (the Library tile in the module rail on the left edge of the editor), each family tile draws a real preview of that section, not a blank or broken placeholder. Two tiles used to look empty and now render meaningful samples: Product Spotlight shows a sample product, and Spacer shows a labelled Section break divider. A few sample photos that failed to load were replaced with images bundled with the editor. Previews are illustrations only; they never change your store, and once you add the section it uses your own products and content.

Each card also has Add, a star to add it to Favorites, and, for plan-gated sections, a plan badge.

Jumping from the Library to another editor area

While the Library is open, the module rail stays visible. Click Pages, Site-wide, or Settings on the rail and the Library closes and that area opens in the same click — you no longer land back on Pages first and have to click the tile a second time. Clicking Library itself while it is open does nothing, and the Close button (or Esc, when no popup is open above the Library) returns you to Pages.

A preview looks generic

Library previews are sample content drawn by the editor, not your storefront, so they will not show your own products or photos. Add the section to a page to see it with your real content.

The Header/Footer Add block pickers are separate from + Add Section, but their block editors use the same Store Editor inspector. Go to Online Store → Theme → Page Layouts → Header or Footer, select the row/band and then the block you added, and use these merchant-facing task groups instead of older internal headings:

  • Content: Text & media and Accessibility.
  • Design: Colors, Typography, Layout, Spacing & sizing, Shape & borders, Effects, and Advanced.
  • Behaviour: Components, Sticky & scroll, and Mobile.

Only groups relevant to the selected row, band, menu, or block appear. Nested Header panels use Layout for slot placement and Components for action blocks. Footer row styles use Colors, Spacing & sizing, Effects, and Shape & borders; row content uses Text & media, and device visibility uses Mobile. For a saved Footer override, follow the inspector's pointer to Footer Section controls → Spacing & sizing, Footer Section controls → Colors, or Footer Section style → Colors rather than looking for the retired Spacing & Appearance or standalone Appearance headings.

Use Search this block's controls with merchant terms such as “font”, “background”, “sticky”, or “mobile”. Search and the N changed filter are scoped to the current Content/Design/Behaviour lens, so clear them and confirm the selected block if a control seems absent.

A media or repeated-item row looks clipped

The current inspector keeps media Browse/URL rows, colour inputs, and repeated-item action rails inside the panel width; controls wrap on narrow windows instead of requiring horizontal scrolling. Reload an older open editor session before troubleshooting a clipped Browse button or field label. This containment change does not alter the saved image, list order, or customer-facing section layout.

Starter content in a newly added section

When you add one section from the library, the editor selects it immediately and opens it with visible starter content wherever that section needs content to render. The sample is editing guidance, not customer-ready copy: replace it before publishing.

Add and review the section

Go to Online Store → Landing Page Editor → Add section → Library, choose a section, and inspect the newly selected section on the canvas. For example, Social Links starts with an Instagram link; Custom HTML starts with a short heading and paragraph; Mid-Page Banner and Promo Banner start with sample headings and a Shop Now link to /products.

Replace every sample value

Use the selected section's Content controls to replace its sample copy, URLs, images, products, or list items. A visible sample does not mean the linked social account, offer, or destination is yours. For Custom HTML, review the entire starter fragment before publishing it.

Preview, save, and publish

Check the section at desktop, tablet, and mobile widths, then select Save Draft. Publish only after the sample values have been replaced and the customer-facing links open the intended destinations.

Existing saved sections are not rewritten with these defaults; starter content is applied only at the new-insert boundary. Undoing the add removes the new section and clears its selection.

What you see when you add it: photos and copy on newly added sections

A newly added section from the list below is no longer empty. Choose Online Store → Landing Page Editor → Add section → Library, pick the section, and the editor selects it with example media and copy already filled in. The photos are neutral, licensed home-and-craft stills with no people or brand marks; the copy is generic and written for a made-by-hand home store.

SectionWhat it starts with
Composite Split, Grid, Stack, Tabs and MarqueeExample items with a photo, title, caption and a button linking to /products, /collections or /pages/about
AR Preview CTAA sample product image
Collection ShowcaseA sample cover image
LookbookThree captioned photos
Story ModeTwo chapters, each with a photo, heading, text and button
Comparison CarouselTwo Before / After slides
Customer Photo WallFour photos, the first marked featured, all credited to the handle yourstore on Instagram
Content SliderThree cards, each with a button: Made in small batches (button Our story, /pages/about), Free shipping over a set amount (button Shipping details, /pages/shipping) and Easy returns (button Returns policy, /pages/returns)
Split Hero ScrubHeadline Made to be noticed, subheading "Add a short line about this launch, then place your frames.", button Shop now linking to /products. No frames, so no images
Video Hero OverlayHeadline See it in motion, subheading "Add your video link and a short line that sets the tone.", button Shop now linking to /products. No video
How It WorksThree steps: Browse (search icon), Order (bag icon) and Delivered (truck icon), each with one line of description
Product TabsThree tabs: Description, Details and care and Shipping and returns, each with a one-line prompt as its content
Shop by PriceThree price ranges: Under 500 (0 to 500), 500 to 1,000 and Over 1,000 (no upper limit)
Video Spotlight CarouselVideo source set to Every product with a video, so it fills from your product videos with nothing to add by hand
Cascading LookupA Room to Style example: Living room (Calm and minimal, Warm and layered) and Dining room (Everyday, Hosting), each ending in a headline, text and button

Picking these from a family tile

Content Slider, Split Hero Scrub, Video Hero Overlay, How It Works, Product Tabs, Shop by Price and Video Spotlight Carousel are members of a section family. When you pick one of them in the section picker, the starter content above is filled in for any field the pick would otherwise leave empty; a value the pick already sets is kept. The one exception is Video Spotlight Carousel, which always starts on Every product with a video; switch Video source to Pick videos to choose videos by hand. If no product has a video yet, that carousel stays hidden on the storefront.

Add the section and read what appears

After you add it, the example content shows on the canvas straight away. Treat it as a layout guide, not customer-ready copy: the shipping and returns lines in Content Slider, in particular, do not state your real policy.

Replace the example content

Select the section and open its Content lens. Replace the photos with your own, then rewrite each item's title, text and link. In Customer Photo Wall, change each photo's Handle / author from yourstore to the real account and set the photo's Platform and Link. In Content Slider, edit Cards. In Cascading Lookup, edit the options and each Result headline, Result description, Result button text and Result button link. In Comparison Carousel, replace each Before image and After image. In Collection Showcase, the Cover image control appears only while Show cover image is on.

Preview, save and publish

Preview every item and open every link, then Save. Anything you keep is real section content, so customers will see it once you publish.

Existing sections and the placeholder handle

Only sections you add after this change get example content. Sections already on a page are never rewritten. The yourstore handle is a placeholder, not a real account: replace it before publishing or customers will see it credited on every photo.

Why doesn't this section show on my store?

A section whose required data is empty is hidden on the published storefront, while the editor keeps showing it so you can fill it in. Check the data each section needs:

SectionHidden until you add
Tabbed ProductsAt least one entry under Category tabs. With Hide section when empty on, also at least one tab that has products
Product BundlesAt least one bundle. The editor shows the hint "Add product bundles in the editor to display them here."
Press Logos BandAt least one entry under Logos
Ingredient TableAt least one entry under Ingredients
Collection ListAt least one collection in Collections shown → Collections
Category CirclesAt least one entry under Circles; give each its Category and Image
Shop by ConcernAt least one tile under Concerns
Brand Index A-ZAt least one brand in the section's brands list
Blog PostsAt least one entry under Posts, but only when Hide section when empty is on; with it off the section stays visible

These nine do not come with example content when you add them from the picker, because the content is your own catalogue, images or brand names. After adding the data, Save and publish, then reload the storefront.

Empty catalog sections: auto-fill, the "Nothing to show yet" notice and the "Choose…" prompt

Nine sections show nothing to shoppers until you give them data: Tabbed Products, Collection List, Category Circles, Shop by Concern, Press Logos Band, Ingredient Table, Blog Posts, Brand Index A-Z and Product Bundles. The Store Editor helps you fill them in three ways.

Add the section

Go to Online Store → Store Editor, open the page and add the section from the Library. For three of the nine (Collection List, Tabbed Products and Category Circles) the editor then looks at your store's categories and fills the empty field for you as an ordinary draft edit: Collection List gets up to 6 collections, Tabbed Products gets up to 3 category tabs (8 products each), and Category Circles gets the categories that have an image. You can undo it, and it only becomes live when you save and publish. It also runs when you switch an existing section to one of these looks, but never on a section that already has data and never on sections already on the page when it loads.

Read the notice in the inspector

If the store had nothing to offer (no categories, or no category with an image for Category Circles), or the section is one of the other six, select the section and open the Content tab. A notice titled Nothing to show yet says "Visitors will not see this section until you add content to it." Its button names the missing item: Choose a collection (Tabbed Products), Choose collections (Collection List), Add a category (Category Circles), Add a concern (Shop by Concern), Add a logo (Press Logos Band), Add an ingredient (Ingredient Table), Add a post (Blog Posts), Add a brand (Brand Index A-Z) or Add a bundle (Product Bundles). The button scrolls to and focuses the control that holds the data, opening its group if it is collapsed.

Or use the prompt on the canvas

In the editor's preview the empty section also shows a dashed box with the section name, "Nothing to show yet — choose what this section displays" and a Choose… button. Clicking it selects the section and focuses the same control as the notice.

Add the data, save and publish

Fill in the field and save and publish. The notice and the prompt disappear as soon as the section has data.

What shoppers see: nothing. The notice and the Choose… prompt exist only in the editor; the published store simply leaves an empty section out.

Troubleshooting. "My new Collection List came up empty": the store has no categories to fill it from, so use the notice button. "A Category Circles section was not filled": none of your categories has an image, so add circles yourself. "The notice is still there after I added something": check that you added it in the field the notice names, then save; Blog Posts only counts as empty when Hide section when empty is on. "There is no Choose… button in the preview": the preview has not connected to the editor yet; the dashed box in the preview shows only the text when no button is available.

Brand Index A-Z and Product Bundles — add brands and bundles

Both sections used to have no way to add their data from the Store Editor. They now have a list in the inspector.

Open the list

Go to Online Store → Store Editor, open the page and select the section. On the Content tab, open Content details: Brand Index A-Z shows Brands, Product Bundles shows Bundles.

Fill in a new entry and add it

Each list ends with a blank entry. Fill it in and press Add; it joins the list above. Existing entries can be edited in place, moved with Move up and Move down, or deleted with Remove.

Brand Index A-Z, each brand: Brand name, Link (where the brand goes when clicked) and Logo (an image). A brand with a Link is clickable on the storefront; one without is shown as plain text and logo. Use Move up and Move down to arrange brands. When the section groups brands by letter, the storefront sorts them A to Z whatever the row order.

Product Bundles, each bundle: Managed bundle (click Choose bundle to show a bundle you manage under Bundles with its live price; only active bundles are listed; see Product Bundles), Bundle title, Products in this bundle (pick several products), Bundle price, Compare-at price and Discount badge (%) (0 to 100). The card shows the title and "Includes N items", N being the number of products you picked.

On the published storefront, a card with a Managed bundle shows the bundle's current price from the bundle itself, with the item total as the struck compare-at price and a recomputed Save N% badge when the bundle saves money; the typed price fields apply only if the bundle cannot be loaded or the card has no managed bundle. The editor preview still shows the typed price. See Product Bundles.

Customer-facing result: the brand grid or the bundle cards appear on the published page once at least one entry exists. Until then the section is hidden on the storefront and the editor shows the Nothing to show yet notice described above.

Troubleshooting. "My brands appear in a different order": the section is grouping brands by letter, which sorts them A to Z. "The storefront price differs from what I typed" or "the preview shows a different price": a card with a managed bundle uses the live bundle price on the storefront; edit the price on the bundle. "My bundle does not show": the section needs at least one bundle in the list, and you must save and publish. "I cannot find the Brands or Bundles list": it is on the Content tab under Content details, not under Design.

Composite presets and sample content

Screen: Online Store → Landing Page Editor → Library → Composite Carousel, Grid, Marquee, Split, Stack or Tabs → Add. Select the new section, then open the Inspector's Design lens. Its preset thumbnails appear above the component-look groups. These presets are section layouts, not the individual card, heading or media looks farther down the Inspector.

Choose a layout from its thumbnail

Add the composite layout you need, then choose a named preset tile in Design. The grid shows only presets for that layout, so a tabs section offers tabs presets, not split presets. The thumbnail and name help you compare arrangements before choosing one. If an image cannot load, the tile still shows a named neutral preview and remains selectable.

Review the sample before editing

Open Content. A section carrying preset sample content shows This section has sample text and photos. Replace them with your own before publishing. This is an editor reminder, not text added to your customer page. The sample text and photos themselves are real section content: customers will see them if you keep them and later publish.

Replace the text, photos and destinations

Expand each item and replace its title, text, image and link with your own. Also review the section's Eyebrow, Title and Subtitle. Use your own product or collection selections where the section requires store data; a sample does not create catalogue records. After replacing the photos, preview every item and check that its link opens the intended destination.

Keep the sample only when that is your decision

Choose Keep as is to dismiss the reminder without changing the text, photos, item order or layout. This does not save or publish the page; use Save afterward. If you intend to publish the samples, first check that the copy, images and links are suitable for your store.

Applying another preset replaces the section's preset content

A preset changes more than appearance: choosing another tile replaces that section's text, items and composition settings with the new preset's sample. Save a version you can return to before replacing a section you have already customised. To change only a heading, card or image appearance, use its component-look group instead of another section preset.

When the reminder clears automatically. It clears after none of that preset's recorded sample photo URLs remains anywhere in the section. Replacing one of several photos is not enough; keeping or reusing a sample photo keeps the reminder. Changing only text or a link does not clear it. For a preset with no recorded sample photos, use Keep as is after reviewing the copy. The reminder's absence is not a check that every word, product or destination has been reviewed.

Saving and reopening. Choose Save in the top bar, wait for the saved status, then reopen the section. The reminder stays for saved sample content until you dismiss it or replace all recorded sample photos. A dismissed reminder stays dismissed after saving. Neither action changes an existing live page: Publish is a separate decision.

Tabs: choose the image shape

Select Composite Tabs → Design → Image shape. The Product tabs preset starts at 16:9; Collection tabs starts at 1:1. This is the tabs layout's image shape, not the separate Tabbed Products section's navigation settings.

  • Choose 1:1 for square images, 4:5 for portrait cards, 9:16 for tall images, or 16:9 for wide images. The setting changes the layout's image proportions, not the uploaded file.
  • Choose Auto to remove your saved shape override and use the layout's existing behaviour. An older tabs section with no saved shape also shows Auto; opening the control does not backfill a new shape.
  • Save, then check both desktop and mobile previews. A different shape can change the crop; choose a photo that keeps its important subject visible at the selected proportions.

Troubleshooting

  • "I cannot find the preset tiles." Select a composite section and open Design. Its text and items are in Content. Ordinary section looks and component looks use different groups.
  • "A thumbnail is a neutral tile." The preview image did not load; its name is still usable. Reload the editor if several previews fail. Adding the same section again is not necessary.
  • "I replaced my text but the reminder remains." Review every sample photo, including photos inside items. If you deliberately kept a sample, choose Keep as is, then Save.
  • "Image shape did not change my uploaded photo." It changes how images fit in the tabs layout; it does not edit the asset. Confirm that you selected Composite Tabs, not a different product or collection section, and preview the saved section.

Some new sections intentionally show a setup or runtime placeholder

Sections driven by live catalogue data, OAuth, a customer action, or a scroll trigger cannot use fabricated sample data. For example, an Instagram connection, 3D/AR URL, promotional popup, or sticky add-to-cart bar may show setup guidance or remain inactive until its required data or trigger exists. Configure the fields shown in that section's editor; adding it repeatedly will not create real account or product data.

A family — a section with more than one visual variant, like Marquee's Text Ticker/Logo bar/Image strip looks — shows small variant chips under its card. Hover a chip and the larger preview panel beside the grid flips to show that exact variant's look before you commit to adding it.

Card previews are illustrative, not your real page

Every card and the larger hover preview render a hand-built mock of that section type, not a live render of your actual store's content or theme — useful for judging the general shape and layout, but not a preview of exactly how it'll look with your products, copy, and brand colours once added. Most section types share one mock regardless of which variant you pick; only a handful of families (Marquee, Hero Banner's Split layout, and Product Comparison's Comparison Carousel) currently have a distinct mock per variant, so hovering a variant chip on any other family's card may not visibly change the preview even though the variant itself does look different once added to your page.

An existing section's card corners look square, or unchanged after a style edit

Card corner radius (the Shape control's rounded/pill options, and any custom Border Radius under Design → Shape & borders) only repaints on a section once that section is opened and saved in the current editor — sections created before this editor's card-radius rendering shipped keep their old square-corner look until you touch them again. Open the section, change any field (even re-selecting the same value), and save — the corners update immediately. This is a one-time migration per section, not a bug: it protects existing stores from an unannounced visual change on deploy.

I can't find a section I used to see in the library — where did it go?

A batch of section types no longer have their own card in + Add Section, because each one was folded into a broader section that now covers the same ground: Instagram Feed, UGC Gallery → Customer Photo Wall; Certifications, Guarantee Banner → Trust Badges; FAQ (Rich), Collapsible Content → FAQ; Collage Mosaic, Image Collage → Image Gallery; Customer Reviews, Video Testimonials → Testimonial Rich Carousel; Before / After Slider, Before & After → Comparison Carousel; Secondary Announcement Bar → Announcement Bar; Shoppable Image → Room Inspiration; Routine Builder → How It Works; and Instagram Feed (Auto-Sync), which was retired outright (its backend connection was never switched on). None of this affects a page you already built — an existing section of any of these types keeps rendering and keeps opening in its own editor, unchanged; only adding a new one from the library has moved. Each callout under the relevant category below spells out exactly which control on the new primary section reproduces the old look.

Hero & banner sections

The first thing a visitor sees. Options include a multi-slide carousel, a single hero banner with an optional sale badge, a 50/50 split layout with image and text, a full-width background-video hero, a countdown-timer hero for launches and flash sales, and a floating-product-card showcase for spotlighting bestsellers. Whenever the multi-slide carousel has autoplay turned on and more than one slide, it carries a visible pause/play control, operable by keyboard or touch, so a shopper can always stop the motion — required by WCAG 2.2.2.

A further set of hero-flavoured looks rounds out the library: a Split Slideshow and an Image + Text Slideshow for editorial, alternating image-and-text frames; a Video Section and a Video Hero Overlay for a background or featured video (MP4, YouTube, or Vimeo) with optional text overlay; a Mid-Page Banner and a Parallax Band for full-bleed visual breaks further down the page; and a Split Hero Scrub, where the image swaps as the visitor scrolls. Video Section is a look inside the Stage — Hero family, not a separate section-library tile.

Hero Banner — how left-aligned text looks on phones

Screen: Online Store → Store Editor → open Hero Banner → Layout & emphasis.

A Hero Banner whose Text alignment is Left now keeps its headline, subheadline and buttons left-aligned on phones as well as on desktop. Earlier, the text snapped to the centre below 768 pixels wide.

Set the alignment

In Layout & emphasis, set Text alignment to Left. The next control only appears for Left.

Choose the phone behaviour

Use Left text on phones: Left on phones too matches desktop, Centered on phones (classic) keeps the older centred look on small screens. Its helper text reads "Stores created before Oct 2026 keep classic centered text on phones; choose 'Left on phones too' to match desktop."

Which stores get the new look automatically

Left on phones too is the default for stores created from this change onward. Stores that already existed are meant to be held on the classic centred look until the merchant switches the control, so their storefront does not change on its own. That hold is applied by a separate rollout step, not by the editor, so on an older store the control may show either value until that step has run.

The control is missing

Left text on phones is hidden unless Text alignment is Left. The panel shows "Set Text alignment to Left to choose how it looks on phones." Centre and Right alignment are unaffected.

Hero Banner, Hero Split & Hero Product Showcase — the extra controls

These three sections carry a handful of fields that only surface once you open All settings → Pro and pick the right Display Style — they're easy to miss if you're only skimming the Content tab.

Hero Banner (Content tab):

  • Badge Text (Eyebrow) always shows; once you type something into it, a Badge Color picker appears underneath to set its text colour.
  • A separate Eyebrow field (unrelated to Badge Text, despite the similar name) only appears when Display Style is set to Numbered Index, Editorial Overlap, Kinetic Marquee, Full Bleed Collage, or Stacked Deck — the other layouts (Default, Split, Frosted Panel, Full Bleed Backdrop, Full Width) don't render it, so the field is hidden there rather than shown-but-ignored.
  • Image Caption only appears under the Editorial Overlap layout (a small caption line under the image).
  • Marquee Text only appears under the Kinetic Marquee layout — leave it blank to scroll your headline instead.
  • Deck Layers (Label + Body for three layers) only appears under the Stacked Deck layout; Numbered Items (Label + Body for three items) only appears under Numbered Index.
  • Offer Strip — the newest Display Style: a slim, full-width tinted band with no photography behind it, for a single promo code or short-lived offer. It reuses fields you've already set elsewhere in this section — Badge Text (Eyebrow), Headline, Subheadline, CTA Text/Link/Style, and the Highlight Color/Highlight Gradient — 2nd Color/ Highlight Gradient Angle trio from the Content tab's Headline group — but repurposes that trio as the band's own background gradient instead of a headline text-clip, since Offer Strip has no photo to tint against. Leave both highlight colors blank and the band still paints a sane on-brand accent gradient rather than rendering invisible. One new field, Offer Code (Content tab → Body group, only visible when Display Style is Offer Strip), renders as a small dashed-border pill next to the CTA — e.g. "BB25". The band has no fixed height (it grows to fit a long headline or code) and no entrance animation, unlike the other Hero Banner layouts.
  • Highlight Color sits in the Content tab's Headline group. (In the current Store Editor, Heading color is the first field of the Design tab's Heading typography group, and the Subheading typography group has its own Color field. Heading color is hidden on the Editorial asymmetric panel look, which sets a fixed headline colour; Subheading color is ignored on that panel and on the compact layouts Numbered index, Editorial overlap, Kinetic marquee, Collage, Stacked deck and Offer strip.) Highlight Color only does anything once you've typed something into the Highlight Text (Gradient) field back on the Content tab (Heading group) — that's the word or phrase the color paints. Underneath it, Highlight Gradient — 2nd Color (optional) turns the highlight into a real two-stop gradient: set it and the highlight fades from Highlight Color into this second color, at the angle set by Highlight Gradient Angle (degrees) (0–360, defaults to 90, and stays disabled until a 2nd color is set). Leave the 2nd color blank and the highlight renders as a flat color, exactly as it always has — existing sections with no 2nd color set are unaffected.

Hero Split (Content tab → Motion group): Lift image on hover toggle (with a Hover lift amount (px) field), and a Parallax intensity slider. A Tilt angle slider (3°-20°) in the Content tab's Layout group only appears when Display Style is set to Asym. Tilt.

Hero Split — video media (Content tab → Media group): the Media Type dropdown now offers a third option, Video, alongside Image (default) and Category Rail. Media Type only appears when Display Style is Classic Split — the other five split layouts (Image Foreground, Editorial Stacked, Panel Frame, Asym. Tilt, Overlay Text) use the image as a full-bleed or diagonal backdrop rather than a swappable content slot, so the field is hidden rather than shown-but-inert there. Choosing Video reveals four more fields: Video URL (the MP4/WebM file), Poster Image (shown before the video loads), Mobile Fallback Image (a dedicated static image for narrow viewports — falls back to Poster Image if left blank), and three toggles — Autoplay, Muted, and Loop — all on by default.

Why does my hero video show a static image instead of playing on my phone?

That's expected, not a bug: below a 768px viewport width, and whenever a visitor's device has Reduce Motion turned on, the section never mounts the video element at all — it renders the Mobile Fallback Image (or the Poster Image if you haven't set one) instead, so the video file itself is never downloaded on a narrow screen or for a visitor who's asked their OS not to animate content. Set Mobile Fallback Image explicitly if you want a specific frame or crop there, rather than relying on the poster.

Note

Turning Muted off while Autoplay stays on doesn't guarantee the video plays with sound — most browsers still block autoplay-with-sound until the visitor interacts with the page first, regardless of this setting. Leave Muted on (the default) for autoplay to reliably work.

Hero Product Showcase (Content tab): an Eyebrow field in the Heading group, and a Show Background Image toggle (on by default) in the Background Image group that reveals Background Image and Mobile Background Image pickers when it's on. Its Display Style section also now exposes a Columns (Desktop) control for both the Grid and Carousel layouts — this was previously hidden for this section even though the renderer already honoured it.

Hero Product Showcase — Pinned Photo (Hotspots): the Display Layout picker under Display Style has a third option alongside Grid and Carousel — Pinned Photo (Hotspots), a single large photo with clickable pins over specific products in the shot, the same "tap the pin to shop" pattern as the Shoppable Image section, built into the hero.

Switching Display Layout to Pinned Photo (Hotspots) swaps the Products accordion for a Hotspots accordion (the product grid isn't shown in this mode, so its Columns (Desktop) and Background Overlay Opacity controls are hidden too — they don't apply). Add a photo first in the Background Image accordion, then in Hotspots: click anywhere on the photo preview to drop a pin at that spot (or add one manually and set its X % / Y % position by hand), give it a Label, and either a Product ID (via the picker, so the pin links to a real product and its live name/price/thumbnail can show in the popover) or a Link URL for a plain link-out pin — only one of the two can be set at a time. Popover Style controls what a shopper sees when they tap a pin: Label Only (just the text you typed), Product Card (a thumbnail, name, and price pulled live from the linked product), or Image Hotspot (the same card with a custom thumbnail). Pulsing Animation on Hotspot Pins adds a subtle animated ring around each pin to draw the eye — it's automatically switched off for shoppers who have "reduce motion" turned on at the OS level.

Why don't my hero photo hotspots show up?

Two separate things have to be true: Display Layout must be set to Pinned Photo (Hotspots) (hotspots placed while a different layout is selected are saved but not shown until you switch back), and a Background Image must be set — with no photo, the hotspot area renders an empty placeholder in the editor and nothing at all on the live storefront. A pin with neither a Product ID nor a Link URL still shows on the photo but its popover only displays the Label text, with no "Shop Now" or "Learn more" link.

Still in Display Style, right below Background Overlay Opacity, an Overlay Style dropdown picks how the background photo darkens behind your heading and products: Fade Image (classic) dims the photo itself, while Scrim Tint (recommended) keeps the photo at full brightness and darkens it with a separate tint layer on top instead. A section you built before this control shipped keeps rendering with Fade Image (classic) until you switch it — only a new Hero Product Showcase section you add from today gets Scrim Tint as its starting point. Both this control and Background Overlay Opacity are hidden entirely when Display Layout is set to Pinned Photo (Hotspots), since that layout suppresses the decorative background overlay altogether.

Hero Product Showcase's Design tab has its own Product cards group, with a Hover effect dropdown among its border/shadow/image-ratio fields — None, Zoom image, Lift card, Overlay, or Brighten image, applied when a shopper points at one of the product cards in the Grid or Carousel layout. This field is hidden whenever Layout is set to Pinned photo, since that layout shows one large photo with hotspot pins instead of a grid of product cards for the effect to animate.

A field you expect isn't showing up

Most of the fields above are gated to one specific Display Style variant — if Eyebrow, Image Caption, Marquee Text, Deck Layers, Numbered Items, the Hero Split Tilt Angle slider, or the Product Cards Hover effect seem to be missing, check which layout is selected first; switching to the matching variant reveals the field rather than leaving it visible-but-inert.

Separately, the full-width background-video hero (Hero Video)'s Background colour control (Content tab → Band style group) now changes the rendered background — it used to accept a colour and save it without ever affecting the page. Any Hero Video section that never had this field touched keeps rendering exactly as before.

Hero Video — video image treatment

Select a Hero Video section, then open Design → Image treatment → Video image treatment. This part controls the fixed video or poster frame; Hero Video does not offer an Image Shape or aspect-ratio control.

ControlOptionsStorefront effect
Corner radiusNone, S, M, L, XL, PillRounds the native video and poster frame
How images fill the shapeFill shape, Fit insideFill shape crops media to cover the fixed frame; Fit inside keeps the whole image or video visible inside it

Choose the frame corners

Set Corner radius from None through Pill. Review a native video or its poster in the preview.

Choose how the media fits

Set How images fill the shape to Fill shape for an edge-to-edge crop or Fit inside to keep the whole media item visible, then save and publish the page.

Why can't I find Image Shape on Hero Video?

That row is intentionally absent in the current Store Editor because Hero Video uses a fixed background-media frame. Use Corner radius and How images fill the shape for the two supported image-treatment changes.

Hero Video — content position

Use the single Content position control to move the heading block to one of nine positions.

Open the position control

Select the Hero Video section, then open Content → Content position → Content position.

Choose one of nine positions

Choose Top left, Top center, Top right, Middle left, Middle center, Middle right, Bottom left, Bottom center, or Bottom right. The heading block moves to the chosen position.

Save and publish

Review the preview, save the page, and publish when the placement is ready for visitors.

If the section was saved with the older four-position control, the current editor shows its real matching position: Middle center, Bottom left, Bottom center, or Bottom right. Choosing any position now saves the new nine-position value; that new choice takes precedence while the older fallback is kept in the section data.

Why does an older Hero Video already show a selected position?

The current control reads the older saved position instead of showing a second, competing control. Choose a new value only when you want to move the heading block, then save and refresh the preview.

Rich heading and subheading typography in the current Store Editor

Screen: Online Store → Landing Page Editor → select a section → All settings → Design.

These controls belong to the current Store Editor. Hero Banner, Hero Split, and Hero Video each have a Heading typography group. Featured Product has a Heading and subheading typography group with the same controls for both text levels. The classic Landing Page Editor may arrange similarly named typography controls differently, so use the current editor for the paths and labels below.

ControlValuesStorefront effect
Heading font family / Subheading font familyType a font-family nameChanges the typeface for that text
Heading font size / Subheading font size8–160 pxSets an exact text size
Heading font weight / Subheading font weight100–900, in steps of 100Changes how light or bold the text appears
Heading letter spacing / Subheading letter spacing-0.1–0.5 em, in steps of 0.01Tightens or opens the space between letters
Heading alignment / Subheading alignmentLeft, Center, Right, JustifyAligns the text inside its available content area
Heading transform / Subheading transformNone, Uppercase, Lowercase, CapitalizeChanges the displayed letter case without rewriting your saved copy
Heading style / Subheading styleNormal, ItalicSwitches between upright and italic text
Heading decoration / Subheading decorationNone, Underline, StrikethroughAdds or removes a line decoration

Open the typography group

Select Hero Banner, Hero Split, or Hero Video and expand Heading typography. For Featured Product, expand Heading and subheading typography instead.

Set the type controls you need

Change only the font, size, weight, spacing, alignment, transform, style, or decoration you want to override. Hero sections expose these rich controls for the heading; Featured Product exposes a second matching set for its subheading.

Review and publish

Check the text in the editor preview, then save and publish the page. The same values apply to the rendered heading, and to Featured Product's subheading when you changed its controls.

An existing section with these typography values unset keeps its previous type styling.

Why can't I find subheading typography on my hero?

That is expected in the current Store Editor: Hero Banner, Hero Split, and Hero Video expose the rich Heading typography group only. The combined heading-and-subheading group belongs to Featured Product. Also confirm that Design is selected in All settings; these groups do not appear under Content or Behaviour.

Each slide in Hero Carousel has a Content mode choice. Go to Online Store → Pages → [your page] → Hero Carousel → Content → Slides, open the slide, and choose Text over image or Image only. Use Image only when the artwork already contains its finished promotional copy and should not have BillionBiz text or buttons painted over it.

Choose Image only

Set Content mode to Image only. The inspector keeps Image, Mobile image, Headline, Primary button link, and Image focal point visible. It hides the controls whose values this mode does not paint: text and badge colours, Subheadline, both button labels, the secondary button link, badge settings, text position and alignment, overlay colour/darkness, and the slide/headline/ badge style groups.

Set the whole-slide destination

Use Primary button link if the artwork should be clickable. In Image only mode this link applies to the whole slide; no button is drawn. Leave it blank when the artwork should have no destination.

Keep a useful Headline

The storefront does not paint Headline in Image only mode, but it uses that value as the image description. Keep it meaningful even though it is not visible copy. Image focal point also remains available for the Editorial overlap (Variant D) art column.

Save and publish

Review the image and whole-slide link, select Save, then publish the page when the slide is ready for customers.

Hidden overlay values are preserved

The hidden controls are not deleted. Switch Content mode back to Text over image and the saved subheadline, button, badge, overlay, position, and style values return. While Image only is selected, the inspector shows one reminder: Switch to Text over image to edit overlay text and buttons.

Why don't customers see my heading text on this slide?

That is expected when Content mode is Image only. Switch it to Text over image to restore the painted heading and the hidden overlay controls. Other slides in the carousel keep their own Content mode.

Image Gallery, Lookbook, and Brand Story — item controls follow the selected type

The same inspector rule applies to repeated media and pane items: a control disappears when the selected item type does not render it, while its saved value remains available if you switch back.

Section and pathChoiceControls shown or hiddenCustomer-facing result
Image Gallery → Content → Images → [item] → Media typeVideoHides the Image field and shows Video with Video and Video poster imageCustomers see the video/poster rather than a dead still-image field
Lookbook → Content → Images → [item] → Media typeVideoHides Image and Mobile image and shows Video with its video and poster fieldsThe lookbook item uses the authored video while its saved still-image values stay out of the way
Brand Story → Content → Layout & type register → Type registerEditorialReveals Editorial panes; each pane has Pane type: Media, Product, or Image + textEach pane renders only the content supported by its type

For a Brand Story editorial pane, Product shows the Product picker and hides Media, Kicker, Headline, Body, and button fields because the selected product supplies the content. Media shows the media, kicker, headline, and optional button fields but hides Body. Image + text shows those fields plus Body, while the Product picker is hidden.

A saved image or text field disappeared from an item

Check Media type or Pane type first. The editor hides fields that the chosen renderer branch does not use; it does not clear their saved values. Switch back to the earlier type to edit those values, or finish the visible video/product fields for the new type before saving and publishing.

The Visual Style dropdown (Content tab → Slides group, above the slide list) now has four options: Variant A (Classic Centered), Variant B (Split Layout), Variant C (Overlay & Parallax), and Variant D (Editorial Asymmetric).

Below the slide list, a Layout & Framing group applies to every variant:

  • Containment — Full-bleed (default) or Inset (rounded card), which frames the carousel in a rounded card with page gutters on each side, the look brands like Vilvah, Plum, and boAt use.
  • Gutter Size — only appears once Containment is set to Inset: Small, Medium (default), or Large.

Variant B — Split Layout dimensions

Switch Visual Style to Variant B and a Split Layout group appears with three fields: Image Position (Image Right default or Image Left), Column Ratio (media / content) — a preset picker: 50/50 (default), 60/40, 40/60, 70/30, or 30/70 — and Content Panel Style (Plain default, Tinted, or Frosted), which styles the panel the heading/CTA sit on top of.

Variant B — per-slide Media Aspect Ratio override

Still on Variant B, open an individual slide's Content editor and a Media Aspect Ratio (this slide) field appears — it only renders for Variant B, since it's the one style whose media sits in its own column (line up with Art Focal Point above, which is likewise gated to a single variant). It defaults to Inherit from Slide Style, which leaves this slide's ratio unset and lets the section-level Slide Style aspect ratio keep controlling it. Pick 1:1, 3:4, 4:3, or 16:9 to override just this one slide — every other slide in the carousel is unaffected. Switching back to Inherit removes the override and the slide falls back to whatever the Slide Style group is set to.

Variant D — Editorial Asymmetric controls

Switch Visual Style to Variant D and an Editorial Layout group appears instead, with four controls:

  • Type Overlap — Behind art (default): the headline paints behind/below the photo, a deliberate editorial restraint (the same treatment Toteme/Fendi-style hero photography uses, keeping the headline mostly over the image's clean negative space). In front of art: the headline paints above the photo, fully legible everywhere. No overlap: headline and art sit in two separate, non-overlapping columns instead of sharing space.
  • Art Column Width — Narrow, Normal (default), or Wide, controlling how much of the desktop layout the photo occupies (roughly 38% / 48% / 58%).
  • CTA Style — Text link (default for this variant) or Filled button.
  • Show Slide Number Rubric toggle — adds a small serif slide number (01, 02, …) in the top-left corner of the art, in the same numbered-index style used elsewhere in the editorial family.

Why don't I see the Split Layout or Editorial Layout controls?

Both groups are scoped to one Visual Style each — Split Layout only shows for Variant B, and Editorial Layout only shows for Variant D — because their fields are no-ops on the other variants. Switch Visual Style to the matching variant and the group appears with whatever values you last set.

Slideshow frames, countdown dates and choice fields in the current inspector

These behaviours apply to the current Store Editor (v3; UAT today, the legacy editor on production is unchanged).

Edit each Image With Text Slideshow frame

Select the section, open Content, and open a frame. Each frame's image, mobile image, alt text, eyebrow, title, body, and call-to-action label and link are editable fields (they were read-only before). Labels are the field names in sentence case, for example Eyebrow, Title and Body. Use Add to append a frame, the remove control on a frame to delete it, and the reorder controls to change the order.

Set a Hero Countdown end time

The End time field is a date and time picker in your store's timezone, shown under the field as "Store time (your zone)" (Settings, Store settings), the same picker as section scheduling. It saves as a UTC time, so visitors in other zones count down to the same moment. Timer style (Minimal, Boxed, Circles) and Expired message sit beside it.

Pick from choices instead of typing

Six fields with a fixed set of values render as dropdowns: Hero Countdown Timer style (Minimal, Boxed, Circles); Image With Text Slideshow Mode (Scroll snap, Auto rotate) and Text position (Overlay bottom, Side panel, Overlay center); and Headline Collision Heading size, Image width and Image layer. Opening the inspector never writes a value; nothing changes until you choose one.

Why do I not see a headline field on my Hero Split or Hero Countdown?

Sections merged from an older type (Hero Split, Hero Countdown, Parallax Band and the Headline collision and slideshow members) hide only the fields the merged renderer never reads. The stored values are not deleted, and a field the renderer does use (such as the countdown end time, timer style and expired message) always stays visible.

Product sections

Sections that pull directly from your live catalogue: a bestsellers grid, a new-arrivals feed, a single featured-product spotlight, a flash-sale grid with a live countdown, product bundles with savings call-outs, a side-by-side product-comparison table, a "trending now" scroller, and a "recently viewed" strip.

A newer batch of product sections covers more specific merchandising needs. Inside the Shoppable Media family, Shoppable Video places timestamp-pinned product chips directly on lifestyle video. Featured Product (Rich) is an extended single-product spotlight with a thumbnails-side gallery; Product Tabs and Tabbed Products split a catalogue into tabbed groups (by material/care/specs, or by category); Complete the Look suggests frequently-bought-together add-ons with bundle pricing; 3D / AR Viewer embeds an interactive 3D product view — either a merchant-supplied Spline scene URL, or (in the 3D Source group) a direct Model URL pointing at a GLB/GLTF file, which renders through a native model viewer instead of the Spline embed; there's no default scene/model, so the section shows a placeholder until one is set. In the Display group, Interactive (on by default) enables orbit/zoom drag-to-rotate on the model; turning it off shows a static view. Linked Product ID adds a plain "View Product" link below the viewer pointing at that product's page — it does not pull in the product's name, price, or image, so pair it with the Heading/Subheading fields if you want that context shown. Only the base viewer is available today (a full iOS AR handoff isn't wired up yet, and the Show AR Button toggle stays disabled until it ships). Also inside Shoppable Media, Video Spotlight Carousel is a carousel of native, vertical product videos with a pinned mini product card. Neither video look has its own standalone section-library tile. Neither of these sections uploads a video file: they show videos already attached to your products (or, for Shoppable Video on Manual, a pasted video address). To add the product video itself, see Upload a shoppable product video.

Product-backed video sections

Shoppable Video, Video Spotlight Carousel, and the product-enabled Video Section can use published product-video records instead of manually entered media. They are family looks in the v3 Store Editor, so you add or switch to the look through its family rather than searching for a standalone tile.

Add the video look from its family

Go to Online Store → Store Editor, open the page, and choose Add section. To add Video Section, open Stage — Hero, select Video Section, and choose Add section. To add Shoppable Video or Video Spotlight Carousel, open Shoppable Media, select the required look, and choose Add section.

Switch an existing section's family look

Select the section, open Design, choose Customize, and find Family look. Choose Video Section, Shoppable Video, or Video Spotlight Carousel as applicable. The choices stay within their own family: Video Section belongs to Stage — Hero, while the other two belong to Shoppable Media.

Open the video-source controls

Return to Content. For Shoppable Video and Video Section, open Video source. For Video Spotlight Carousel, open Which videos to show.

Choose product videos

Set Content source to Product videos. This reveals the Product videos picker. Choose a product video; for a multi-video section, add each video and use Move up or Move down to set its storefront order. Each selected row can also be Live or Pinned. Set Content source back to Manual to use the section's own media and product-tag controls instead.

Save, publish, and check playback

Save and publish the page. Confirm the poster and video load on the storefront and, for a multi-video section, that the videos follow the saved order.

Why don't I see a Video tile?

The v3 section library groups these looks into families instead of showing standalone tiles. Open Stage — Hero for Video Section, or Shoppable Media for Shoppable Video and Video Spotlight Carousel. For an existing section, use Design → Customize → Family look.

On the storefront, the selected records resolve in their saved order and missing records are omitted. Video Section and Shoppable Video use the first resolved video; Video Spotlight Carousel can use the ordered set. Published media supplies its video file and poster. Shoppable product tags come from the product-video record in their saved sort order and position. A simple tagged product can be added to the cart; a product with variants opens its product page instead so the customer can choose the required variant.

Why is a product missing from my video section?

In the Store Editor, reopen the section's Video source or Which videos to show group. Confirm Content source is Product videos, then check the Product videos selections and their order. A deleted, unavailable, or unpublished video is omitted on the storefront. If a tagged product opens its product page instead of adding immediately, that is expected when a variant choice is required.

Why don't customers see my reels?

With Content source set to Product videos, a Video Spotlight Carousel or Reels grid shows a video only when the upload has finished and at least one product tagged on that video is active on the storefront (not draft or hidden). Videos that are still processing are skipped. If an upload was interrupted and the video stays pending on the product, use Remove video and upload it again. With Video source set to Every product with a video, the section instead uses the video media on your products, so check that those products have a video in their media. Then save and publish, and check the published page, not only the editor preview.

Per-item Live or Pinned snapshots

Product, category, collection, review, and product-video picker rows in the Store Editor have a Live / Pinned control labelled Live or pinned. The choice belongs to that one selected item: items in the same picker can use different modes.

  • Live is the default. The storefront uses the source item's current display content whenever it renders.
  • Pinned preserves a safe snapshot of selected display fields from the moment you pin. Later edits to those fields do not change the published item until you refresh its snapshot or switch it back to Live.
Picked itemDisplay content preserved by Pinned
ReviewTitle, comment, rating, displayed customer name, and review images
ProductProduct name and image
Product videoPoster image
Category or collectionName and image

Pinned display content does not freeze eligibility or commerce facts

Price, stock, product variants, and the playable video source always stay live. The storefront still loads the source item to decide whether it may be shown. An unapproved review or deleted product, video, category, or collection therefore disappears even when its display content is Pinned. A pin never restores an ineligible or deleted item.

Pin one selected item

Open the section's picker group and find the selected row. Choose Pinned in Live or pinned. The row shows Pinned <date> after the snapshot is captured. Save and publish the page; only the display fields in the table above are preserved.

Refresh a pinned snapshot

Make the required display change on the source review, product, product video, category, or collection first. Return to the selected row and choose Refresh snapshot. The picker captures the currently loaded display content and updates the Pinned <date> value. Save and publish again.

Return an item to Live

Choose Live on that row, then save and publish. The saved snapshot is removed and the storefront uses the source item's current display content again. Removing the selected item from the picker also removes its snapshot; selecting that item again starts in Live mode.

Opening a picker, loading a selected item, searching, or closing the dialog does not create or refresh a snapshot. If Pinned or Refresh snapshot is disabled, the picker has not loaded current display data for that item. Open its Choose product, Choose category, Choose collection, Choose review, or Choose product video dialog and search for the existing item. After its result loads, close the dialog and try the row control again. If the item cannot be found, the editor cannot safely create a new snapshot from it.

Screen: Online Store → Landing Page Editor → select the section → All settings → Content. This guidance applies to the standard Featured Product and Featured Collection presentations. Use the member-specific instructions below for Featured Product (Rich) and other family members.

Select a real catalogue source

For Featured Product, open Product → Product to feature and choose the product this section should sell. The separate Product field is a fallback for older configurations when there is no picker selection; changing it does not override a selected Product to feature.

For Featured Collection, open Products shown. Use Products to show for a manual product selection, or Collection for products from one collection. A chosen collection takes precedence over a manual selection. In a tabbed presentation, check each entry in Tabs: its Tab label names the tab, and its Collection chooses that tab's source.

Check the resolved products before publishing

A standard Featured Product without a resolved product shows Pick a product in the editor and nothing on the storefront. A Featured Collection with no resolved products does the same. These are selection hints, rather than sample products: customers do not get a made-up name, price or purchase action. If a previously selected product or collection was deleted, select a replacement.

A Featured Collection with neither a collection nor manual product selection can use real products supplied from the catalogue. Seeing products without an explicit picker selection therefore does not mean that the section has inserted samples.

Separate an empty source from an empty tab or filter

If one collection tab is empty but another contains products, the tabs remain available so a customer can switch. Likewise, a Sale or New filter with no matches keeps the filter controls when the underlying source still has products. Switch back to All, or another populated tab, before replacing the source. This differs from a source that resolves no products at all.

Save and inspect the published page

Click Save, then Publish when the selected products are ready. Open the storefront afresh and check the intended product, each collection tab and any filter chips. If the section is still absent, re-open its picker and verify the selected record still exists; then check the section's visibility and schedule rather than adding placeholder sales copy.

Screen: select a Featured Product (Rich) section (or the Rich variant of Featured Product) → Content tab.

The Product field is a real catalogue picker — search and pick a product the same way as any other product-picker field in the library. It shows the product's actual name once selected, and still resolves correctly (rather than falling back to a plain ID field) on a section that was absorbed from an earlier Featured Product Rich save. Every other Content field this variant carried before — Heading, Subheading, Custom Heading, Custom Description, CTA Text, Show Price, Show Add to Cart, Show Description, and Background Color — stays exactly where it was; picking a product doesn't remove or reset any of them.

Use the selected product row's Live or Pinned mode when its name and image should either track the catalogue or stay fixed for this placement. Price, stock, and variants remain live in both modes.

Use the copy and price controls when this placement needs to differ from the catalogue product. In Content → Copy, Custom heading supplies a placement-specific title when Heading is empty; if both are empty, the product name is shown. Custom description replaces the catalogue description with plain text for this section and falls back to the product description when empty. In Content → Product signals, turn off Show price to hide the price in every Featured Product (Rich) layout.

Use Image aspect ratio to set the product-image frame in both the standard presentations and the Editorial presentation.

Open the image controls

Select Featured Product, then open Design → Image → Image aspect ratio.

Choose the ratio

Select 1:1, 4:5, 3:4, or 16:9. Standard presentations change the product-image wrapper to that ratio. Editorial changes its large, frameless image composition to the same ratio; the image fills the frame and may crop at its edges.

Reset to a square frame

Choose 1:1, the control's default, to return both presentation paths to a square frame. An older Editorial section with no ratio saved can retain its original 4:5 fallback, so explicitly choose 1:1 and save when you want a square Editorial image.

Save and publish

Check the image crop in the preview, save the page, and publish it. Repeat the check after switching the presentation because the surrounding composition changes even when the ratio stays the same.

Why does the image crop differently after changing presentation?

The ratio controls the frame, while each presentation owns its surrounding layout. Confirm the selected Image aspect ratio, then use a source image with the subject positioned for that crop if the important part is being cut off.

Bulk Order Table — product source, tier hints & the silent-empty edge case

Screen: Online Store → Landing Page Editor → Add section → Library, search "bulk" for Bulk Order Table — a wholesale/bulk ordering grid with a quantity stepper and per-row subtotal, one row per product.

Pick a product source (Content tab → Products group)

Two ways to populate the table, checked in this order: Product IDs (comma-separated) — an explicit list, takes priority whenever it's non-empty — or Collection ID (fallback source) — matched against each product's category/collection, used only when Product IDs is blank. Max Rows (1–24, default 10) caps how many rows render even if the source resolves more than that.

Add quantity tier hints (optional)

Open Quantity Tier Hints and click Add Tier Hint to add a Min Qty + Label pair (e.g. "Buy 10+, save 10%"). Each row shows whichever tier's Min Qty is the highest one at or below that row's current quantity — the hint is copy only, it doesn't apply a real discount to the price shown.

Cart & display controls (Layout tab)

Add-to-Cart Button Text (default "Add to Cart") and Show running order subtotal (on by default; sums price × quantity across every row) are the only Layout-tab controls.

Why is my Bulk Order Table showing nothing but the heading?

If neither Product IDs nor Collection ID resolves any real products, the live storefront renders only the eyebrow, heading, and subheading — no table, no rows, and no visible error or empty-state message to the shopper. The editor canvas never looks this way, because it fills an unconfigured table with placeholder rows so you can see the layout while you work; that placeholder never appears to real visitors. If a table looks broken on your live page, check Product IDs and Collection ID first.

Product Comparison — choose and order products

Screen: Online Store → Store Editor → open Product Comparison → Content → Products compared.

Choose the specification source

Set Specification source to Manual to use the comparison attributes and values saved in the section, or choose Product specifications to build the table from the selected products' catalogue specifications. Changing the mode changes which Products to compare picker is shown; it does not turn the section into the classic editor's expandable product-row form.

Search and select products

With Manual selected, use Add product under Products to compare; the Choose products dialog lets you search and select more than one catalogue product. With Product specifications selected, use Choose product under Products to compare and search the same product catalogue. Already selected results are marked Added, and selections remain in the order in which the storefront should show their columns.

Arrange or remove columns

Use Move up or Move down on a selected row to change its column position. Choose Remove to take that product out of this section without deleting it from the catalogue.

Choose Live or Pinned per product

Each selected row has a Live / Pinned control labelled Live or pinned. Live follows the product's current display content. Pinned preserves the product name and image captured for that row; price, stock, variants, availability, and catalogue specifications remain live. Use Refresh snapshot after changing the source name or image, or switch the row back to Live.

With Product specifications, the published storefront builds one specification table from the union of specification names across the available selected products. Each product keeps its picker order as a column. When a product has no value for a row that another selected product supplies, its cell shows — so the table stays aligned. In Layout & highlights, Show specs is on by default; turn it off to hide the specification rows without clearing the selections.

Why is a comparison column missing?

In Product specifications mode, the storefront omits a selected product that has been deleted or is no longer available to the published page. Reopen Products compared → Products to compare, remove or replace the stale selection, and make sure at least two available products remain; with fewer than two, there is no useful side-by-side comparison. If the columns appear but the table has no specification rows, confirm at least one selected product has catalogue specifications, or switch Specification source to Manual and add the manual comparison data.

Comparison Carousel (above) is the first section that can build its content from reusable blocks — Compare Slider, Image, Video, and Quote, up to 12 per section — instead of only its own fixed fields; see Content Blocks for how the Blocks panel works. It also auto-advances when its own Autoplay setting is on and has more than one slide, and — like the other carousels in this library — carries a visible, keyboard- and touch-operable pause/play control whenever it's auto-advancing, per WCAG 2.2.2.

Comparison Carousel's Layout group: Width and Alignment

Comparison Carousel's Design tab has a Layout group with two controls that actually affect this section (the group's other rows, Offset, have no effect here — leave them alone):

  • Width — sets the max content width of the carousel: Narrow (~720px), Standard (~1100px, default), Wide (~1400px), or Full (100% of the page width).
  • Alignment — sets the text-alignment of the section's heading/eyebrow copy: Left, Center, or Right.

Flash Sale — Default Card Appearance (section-level fallback)

Screen: Flash Sale section → Design tab → Card look group.

Default Card Appearance sets the fallback look for every product card in the section: Shape (Square, Rounded — default, Circle, Pill), Shadow (None — default, Subtle, Medium, Strong), Background Color, Border Color, and Border Width. Leave any of them blank/zero and the card keeps its existing built-in look (rounded corners, no shadow) — this group is additive, not a forced restyle.

Per-product Card Styling wins over this default

Back on the Content tab, each product you've added under the section's product picker has its own optional Card Styling (Optional) group — the same Shape/Shadow/Background/Border fields, set per product. Any field a merchant fills in there overrides this section-level Default Card Appearance for that one product's card; leaving a product's Card Styling blank falls back to whatever's set here. If a product's card looks different from the rest of the grid, check that product's own Card Styling group first before assuming the section-level default is broken.

This is separate from the Universal Card sold-progress bar

Default Card Appearance only affects Flash Sale's own classic card rendering. If you've opted this section into the newer shared card design, see Universal Card (preview) on six sections below — the sold-progress bar behaves the same either way, but the shape/shadow/border fields described here don't apply once Universal Card is switched on for the section.

Screen: Store Editor v3 → select a Featured Collection section → Design → Rating look.

Pick a rating look

In Design, find Rating look and choose one of the look tiles (Original, Clear stars, Single star, Editorial score or Fine outline). The card star row only follows your rating settings once a rating look or rating settings are saved on the section.

Set Show empty stars

Under the same group, switch Show empty stars on or off. On: a product with no reviews yet shows a row of empty stars on its card. Off: a product with no reviews shows no star row. Products that do have a rating always show their stars, number and review count.

Publish and check a product with no reviews

Save, publish and refresh the storefront, then look at a product that has no reviews.

A Featured Collection that never saved a rating look or Show empty stars keeps its previous cards: the single star with the score for rated products and nothing for unrated ones.

Why don't my empty stars show?

Empty stars appear only for unrated products, only when a rating look is saved on the section, and only when Show empty stars is on. Also check that the section is set to show ratings on its cards (a section with ratings hidden shows no star row at all), and that you published.

Screen: Store Editor v3 → select a Featured Collection section → Design.

Use universal cards

In Design, the card looks only apply to universal cards. If the section is on classic cards, the panel shows "Card looks apply to universal cards. This section uses classic cards." with a Switch to universal cards button. Click it.

Open Meta stack look and Price look

Once the section uses universal cards, the look groups include Meta stack look (the text lines under the product image) and Price look (how the price is shown). Open either group and pick a look tile.

Save, publish, and refresh

Save, publish and refresh the storefront to see the new card text and price styling.

Meta stack look and Price look are hidden, not just disabled, in two cases. The section is on classic cards. Or the section is on an Editorial card preset, or on the contained editorial grid (Grid layout with the contained editorial grid card preset): those cards never read these two looks. The Product card look group stays visible in the Editorial case, because resetting it is how you leave Editorial.

Why can't I see Meta stack look or Price look?

Check that the section is on universal cards (use Switch to universal cards) and that it is not on an Editorial card preset or the contained editorial grid. To leave Editorial, reset the Product card look group, then the two groups appear.

In + Add Section, choose the Featured Collection family's New Arrivals (Badge) variant (an existing section may still be named New Arrivals). Then select it and open All settings → Content → Heading.

Choose Heading align

Set Heading align to Left, Center, or Right. The choice aligns the eyebrow, heading, and optional subheading, and anchors the product-grid wrapper to the same side.

Save and publish

Review the heading and products together in the preview, then save and publish the page. A section that has never saved Heading align remains centered, matching its previous storefront layout.

Why didn't the New Arrivals alignment change?

Confirm you selected the New Arrivals (Badge) look of Featured Collection, not the base Featured Collection look, and changed Heading align in the Heading group. Save, publish, and refresh the storefront; changing a different section's alignment does not carry across to this one.

Badge colours on New Arrivals and Best Selling cards

Product-card badge background and text colours you set on a New Arrivals or Best Selling section now apply even when no badge look is selected. Previously they only showed once a badge look was chosen. Sections with no badge colours set render as before. If a badge colour suddenly appears on a section you edited long ago, clear the colour to return to the default.

Product-card text follows Heading align on Refined New Arrivals and Best Selling

With Presentation set to Refined, a Heading align of Center or Right (Content → Heading) also centres or right-aligns the product name and price inside the cards of New Arrivals and Best Selling. Left, or never set, keeps them start-aligned. Trending Now and Recently Viewed have no alignment setting, so their cards stay start-aligned. On Classic sections nothing changes.

Category & navigation sections

Ways to help customers browse: category circles (round image tiles), a bento-style category grid for wide catalogues, a "shop by category" browser that pulls your real catalogue structure, "shop by price" and "shop by brand" link groups, and a collection-showcase block for featuring one collection at a time.

Newer navigation options include Shop by Concern (health/wellness stores browsing by concern rather than category), a full Mega Menu dropdown, Sticky Header behaviour controls for your site header's scroll response, a typography-only Brand Index A-Z for multi-brand editorial stores, a Dynamic Showcase that adapts between a grid and a carousel automatically, and three collection-focused variants that sit alongside Collection Showcase above: Featured Collection (one curated collection with editorial intro text), Collection List (a grid of collection tiles), and Collection Tabs (several collections behind a tab strip — replaces what would otherwise be multiple Featured Collection sections stacked on the page).

Shop by Category — choose and order catalogue categories

Shop by Category uses the same catalogue-backed category picker as the Store Editor's other category bindings. The storefront keeps the order you set in the selected list.

Open Categories

Go to Online Store → Store Editor, open the page, select Shop by Category, then open Content → Categories → Categories.

Choose real catalogue categories

Choose Add category, search the store catalogue, and select a result. Repeat to add more categories. A category already in the selected list is marked Added and cannot be selected twice.

Set the storefront order

Use Move up and Move down on each selected category. Use Remove to take one out; the remaining cards keep their displayed order.

Save and publish

Save and publish the page, then confirm that each category card opens the intended catalogue category in the same order shown in the editor.

Why did older placeholder categories disappear?

Older sections can contain placeholder category IDs in their legacy Categories list. Remove those placeholder rows, then choose real records with Add category. Once the catalogue-backed picker has selections, it becomes the rendered source, so customers see only those real selections in the order you set.

Add decorations to Shop by Category

Select the section, switch the inspector to the Design lens, and expand Decorations. Add decoration creates a row with Shape, Color, Horizontal position and Vertical position (0 to 100), Size, Opacity, and Parallax intensity (both 0 to 1). Every field carries its own visible label and the fields sit in a two-column grid sized for the narrow inspector rail, so nothing is unlabelled or clipped. Each saved row has its own Remove action. Save and publish for the shapes to appear on the storefront. If none show, check the row's Opacity is above 0 and the Size is at least 1.

Shop by Concern — add concern tiles

Shop by Concern shows a row of tiles such as "Hair fall" or "Dry skin", each opening your product list filtered to the categories you attach to it. Until you add at least one tile the section has nothing to show.

Open the Concerns list

Go to Online Store → Store Editor, open the page, add or select Shop by concern (Library name; it is called Shop by Concern in this guide), then open Content → Concerns.

Add a tile

In the add row, fill Label (the name shown on the tile) and choose the Add button. A tile needs a Label to be recognisable in the list; the editor gives each new tile its own id for you.

Pick the picture

Set Illustration id to use one of the built-in illustrations (it is used when no custom image is set), or upload Custom image to show your own picture instead. Tile background colours the tile, and Shape offers Circle, Square, Rounded square and Pill.

Choose where the tile leads

In Categories shown on click, pick one or more catalogue categories. With categories chosen, a click opens the product list filtered to them; with none chosen the tile opens the unfiltered products page.

Optional finishing

Border color, Border width (0 to 12), Shadow (None, Subtle, Medium, Strong) and Hover tooltip refine each tile. Under Content → View all link, turn on Show "view all" link, then set Link text and Link target; both stay hidden until the switch is on. If no target is set the link goes to the concerns page.

Eyebrow, Heading and Subheading sit under Content → Heading. Column counts, gaps and tile size are Design-lens controls, not part of Content.

Why doesn't my Shop by Concern section show on the storefront?

A published section with an empty Concerns list is hidden from customers (the editor still shows it so you can fill it). Add a tile, save and publish. If a tile opens an unfiltered list, its Categories shown on click is empty.

Mega Category Grid — set the category tiles

Open Online Store → Store Editor, select the section (Library name Browse categories (grid)), then open the Content lens and the categories list. Use its add row to create a tile, fill the tile fields and choose Add. Tiles can show a custom label and image, and a size of small, medium or large in the bento layout.

Category id is a plain text box here

Unlike Shop by Category and Shop by Concern, this list has no catalogue picker: categoryId is a raw text input, and the editor does not look the value up for you. I could not verify any screen that displays a category's id to copy. In the current renderer the tile link is built from the tile's own id (/products?category= followed by that id) rather than from the categoryId field. After publishing, click every tile on the live storefront and confirm it opens the category you intended; if it does not, use Shop by Category (catalogue picker) instead.

Collection Showcase — Overlay Heading (cover-image overlay text)

Screen: Collection Showcase section → Content tab → Heading accordion.

The Heading accordion has two text fields, not one: Heading (the section's own heading, shown above the collection block) and Overlay Heading, right underneath it — the text shown on top of the cover image, inside the dark overlay next to the "Shop Collection" link. Before this control existed, the overlay always repeated the section Heading verbatim, with no way to word it differently (e.g. a shorter, punchier line for the image overlay than the section heading above it).

Leave it blank to keep the old behavior

Overlay Heading is optional. Leave it empty and the overlay keeps showing your Heading text, exactly as every Collection Showcase section already did — nothing changes on your storefront until you type something into this field.

The overlay (and so the Overlay Heading text) only renders at all when Show Cover Image is switched on in the Media accordion further down the same Content tab, with a Cover Image URL set. Cover Overlay Opacity (%) — also in the Media accordion — controls how dark the scrim behind the overlay text is (0 = transparent, 100 = fully dark).

Troubleshooting: I set an Overlay Heading but it's not showing

Check three things in order: (1) Show Cover Image is on and a Cover Image URL is set in the Media accordion — the overlay block, and everything in it, doesn't render at all without a cover image; (2) you're looking at the cover image itself, not the section heading above it — the two are separate pieces of text; (3) Cover Overlay Opacity isn't set to 0, which can make dark text hard to see against a light image (it doesn't hide the text, but very low opacity can make it hard to read against a busy photo).

Collection Showcase — products, decorations, and typography scale

Screen: Online Store → Landing Page Editor → select Collection Showcase → All settings. These paths and labels apply to the current Store Editor.

Choose a collection (Content → Products shown)

Open Collection to search your catalogue. Each result shows a second line such as 12 products; when the catalogue cannot supply a count, it says Product count unavailable. Pick a collection, choose its Live or Pinned mode, and set Number of products to cap how many matching products the section renders.

Confirm the saved selection shows a real name

Once picked, the field shows the collection's actual catalogue name, not its internal ID — the picker looks up your saved selection directly by ID rather than re-running your original search text, so it still resolves correctly after you close and reopen the section or reload the page.

Check for a manual product override

Products (manual list) takes priority over Collection. If the storefront still shows a hand-picked set after you choose a collection, remove those manual products; the section can then filter the catalogue to products in the selected collection.

Remove a decoration (Design → Decorations)

Expand Decorations. Add decoration sits on its own line under the fields, and the fields wrap to fit the narrow inspector, so none are clipped. It creates a row with Shape, Color, Horizontal position, Vertical position, Size, Opacity, and Parallax intensity. Every saved row has its own Remove action; click it to delete that one item, and after save and publish that decorative shape no longer renders on the section.

Scale the section type (Design → Typography scale)

Set Heading scale or Body scale from 0.5 to 3, in steps of 0.1. Heading scale changes the cover and product-card headings; Body scale changes the smaller supporting text on product cards.

Save, publish, and refresh

Review the resolved products, decorations, and type in the preview, then save and publish. Refresh the storefront to confirm the published section uses the same settings.

An existing Collection Showcase that never saved Heading scale or Body scale keeps its previous typography. Removing one decoration leaves every other decoration in place; removing all of them removes the decoration layer without changing the collection or product cards.

Why are the products, decoration, or scale unchanged?

For products, clear Products (manual list) and confirm the selected collection actually contains catalogue products. For a decoration, make sure you used the Remove action on that item's row, not a similarly named decorative-shapes control. For typography, change the fields inside Typography scale, then save, publish, and refresh the storefront.

Collection or product picker shows 'Couldn't load' instead of a name

This means the saved ID genuinely can't be found in your catalogue anymore — most often because the collection or product it pointed to was deleted, or it belongs to a different store. It is not a display glitch: the picker resolves saved selections directly against your catalogue by ID, so if the item still exists you'll see its real name. Open the picker and choose a current collection or product to replace the broken reference.

Collection Showcase image shape and fill

Select a Collection Showcase section, then open Design → Image treatment. The treatment includes these two controls:

ControlOptionsStorefront effect
Image ShapeDefault (section layout), Natural, Square 1:1, Portrait 4:5, Portrait 3:4, Landscape 4:3, Landscape 3:2, Widescreen 16:9Applies the selected proportions to the cover-image wrapper and every product-card image wrapper; Natural follows each source image's intrinsic proportions
How images fill the shapeFill shape, Fit insideApplies to the images inside those wrappers: Fill shape crops to fill, while Fit inside keeps the whole image visible

Choose one shape for the section

Pick an Image Shape. Use Default (section layout) to let the selected Collection Showcase layout supply its established frame, or Natural to let each cover or product image keep its own intrinsic proportions. A fixed ratio applies the same frame shape to the cover and product images.

Choose how every image fits

Set How images fill the shape to Fill shape or Fit inside, then save and publish the page.

An existing Collection Showcase keeps its previous storefront appearance until you change either control. The first time you reselect Image Shape or How images fill the shape, the section's currently saved shape and fill begin applying together; review both values before publishing. When you choose Natural, differently proportioned source images can produce differently tall frames.

Why didn't my Collection Showcase shape or fill change?

Reselect one of the two controls if the section existed before image shape and fill were connected, then check both saved values. A cover treatment is only visible when Show cover image is on and a Cover image is set; product-card treatment requires products with images. If Fit inside leaves space around an image, that is the expected result of preserving the whole source inside the chosen frame. Save, publish, and refresh the storefront after making the change.

Screen: Online Store → Landing Page Editor → Add section → Library, search "anchor" or "pill" for Pill Anchor Nav — a horizontally-scrolling row of pill-shaped jump links to other sections further down the same page (e.g. Reviews, Sizing, FAQ).

Add links (Content tab → Links group)

Click Add link for each jump target. Every link needs a Pill Label (the text on the pill) and a Target Section Anchor ID — the anchor id of the section you want it to scroll to. Getting the id right matters: the field's own helper text warns that a mistyped id makes the pill a silent no-op, not a broken link — clicking it simply does nothing rather than showing an error.

Set alignment and behavior (Layout tab → Display group)

Alignment (Left/Center/Right, default Center); Highlight the pill for the section in view (on by default) highlights whichever linked section is currently nearest the top of the viewport as the visitor scrolls; Stick to top of viewport on scroll (off by default) pins the nav bar in place — once it's on, a Sticky Offset (px) field appears so the pinned bar can sit below a fixed header instead of overlapping it.

Why don't my anchor pills scroll anywhere?

A pill only works if its Target Section Anchor ID exactly matches the id of a section actually on the page — there's no lookup or validation in the editor, so a typo just makes the click a no-op. With zero links added, the section shows a placeholder in the editor ("No links added yet.") but renders nothing at all on the live storefront — it doesn't appear as an empty bar.

Dynamic Showcase — Card Corner Radius

Screen: Dynamic Showcase section → Content tab → Display Style accordion → (below Items per Row).

Card Corner Radius sets the corner rounding for every product card the section renders, in either Grid or Carousel display mode: Square (0px — default), Small (4px), Medium (8px), Large (12px), or Extra Large (16px). It sits right under the Items per Row (Desktop) / Items per Row (Mobile) fields in the same accordion. Existing Dynamic Showcase sections default to Square (0px) — the historical look — so nothing changes for a page you built before this control shipped until you deliberately pick a rounder value.

Columns and filter chips on rows carried over from Featured Collection. A Dynamic Showcase row that was absorbed from a Featured Collection keeps that section's Columns (desktop and mobile) and Show filter chips values, and the storefront now honours them. In Grid mode the saved Columns set the number of cards per row, falling back to Items per Row when no Columns value exists. With Show filter chips on, the row shows an All / Sale / New chip bar above the cards: Sale and New narrow the product cards, and category cards always stay. Carousel mode (chosen, or reached automatically when the item count passes the switch threshold) still uses fixed card widths, so Columns does not change a carousel. If a carried-over row looks wider, narrower, or gained a chip bar after this change, that stored value is now being applied; change or clear that value to get the old look back.

Collection Tabs and Dynamic Showcase — product actions are opt-in

In the Store Editor, open either section, then open Product actions → Show add to cart buttons. The switch is off unless you explicitly turn it on. Save and publish after changing it.

When enabled, a simple product gets an add-to-cart action. A product with variants opens its product page instead so the customer can choose a variant. When the switch is off, the cards still navigate to their products but do not show a cart action. Category, collection, and testimonial cards never gain cart actions from this setting.

Why is there no Add to cart button?

Confirm you are in Online Store → Store Editor → open Collection Tabs or Dynamic Showcase → Product actions and changed Show add to cart buttons on the same section instance you published. The default is off. If just one product opens its product page when clicked, check whether that product has variants; variant selection cannot be skipped from the card.

Section controls newly reachable in the Store Editor

Six controls that the storefront renderers already read were not reachable in the v3 Store Editor. They are now. In each case open Online Store → Store Editor, pick the page, select the section, and use the lens named below (the Content or Design tab of the section's inspector). Save and publish afterwards; check the published page, not just the editor preview.

Collection List: Collection tile corner radius. Open Design → Image → Collection tile corner radius and pick None, XS, S, M, L, XL, Pill or Full. The radius rounds each collection tile. When it is set it wins over the Image group's own corner radius; when it is unset the tile keeps its previous rounding, so existing stores do not change. If the radius seems to do nothing, check whether the section's tiles show images at all, and remember that a value you set here overrides the other radius.

Collection Tabs: View all link. Open Content → View all link and turn on Show view all link. Two more fields appear only while the toggle is on: Link URL and Link text. Leave Link URL empty and the link goes to the active tab's collection page, or to /collections when that tab has no collection chosen. Leave Link text empty and it reads View All, or View All (N) when the tab has more products than its product limit shows (N is the tab's full product count); a Link text you type is used as written. The link appears under the products of the active tab, including a tab with no collection chosen. Once you have touched this group, its toggle is authoritative: switching it off hides the link on every tab, even one cut short by its product limit. A section that never touched this group keeps the older behaviour: no link unless a tab has a collection, and a tab cut short by its product limit shows the link on its own.

Why Us: Card description color. In the section's Cards group, open Card description color and choose a colour for the description line under each card's title. Leave it empty to keep the card's default description colour. If the colour does not change, confirm you are editing the description colour and not the heading colour, which is a separate setting.

Influencer Picks: name typography and heading color. Open Design → Influencer name typography. Influencer name color and Influencer name transform (Default, None, Uppercase, Lowercase, Capitalize) apply to the section's influencer names and to the quote line beneath them. Heading color is the more specific setting: when it is set it decides the colour of each influencer's name, and Influencer name color then colours the quote line. If only Influencer name color is set, it colours both. Leaving all three empty keeps the existing look. The transform changes only how the text is shown, not what you typed.

Popup Announcement: Open button link in. Open Content → Content details → Open button link in and choose Same tab (the default) or New tab. New tab opens the popup button's link in a new browser tab and keeps the shopper's current page open behind it. The choice only matters when the popup has a button with a link; a popup without one shows nothing to open.

Referral Program: full setup. Open the Referral Program section in the Store Editor. Reward, copy, link and share settings are under Content → Content details; Background image is under Design → Layout.

  1. Set the reward. In Content → Content details, choose Reward type: Percent off, Flat amount, Free product or Points. Percent off is what the field shows when no type has been saved. Then enter Reward amount, the number shown in the reward, such as 15 for 15% off or 100 for 100 points. Reward amount is hidden for Free product. For Flat amount, Reward currency symbol appears; type $, or leave it empty to keep ₹.
  2. Add your own reward (optional). Your reward for referring has its own Reward type (Percent off, Flat amount, Points) and Reward amount. Once an amount is set, the pill adds "you get N back" after the friend's reward (a percent adds %, points add pts, a flat amount adds no symbol). Leave the amount empty to hide it.
  3. Set the button and link. Button text replaces the main button's label; leave it empty to use Copy link button label, which also names the Copy link share button and defaults to "Copy Link". Default referral link is the base URL that gets copied and shared.
  4. Edit the steps. How it works steps is a list: each step has Step number, Title, Description and Icon. Leave the list empty to show the three default steps ("Share your link", "They shop", "You earn").
  5. Choose share buttons. Switch on any of WhatsApp, Email, SMS, X (Twitter), Facebook and Copy link under Share buttons. With all six off, the section shows WhatsApp, Email and Copy link.
  6. Optional extras. Show QR code adds a Show QR code button; the code is fetched only when the shopper clicks it. Show leaderboard reveals Leaderboard title (empty means "Top Referrers") and Leaderboard rows (1 to 10, default 3). Under Design → Layout, Background image sets the section background.
  7. Save and publish.

What customers see in the reward pill ("Give your friends ..."), per type:

  • Percent off shows the amount followed by % off, for example "15% off".
  • Flat amount shows the symbol then the amount, for example "$100".
  • Points shows the amount followed by points, for example "100 points".
  • Free product shows "a free product" and ignores the amount.

The main button and the Copy link share button copy the link; the other share buttons open WhatsApp, X, Facebook, the mail app or the messages app with the reward text and link filled in.

Edge cases:

  • If no Reward type has been saved and there is no stored reward amount, the reward pill is not rendered at all. A chosen type with no amount renders ? in place of the number.
  • In the editor preview the buttons are disabled, the QR code is never shown and the link is a sample, so test them on the published page.
  • The leaderboard does not list real referrers; it shows a placeholder message sized to Leaderboard rows.

Reward or buttons look wrong on the storefront?

A Referral Program added from the library starts as Flat amount. An older section that never saved a Reward type shows Percent off in the field and renders its stored number as a percentage, so a stored 200 reads "200% off"; pick the type you intend and publish. Reward currency symbol is missing when Reward type is not Flat amount, Leaderboard title and Leaderboard rows are missing until Show leaderboard is on, and no QR code appears until Show QR code is on and the shopper clicks the button.

Why does my change not show for customers?

Check that you saved and published the same section instance, and that the control is one that appears for your layout (the Link URL and Link text fields hide until Show view all link is on, and Reward currency symbol hides unless Reward type is Flat amount). Colour and radius controls left empty change nothing by design.

Social-proof sections

Trust-building blocks: press mentions ("As Seen In" logos), influencer picks, and a stats counter ("10,000 orders shipped"). Customer reviews and video testimonials, certifications and guarantee badges, and a UGC/Instagram photo wall are also covered — by the Testimonial Rich Carousel, Trust Badges, and Customer Photo Wall sections below, not by dedicated cards of their own; see the callouts further down this section for exactly what moved where.

A separate, premium option — the Testimonial Rich Carousel, with avatars, star ratings, and verified-badge quotes — auto-advances when its own Autoplay setting is on and there's more than one testimonial. Whenever it's auto-advancing, it carries the same visible, keyboard- and touch-operable pause/play control described above, per WCAG 2.2.2.

Screen: Online Store → Store Editor → open Testimonial Rich Carousel → Review source.

Set Source to Manual testimonials to keep editing the section's own testimonial items, or choose Store reviews to use published customer reviews. With Store reviews selected, Review filters appears. Configure:

  • Minimum rating — include only reviews at or above that rating, from 1 to 5.
  • Review limit — the maximum number shown, from 1 to 50.
  • Sort — Top rated or Most recent.
  • Only reviews with images — exclude text-only reviews when on.
  • Product (optional) — choose a catalogue product to restrict the source to its reviews. Its selected row uses the same Live or Pinned control as other Store Editor entity pickers.

The public source returns approved reviews only. Storefront cards may show a shortened customer name, verified-buyer status when the review belongs to an order, and review images in their saved order. Customer contact details, order details, and moderation data are not exposed.

Why don't customers see the reviews I expected?

Confirm Source is Store reviews, lower Minimum rating, turn off Only reviews with images, and clear or correct Product (optional). A pending or rejected review is never shown publicly. Also check Review limit and the selected sort order before treating a shorter list as missing data.

Custom storefronts can request GET /api/v1/customer/public/products/reviews with minRating, limit, sort, withImages, and an optional productId. The default limit is 12 and the maximum is 50; the response includes total and limit metadata. Each row uses the same safe public DTO as a product's review response: verifiedBuyer, customerDisplayName, and ordered images entries shaped as { url, sortOrder }, without customer or order identifiers.

Screen: Online Store → Store Editor → open Testimonial Rich Carousel → Testimonials.

Nothing is invented. The section only ever shows testimonials you entered (or approved store reviews). The Full bleed collage, Stacked deck, and Bento mosaic layouts used to pad a short list with made-up people; they no longer do.

  • On your published storefront, a Full bleed collage, Stacked deck, or Bento mosaic section with no testimonials renders nothing at all — no heading, no empty box. The section is simply hidden.
  • Inside the Store Editor, the same section shows a dashed placeholder that reads No testimonials yet — add some in the Testimonials group, so you can still see and select it. Open the Testimonials group in the inspector and add an item (Quote, Name, optional Role or location, Photo, Rating, Source, Date).

The Verified Buyer marker is shown only for testimonials that are genuinely verified:

  • Verified Buyer (in the card footer or under the author, depending on Card style) or Verified • (before the product name when a product link is shown) appears only when that testimonial is marked as a verified buyer.
  • You can't tick this by hand. The Testimonials items have no Verified field, so a manually entered testimonial never shows the badge. Verification comes from the Store reviews source: set Review source → Source to Store reviews (see the previous section) and a review shows the badge when it was matched to a purchase. A review that came in through a bulk import is never badged, whatever its other data says.
  • A testimonial with no verification information shows no badge — it is no longer treated as verified by default.

Why don't customers see the Verified Buyer badge?

Check, in order: Source is Store reviews (manual testimonials can't carry the badge); the review was matched to a purchase of the product; the review was not imported; and the section's Card style is one that displays it. Reviews written without a matching purchase correctly show no badge.

Why did my testimonials section disappear?

If the storefront section vanished, it has no testimonials to show: the Testimonials list is empty (or Store reviews returned nothing for your filters) and the layout is Full bleed collage, Stacked deck, or Bento mosaic. In the Store Editor you will still see the No testimonials yet placeholder. Add at least one testimonial, or loosen the Review filters, and republish.

Why are some testimonials missing on a Refined section?

On a Refined Testimonial Rich Carousel, the live store hides any testimonial that has neither a quote nor a video. If none of the testimonials has a quote or video, the whole section renders nothing, in every layout. The Store Editor still lists every row so you can fill them in. Add a Quote (or a video) to each testimonial and republish.

Customer Reviews and Video Testimonials are now looks of Testimonial Rich Carousel

Both have been retired from + Add Section and folded into Testimonial Rich Carousel. If a page you built before has a Customer Reviews or Video Testimonials section, it's untouched — it still renders and still opens in its own editor exactly as before; you just can't add a new one from the library. For a new page, add Testimonial Rich Carousel instead:

  • For the old Customer Reviews card look, set its Card style (in the Cards group) to Standard Clean, Bubble, Minimal Quotes, Product Focused, or Magazine Editorial — these five values were ported directly from Customer Reviews' own variant picker.
  • For the old Video Testimonials tap-to-play video grid, set Layout to Video Grid.

A Customer Reviews section you already have follows the same rule as above: its Verified • and Purchased markers and the green verified tick appear only on reviews matched to a purchase and not imported. Reviews with no purchase information no longer show them.

With the Full bleed collage or Stacked deck layout, the storefront shows exactly the testimonials you have: one testimonial shows one card, and no invented names or quotes fill empty slots. The storefront never pads the layout with placeholder testimonials, so one or two real testimonials render as one or two cards (the collage and deck lay out at most three). A section with none shows nothing on the published page (the editor shows a placeholder).

Open the section's Layout tab for two additional controls beyond the Layout/Card style/Show Avatars/Show Ratings/Autoplay group.

Side-by-side heading (optional, works with any Layout)

Turn on Side-by-side heading (heading in a left column, content to the right) to move the section's heading into its own left-hand column, with the testimonials to the right, instead of sitting above them. This switch is independent of the Layout dropdown — it's available whether Layout is set to Carousel, Grid, or any of the five premium archetypes (Numbered Index, Editorial Overlap, Kinetic Marquee, Full Bleed Collage, Stacked Deck). Leave it off for the default stacked heading (heading above the testimonials, every existing store's current look).

Carousel layout group (only when Layout = Carousel)

With Layout set to Carousel (the default), a Carousel layout group appears below Autoplay / Pause on Hover / Auto-advance interval with four controls:

  • Card display — Whole cards (default) shows each testimonial card in full; Peek (partial cards at the edges) lets the neighbouring cards bleed in from both edges, hinting there's more to scroll through.
  • Peek amount — only shown once Card display is set to Peek. Choose Small, Medium (default), or Large for how much of the neighbouring cards shows at each edge.
  • Show arrows — on by default; toggles the left/right navigation arrows.
  • Show dots — on by default; toggles the pagination dots below the carousel.

Why don't I see the Peek amount / Card display controls?

The Carousel layout group (Card display, Peek amount, Show arrows, Show dots) only renders when Layout is set to Carousel — it's hidden, not just disabled, for Grid and the five premium archetype layouts (Numbered Index, Editorial Overlap, Kinetic Marquee, Full Bleed Collage, Stacked Deck), since peek/arrows/dots have no meaning for those non-carousel layouts. Switch Layout back to Carousel to bring the group back with whatever values you last set.

Instagram Feed and UGC Gallery — retired from + Add Section, still fully editable

Both have been folded into Customer Photo Wall for new sections (see the callout below), but if your page already has an Instagram Feed or UGC Gallery section, none of that changes for it — it keeps rendering, and the field-level controls described in this subsection and the next still apply whenever you open that existing section to edit it.

Instagram Feed (Content tab → Instagram Feed group) now has two tile-image controls: an Image Corner Radius (px) field (0–48) and an Image Shadow toggle, both applying to every tile in the grid or carousel. UGC Gallery gets its own Tile Style group, but on the Style tab rather than Content — background, shadow, and hover-effect controls for its photo tiles, the same shared style editor used elsewhere in the library. Influencer Picks' Heading group has a new Show Subheading toggle (on by default); switching it off hides the subheading text entirely rather than just leaving the field blank.

Press Mentions — logo height and logo-only layouts

Screen: Online Store → Store Editor → open Press Mentions.

With the Logo bar or Ticker layout (Logo bar is the default when no layout is chosen), logos are capped at 32 pixels tall unless you change it. In the Logo style group, Logo max height is a slider from 16 to 160 pixels in steps of 4 pixels. The slider is hidden on the other layouts ("Only used with the Logo bar and Ticker layouts"). Logos on the logo-only layouts also sit at full strength on hover instead of a permanently faded look.

On those two layouts there is no quote to show, so each mention's Quote color (overrides section default) and Accent color fields are hidden. They reappear on the quote layouts.

My press logos are tiny

Raise Logo max height under Logo style. If you do not see the slider, check that Layout is Logo bar or Ticker; other layouts size their logos separately and ignore it.

Press Mentions & Instagram Feed — Card Appearance

In the older editor both sections have a Card Appearance accordion on the Style tab. In the current Store Editor, Press Mentions has Design → Quote style → Card style (Card background, Border color, Border width, Corner radius, Shadow, Hover effect), shown only on the Quotes carousel layout, and Instagram Feed has Design → Tile style → Tile card with just Tile background and Tile hover effect (None, Lift, Zoom, Brighten, Glow); border and shadow are not offered there. In the older editor on Instagram Feed it sits below the existing Show Dots / Auto Scroll switches. Press Mentions gets the full shared control set (background, border width/color/style/radius, shadow, hover) used across the library, applying to every quote card in its carousel or grid layouts (it has no effect on the ticker or logo-bar looks, since those don't render individual cards). Instagram Feed's panel is narrower — see below.

Instagram Feed — Border is an on/off switch, not the full control set

On Instagram Feed, Card Appearance's Background and Hover controls render exactly as set. Border shows only a Show border toggle with helper text underneath, instead of the width/color/radius fields Press Mentions and other sections get — turning it on renders a border, but its actual width, color, and radius still come from Instagram Feed's own pre-existing Tile Style / Image Corner Radius controls (Content tab), not from anything in Card Appearance. There's no Shadow control in this accordion at all on Instagram Feed — tile shadow is driven solely by the existing Image Shadow toggle (Content tab). To change how your Instagram tiles' border or shadow actually look, use those Content-tab fields; the Card Appearance accordion here only controls background, whether a border shows, and hover.

Customer Reviews — star colour and card look

Screen: Online Store → Landing Page Editor → select the Customer Reviews section → Design → Card look. Set Card background, Card border color, Card border width, Card corner radius and Card shadow (None, Soft, Medium, Bold). They apply to every review card.

Star color has no effect on the storefront

The Star color control is still shown, but a Customer Reviews section renders through the testimonial carousel, which does not read it, so changing it does not recolour the stars on your published page.

Controls that do nothing on Customer Reviews

Layout variant, Show photo and Show verified are stored on older Customer Reviews sections but the storefront never reads them, so the current editor does not offer them. Changing them in an older editor has no visible effect.

Customer Reviews — Image aspect ratio (existing sections)

This control applies to an existing Customer Reviews section — see the callout above the Testimonial Rich Carousel how-to for where this look now lives on new pages.

The customer-reviews carousel's Card Appearance accordion (Design tab → Image treatment group) has a Card aspect ratio field. Choose 1:1 (default), 3:4, 4:3, or 16:9 for the crop applied to each review's photo. It's read by the section's Variant A and Variant D layouts; if your Customer Reviews section is set to a layout that doesn't show reviewer photos at all, changing this field won't visibly do anything until you switch to a layout that does.

Customer Reviews — autoplay and reduced motion (existing sections)

For an existing Customer Reviews section, automatic movement is off when Scroll automatically has never been set. The control appears only when the section uses the Carousel layout.

Turn carousel autoplay on or off

Select the Customer Reviews section, open Content → Layout, and choose Carousel. Then open Content → Carousel → Scroll automatically. Turn it on to advance through multiple reviews, or turn it off to keep the current review in place until the visitor navigates.

Set the page motion preference

Open the page's Design → Motion control. Template default and Full allow the configured autoplay; Reduced and Off stop the automatic advance and remove the carousel's animated transitions.

Save, preview, and publish

Save the page and watch a carousel containing at least two reviews for longer than one advance interval. Publish only after the default and reduced-motion behavior match what you intended.

Visitors whose device or browser requests reduced motion get no automatic review advance, even when Scroll automatically is on. This follows the same pause-or-stop expectation documented by WCAG 2.2.2 for moving content.

Why aren't my Customer Reviews moving?

Confirm the section uses Carousel, contains more than one review, and has Scroll automatically on. Then check the page's Motion value. If those are enabled, the visitor's own reduce-motion preference can still stop auto-advance by design.

A further set rounds out trust-building: Trust Badges and a Press Logos Band (a second, simpler "As Seen In" strip alongside Press Mentions above), Social Links for follower counts and profile links, a Customer Photo Wall for UGC photos with @handle attribution, and a general-purpose Marquee / Ticker for any continuously scrolling strip of brands, logos, images, or announcements — a Marquee Style control switches it between a text ticker, a scrolling logo bar, and a scrolling image strip. Logo Marquee and Image Marquee, previously two separate cards here, are now looks of this one Marquee section — see the how-to right below.

Certifications and Guarantee Banner are now looks of Trust Badges

Both have been retired from + Add Section and folded into Trust Badges above. If a page you built before has a Certifications or Guarantee Banner section, it's untouched. For a new page, add Trust Badges instead and set its Display Style (Content tab) to Ticker (Scrolling) for the old Certifications look, or Guarantee (Single Featured Badge) for the old Guarantee Banner look.

Trust Badges — hover effect (Card Grid look only)

Trust Badges' Content tab has a Card style group with a Hover effect dropdown (None, Zoom, Lift, Brighten, Glow).

This group only affects the Card Grid look — open Trust Badges' Layout tab and switch its variant picker to the Card Grid option first. On any other variant the Hover effect won't change anything on the storefront. Trust Badges has no transition-duration control: an older Transition (ms) value saved on a section is not read by the storefront and changes nothing.

Trust Badges and Guarantee Banner — what to put in the icon field

Each badge in Trust Badges has its own icon field. Screen: Store Editor → open the page → select the Trust Badges section → Content tab → Badges group → open a badge → Icon name. Badge image and Badge image (mobile), just below it, take an uploaded picture instead.

  1. In Icon name, type an icon id, such as VerifiedUser. This is the safe choice on every store: the storefront draws the matching line icon, and an id it does not recognise draws a check mark instead of the word.
  2. To use your own artwork instead, use Badge image (or paste an image URL in Icon name). The picture shows in place of an icon.
  3. Publish, then reload the live store to see it.

Emoji only work on classic looks

On the classic looks an emoji typed in Icon name shows as typed. The refreshed 2026 designs replace it with a generic check mark. On the 2026 designs, also, text with spaces such as "Verified User" is matched to an icon rather than printed. If you are not sure which design a section uses, use an icon id or a badge image, which look right on both.

This applies to Trust Badges, including its Guarantee (Single Featured Badge) look, and to an older Guarantee Banner section already on a page.

Icon shows as a word?

Earlier, an icon id typed into this field printed on the storefront as plain text (for example the word VerifiedUser). That is fixed for every store, old and new, and needs no action from you. If a word still appears, hard refresh the page and check the field holds a single word with no spaces.

Instagram Feed and UGC Gallery are now looks of Customer Photo Wall

Both have been retired from + Add Section and folded into Customer Photo Wall above. If a page you built before has an Instagram Feed or UGC Gallery section, it's untouched — see the tip earlier in this section for its own field docs. For a new page, add Customer Photo Wall instead and set its Source (Content tab) to Instagram Account for the old Instagram Feed behaviour, or Hashtag for the old UGC Gallery behaviour; Customer Photo Wall's own Layout picker (Grid, Masonry, Filmstrip, Editorial, Spotlight) then controls the tile arrangement.

Logo Marquee and Image Marquee are now looks of Marquee / Ticker

+ Add Section shows one Marquee / Ticker card for this family, not three separate cards. Click it and it adds the plain ticker look, same as before. To get the logo-strip or image-strip look instead, look for the small variant chips under the card — Logo Scroll and Image Scroll — and click one of those; each inserts a Marquee section already set to that look, so you don't have to switch it by hand afterward. Searching "logo marquee" or "image marquee" still finds this card (with the matching chip called out), so nothing you used to search for stopped working. Any page that already has a Logo Marquee or Image Marquee section from before keeps rendering exactly as it did — this only changes how you add a NEW one.

Instagram Feed (Auto-Sync) — retired from + Add Section

A second Instagram section type, Instagram Feed (Auto-Sync), layered grid/masonry/filmstrip layouts and a lightbox on top of the plain Instagram Feed above, but its storefront side was never switched on — it rendered nothing for real visitors, since the Instagram API connection it needed was never wired up on the backend. It's been retired from + Add Section for that reason (no store had one in use). Use the plain Instagram Feed look inside Customer Photo Wall — see the callout above — if you want something visitors can actually see today.

Content Slider — cards and their button

Screen: Online Store → Landing Page Editor → select the Content Slider section → Content → Cards. A new Content Slider starts with three titled example cards to replace. Each card has Title, Body, Icon, Accent color, Button text and Button link. Playback, navigation and Cards per view (Desktop, Tablet, Mobile) are in their own Content groups.

  1. Type Button text. The card also saves an empty Button link so the pair stays complete.
  2. Type Button link.
  3. Publish. The button shows on the storefront only when both are filled; a card with only one of them shows no button (a text-only button would be unnamed and a link-only button would have no label).

Troubleshooting: if a card's button is missing, fill the other half and check neither is blank or only spaces.

Compatibility Checker — devices and example data

Screen: Online Store → Landing Page Editor → select the Compatibility Checker section → Content. Devices holds Compatible devices, Incompatible devices and Max visible tags; Display style offers Finder, Matrix and Wizard; Product categories and Compatibility matrix (pairs of products with a status and optional note) feed the other styles. A newly added section starts with three example compatible models and two incompatible ones; replace them with your real device names. On Refined, the Not Compatible panel is hidden when you list no incompatible devices.

Troubleshooting: if the search finds nothing for a device, add its exact name to Compatible devices; names are matched as written.

Marquee — Text Ticker, Logo bar & Image strip looks

Screen: Online Store → Landing Page Editor → Add section → Library, then search or scroll to Marquee / Ticker. Logo Marquee and Image Marquee no longer have their own cards here — they're now looks of this one Marquee section, picked with the Marquee Style control inside it. If you already had a Logo Marquee or Image Marquee section on a page before this change, it's untouched: it still renders exactly as before, and clicking it to edit it opens this same Marquee editor with Marquee Style already set to match (Logo bar or Image strip).

Items (Content tab → Items group)

Add, reorder, and remove the strip's items here regardless of style. Each item is either Text or Image — switch between the two with the toggle in the item's expanded row. Image items get their own Image size (S/M/L/Custom, with a Custom size (px) field when set to Custom), Shadow (None/Subtle/Medium/Strong) and Caption controls (Caption also shows on Logo rows); a Text row hides those image-only fields. Every row keeps Content, Alt text and Link URL. The row switch is labelled Item type (Text, Image, Logo). At least one item is required — the list won't let you remove the last one.

Marquee Style (Content tab → Marquee Style group)

The Style dropdown picks the look:

  • Text Ticker — the original continuously-scrolling text/logo strip (the default when the field has never been set).
  • Logo bar — the former Logo Marquee look, with logo-specific controls (below).
  • Image strip — the former Image Marquee look, with image-strip-specific controls (below).

Switching Style on an existing section only changes which of the two style-specific control groups below appears and which renderer draws the strip — your Items list is not touched.

Logo bar controls (Style = Logo bar)

  • Logo Height (px) — 16 to 160, defaults to 40.
  • Greyscale Logos (colour on hover) — off by default; when on, logos render in greyscale and regain full colour on hover.
  • Frosted Glass Background — off by default; applies a blur behind the strip.
  • Edge Fade — on by default; fades the strip's left/right edges instead of a hard cut.
  • Edge Fade Width (%) — 0 to 40, defaults to 10; only meaningful while Edge Fade is on.
  • Heading — an optional label shown above the strip (shared with Image strip; hidden entirely when Style is Text Ticker).

Image strip controls (Style = Image strip)

  • Image Height (px) — 40 to 400, defaults to 120.
  • Show Captions — off by default; shows each image's caption underneath it when the item has one.
  • Duplicate Images for Seamless Loop — on by default; renders the item list twice back-to-back so the scroll never shows a visible seam. Turn it off only if you have enough items that the loop already looks continuous.
  • Section Padding — None/Small/Medium/Large, defaults to Small.
  • Reduced-Motion Fallback — Show as a static grid (default) or Hide the section. See the troubleshooting note below for what each does.
  • Heading — same shared field as Logo bar, above.

Settings (Content tab → Settings group, applies to all three styles)

Marquee Height (px) (container height; preset image sizes scale relative to it), Text Size (px) (font size for text items), Gap Between Items (px), Direction (Left/Right), Speed (seconds), Pause on Hover, Edge Fade Effect (the Text Ticker's own edge-fade toggle — a separate field from Logo bar's Edge Fade above, since the two styles render through different code paths), and Separator Between Items (None/Dot/Pipe/Star/Dash — visible on Text Ticker items).

Colors (Content tab → Colors group)

Background Color (defaults to black) and Text Color (defaults to white) — shared across all three styles.

Why don't I see Logo Marquee in the library anymore?

It's not missing — add a Marquee section instead and set Marquee Style to Logo bar (Content tab → Marquee Style group) to get the same scrolling logo strip, with the same Logo Height, Greyscale, Frosted Glass, and Edge Fade controls described below. Any page that already had a Logo Marquee or Image Marquee section keeps rendering and working exactly as before — those existing sections just open in the Marquee editor now instead of a dedicated one, with their items, colors, and settings carried over unchanged.

Empty logo bar / reduced-motion behavior

A Logo bar section with no logo items shows a dashed placeholder ("Add logos to display marquee") while you're editing, and renders nothing at all for storefront visitors until you add at least one logo. For Image strip, if a visitor's device has Reduce Motion turned on, the strip never animates: with Reduced-Motion Fallback set to Show as a static grid (the default) it lays the images out in a static wrapped grid instead of scrolling them; set to Hide the section, it renders nothing at all for that visitor.

Content & brand-story sections

Sections for telling your story rather than selling directly: an FAQ accordion, a "how it works" numbered-steps block, a before/after image comparison, blog-post previews, a founder-story block, a brand timeline, and a split brand-story layout with image and text.

In the split brand-story layout, the Description field (Content tab → Body group) now always updates the paragraph text under your Subheading — any brand-story section still shows exactly what you last typed there.

FAQ's Heading group gained an Eyebrow Text field (a plain label line above the FAQ heading), and a separate Heading Style group below the questions list gives you a full typography editor — Font Weight, Size, alignment, bold/italic/underline, and a Color swatch — for the heading text.

FAQ Heading Style — only Color actually changes the page

Of the Heading Style group's controls, the FAQ section currently only applies the Color swatch to the rendered heading. Font Weight, Size, and alignment are shown and save correctly, but the FAQ renderer doesn't read them yet — changing them won't visibly change anything on your storefront.

FAQ — Item Appearance & Question/Answer Style

In Store Editor v3, open the FAQ section's Design tab and use the Question & Answer Style group (Design → Question & Answer Style) for the item colours. The v3 swatch labels are sentence case: Item background, Active item background, Question color, Answer color and Icon color. In the older editor the same accordions sit on the section's Style tab, below the shared Decorative Shapes accordion (see Decorative shapes further down this page). Together they shape how each question-and-answer row looks, separate from the Heading Style group.

Item Appearance — the shared per-item card controls (background, border, shadow, hover effect, and so on) applied to every FAQ row.

Card Style — five fields that target the FAQ row's own container, independent of Item Appearance: Background Color, Border Width, Border Radius, Border Color, and Shadow. Before this update these were declared in the FAQ schema and the renderer already read them, but no editor control could reach them — a merchant could only set them by hand-editing the page JSON.

Question & Answer Style — five color swatches (Item Background, Active Item Background, Question Color, Answer Color, Icon Color, each with a Solid/Gradient fill toggle) plus a Question Style and an Answer Style typography group. Each typography group exposes four fields — Style (Normal/Italic), Text align, Decoration (None/Underline/Strikethrough), and Text transform — scoped to just those four; Font Family, Font Weight, Color, Line Height, and Letter Spacing aren't shown here because the FAQ renderer doesn't read them off this field (color for the question/answer text is the separate swatch above, not this typography group). Leaving every field in this accordion untouched renders byte-identical to before — every field falls back to the section's existing item-appearance/typography values.

Question Size lives under Item Appearance, not here

A Question Size field (pixels, applies to the question text only) sits at the bottom of the Item Appearance accordion above — it's a distinct, older control from the Question Style typography group's own font-size handling, which applies to both question and answer.

FAQ hover effect, hover transition and question images

Item hover effect (Design → Question & Answer Style) offers None, Lift, Zoom, Brighten and Glow and applies to every FAQ row. Hover transition (ms) (0 to 2000, steps of 50, storefront default 200) appears only after you pick an effect other than None; with None selected the field stays hidden because the storefront ignores it. For a question image, open a question under Content → Questions and fill the Image pair (image and Alt text). Questions inside a category (Content → Categories) now show the same image controls. They are hidden when the section is on the Editorial preset or the List layout, because neither draws a question image. Show category filter chips (Categories group, flat list only) adds an All chip plus one chip per question category; an older FAQ that stored the same setting under its previous key shows it instead as Show category filter chips (legacy rows), an alias for the same setting, and only while that older key is set. Use whichever one the editor shows. Troubleshooting: if a question image does not appear on the storefront, check that Layout is not List and the Editorial preset is off.

There's also a plain Slideshow for a mid-page image sequence, separate from the sections above. Turn on its own Autoplay setting with more than one slide and it, too, carries the same visible, keyboard- and touch-operable pause/play control, per WCAG 2.2.2.

A longer list of general content blocks fills out the rest of the library. Storytelling and value-proposition blocks: Why Choose Us (icon-plus-text value props), an Ingredient Spotlight with hotspot annotations on a product image, a Sustainability Story with eco-impact stats, a full-screen Story Mode for sequential narrative slides — see the full control breakdown further down this page — and a second Blog Posts grid/carousel (with excerpts and dates) alongside Blog Preview above.

Layout and media blocks: Multi-Column and Alternating Columns for flexible or side-alternating image-and-text rows, an Image Gallery with a lightbox (its asymmetric collage and mosaic looks live inside this one card now — see the callout under Content & brand-story sections below), a Content Slider of generic content cards, a Headline Collision for an oversized, layered-typography headline, a Rich Text freeform block, a Custom HTML / Embed for pasting third-party widgets or iframes, an Ingredient Table and a Size Chart for detailed tabular information, and a Store Locator map for physical locations.

Sustainability Story — stacking on phones and certification logo colours

Screen: Online Store → Store Editor → open Sustainability Story.

  • Stacking on phones. With Layout preset set to Image left or Image right, the image and text now stack vertically on phones (below 768 pixels wide) instead of staying side by side in a squeezed row. From 768 pixels up the two-column layout is kept, with the image on the side you chose.
  • Logo colours. In the Certifications group, Logo colours chooses how certification logos are painted: White silhouette (the default) or Original colours. The helper text says white silhouette suits transparent logos and Original colours suits logos with a solid background. The control only appears when Layout preset is Full-bleed overlay, because the other layouts do not paint logos as silhouettes.

My certification logos are white boxes

The overlay layout turns every logo into a white silhouette, so a JPG or a PNG with a white background becomes a solid white tile. Open Certifications, set Logo colours to Original colours, and each logo keeps its own colours, shown on a small white chip.

Sustainability Story — stats row

Screen: Online Store → Store Editor → open Sustainability Story → Stats.

Add your stats

Open Stats and add an item per figure. Each has Label, Value (shown as typed, for example "60%"), Numeric value (for count-up), Suffix, and Icon. Fill Numeric value (for count-up) if you want the number to count up from zero when it scrolls into view; leave it blank for a static figure. Customers who prefer reduced motion see the final value straight away.

Type a unit in Suffix, for example "%" or "kg", and the storefront appends it straight after the number: Value "60" with Suffix "%" shows "60%". If Value already ends with the same text ("60%" with Suffix "%"), it is not doubled. Leave Suffix empty and the figure shows exactly as typed in Value. The suffix applies in every layout: the count-up figure in Image left and Image right, and the static figures in Full-bleed overlay.

A Suffix that is a word of two or more letters, such as "years" or "habits", is treated as a unit: it appears beside the number in a smaller, medium-weight type instead of wrapping under it at full figure size. Symbol suffixes such as "%", "+" or "k" stay attached to the number at the same size.

Pick the layout

Under Media, Layout is Image left, Image right, or Full-bleed overlay.

In Image left and Image right, a section with exactly three stats shows them in a single row of three; one, two, or four or more stats sit in two columns. In Full-bleed overlay, stats show two columns on a phone and three from tablet width up. The small uppercase stat labels use a slightly darker shade of your accent colour so they stay readable against the section background.

Why are my stats in two columns?

The three-in-a-row look applies only to a count of exactly three in the Image left / Image right layouts. Add or remove a stat to reach three, or switch the layout.

Ingredient Table — enter ingredients by hand

Screen: Online Store → Store Editor → page → Ingredient Table → Content. Parts open in this order: Heading, Ingredients, Ingredient groups, Table.

Add each ingredient

Open Ingredients. In the add row fill any of Name, INCI name, Purpose, Concentration, Origin and Certifications (a list: add one entry per certificate), tick Highlight this ingredient to feature it, then choose Add. Each row is listed under its Name.

Choose the visible columns

Under Table → Columns switch on the columns customers should see: Name, INCI, Purpose, Concentration, Origin, Certifications. A column left off is hidden for every row, even if you filled it in.

Group ingredients (optional)

Turn on Ingredient groups → Group ingredients. The Groups list then appears: add a Group name and Collapsed by default per group. To place an ingredient in a group, type that group's id into the ingredient's Group id. Ingredients with no group, or an unknown id, are listed separately after the groups.

Table behaviour

Under Table: Sortable columns and Keep first column visible when scrolling are on by default; Show search box and Show highlighted ingredients control the search field and highlighting; Disclaimer adds a note under the table. Heading and Subheading are in Heading.

Why doesn't my ingredient table show?

With an empty Ingredients list the section is hidden on the storefront. If rows exist but a column is blank, check Table → Columns. If grouping does nothing, Group ingredients is off or the Group id does not match a group. This guide cannot confirm how the editor shows the id of a new group; check it in the preview after adding.

Size Chart — enter size rows by hand

Screen: Online Store → Store Editor → page → Size Chart → Content. Parts: Heading, Size rows, Columns & units, Fit guide, Table style. This is the section's own chart, separate from the per-product size chart in Specifications and size chart.

Add one row per size

Open Size rows. The add row has Size (e.g. S, M, 32) plus eight measurement boxes: Chest (cm), Waist (cm), Hips (cm), Length (cm) and the same four in (in). Fill both the cm and inch boxes, then choose Add.

Pick the columns and starting unit

In Columns & units → Measurement columns switch on any of Chest, Waist, Hips, Length (all four start on). Starting unit is cm or in; Show cm / in toggle (on by default) lets shoppers switch.

Fit guide and table style

Turn on Show fit guide text to reveal Fit guide text. Keep size column visible when scrolling (on by default) and Highlight header row are in Table style. Eyebrow and Heading are in Heading.

Why doesn't my size chart show rows or values?

A cell shows a dash when that measurement box is empty for the unit the shopper is viewing, so a row with only cm values shows dashes after the shopper switches to inches. A measurement column that is switched off in Measurement columns is not drawn at all. Column headings are fixed to Chest, Waist, Hips and Length; custom column names are not available. I could not verify what a chart with no rows looks like on the storefront, so confirm in the preview.

Use these settings to align each location card and colour its Featured badge without changing your store names, addresses, map or search settings.

Screen: Online Store → Pages → Landing → Store Locator → Design in the Store Editor. Select the section in the outline before opening Design.

Choose a component look

In Design, choose a component look, such as a Button look, before adjusting the location cards. The location-card alignment and badge colours apply with a selected component look; changing only the section heading's look does not turn them on.

Align the location cards

Open Layout and use Text alignment: Left, Center or Right. This aligns the location-card text and positions the featured badge on the same side. The heading above the location list is separate. With no saved alignment, the styled cards use Center. Opening the control does not save that default as a new choice.

The existing Default view stays in Layout; Space around section is in Design → Spacing. Text alignment does not change whether you show a list, map or split view.

Colour featured badges

In Content → Locations, mark the locations you want to highlight as Featured store. Then open Design → Featured badge. Background color changes the badge fill; Text color changes its text and star. Use the colour swatch or type a colour in the adjacent field, then leave the field to apply it.

With no saved badge colours, the background is transparent and the text follows the store's light/dark text colour. Only featured locations have a badge. These settings do not colour the whole location card or create a badge on an unfeatured location.

Check the draft and save

Check a featured location in the preview, then Save your draft. Switching tabs or editing a badge colour keeps the other location-card settings. Saving a draft does not publish your page; customers continue to see the last published version until you publish separately.

Why don't the alignment or badge colours change? First select a component look in Design; the classic location-card appearance does not use these settings. For badge colours, also check that at least one location is marked Featured store. If the draft preview is correct but customers still see the old appearance, check that the page has been published after saving.

Calculator and Personalization Preview — text alignment

Select Calculator or Personalization Preview in the Store Editor outline, then open Design → Layout → Content layout → Text alignment. Choose Left, Center or Right to align the form or preview when a component look is selected. This does not rearrange the Calculator's inputs and result, or change the text placement on a personalization image.

Without a new alignment choice, the control shows the previously saved style alignment, or Center if there is none. Opening Design does not save a new value. Choose a component look, check the preview, and Save the draft. The existing text-on-image alignment controls in Personalization Preview remain separate; use those to position text within the image.

FAQ (Rich) and Collapsible Content are no longer their own cards

Both have been folded into the plain FAQ section above. If a page you built before has a FAQ (Rich) or Collapsible Content section, it's untouched — it still renders and still opens in its own editor exactly as before; you just can't add a new one from the library. For a new page, add FAQ instead: its Layout dropdown (Content tab) now includes Two Column and Split, which reproduce FAQ (Rich)'s categorized, richer look; the default Accordion layout covers the same general expand/collapse behaviour Collapsible Content provided, though there's no dedicated "Collapsible Content" preset inside FAQ yet.

Collage Mosaic and Image Collage are now looks of Image Gallery

+ Add Section shows one Image Gallery card for this family, not three separate cards. Click it to add the plain lightbox gallery, or use the Collage Mosaic / Image Collage variant chips under the card to insert an Image Gallery section already set to that asymmetric layout — the same pattern as Marquee / Ticker's Logo Scroll and Image Scroll chips described under Social-proof sections below. Any page that already has a Collage Mosaic or Image Collage section from before keeps rendering exactly as it did; this only changes how you add a new one.

Three utility blocks round out Content: a Divider for a visible or invisible spacing break between sections, an Announcement Bar thin banner for site-wide notices, and a Maintenance Message block for a maintenance notice placed inline on a regular page — the dedicated offline experience with its own templates and countdown is a separate screen; see Maintenance Mode Page Editor.

Divider — visible styles & the invisible spacer

Screen: Online Store → Landing Page Editor → Add section → Library, search "divider" for Divider.

Divider Style picks what actually shows: Blank (spacing only) renders nothing visible — it's pure vertical space; Hairline is a thin rule; Ornamental flanks a small glyph (Ornament: Dot, Diamond, or Flourish) with two short bars; Gradient Fade is a soft gradient bar that fades to transparent at both ends. Height sets the block's overall height (Extra Small 8px through Extra Large 96px, or Custom to type an exact pixel value in the Custom Height (px) field that appears). Thickness and Color (Border/Accent/Muted/Inverse) only appear when Divider Style isn't Blank — a blank divider has nothing to thicken or color. Full-bleed (edge-to-edge) removes the divider's normal side padding and max-width so it spans the full browser width instead of matching the page's content column.

Blank divider looks invisible in the editor too — that's intentional

With Divider Style set to Blank, the editor shows a small label such as Spacer — 64px so you can still find and select it while building the page; the number follows the selected height. That label is editor-only and never appears on the live storefront, where a blank divider is genuinely invisible, just the spacing.

With Divider Style set to Blank, the editor shows a small "Spacer — {height}px" label so you can still find and select it while building the page — that label is editor-only and never appears on the live storefront, where a blank divider is genuinely invisible, just the spacing.

Story Mode — chapters, motion, and pinned scroll

Screen: Online Store → Landing Page Editor → Add section → Library, search "story" for Story Mode — a full-bleed sequence of narrative chapters (image + heading + body + optional CTA), for founder stories, product origin stories, or step-by-step brand narratives.

Add chapters (Content tab → Chapters group)

Click Add Chapter for each beat of the story. Every chapter has its own Heading, Body, Image, per-chapter Layout (Image Left, Image Right, Image Above, or Text Only), and an optional CTA Label + CTA URL pair — the CTA link only renders on the storefront once BOTH fields are filled in; filling in only one leaves both saved but neither shown.

Choose Presentation (Layout tab → Narrative Settings group)

Presentation picks how chapters play out: Stacked (default) shows each chapter as its own full block, one after another down the page, same as scrolling through any other section. Pinned Scroll (scrollytelling) pins the chapter's image in place while its text scrolls past — the image only advances to the next chapter's image once the visitor scrolls past that chapter's text. Pinning only activates at 768px viewport width and above; on narrower screens, Pinned Scroll falls back to the same normal, non-sticky flow as Stacked.

Set typography, motion, and spacing (Layout tab → Narrative Settings group)

Heading Style — Display (serif), Serif, or Sans-serif. Motion — None, Reveal Fade Up (default), Reveal Slide Left, or Reveal Stagger — controls how each chapter animates into view as the visitor scrolls to it. Section Padding — None, Small, Medium, or Large (default). Image corner radius — Default (theme), None (square), Small, Medium, Large, Extra large, or Pill.

Progress and snap toggles (Layout tab → Narrative Settings group)

Show Progress Indicator (on by default) shows a row of progress dots once you have more than one chapter — it's hidden automatically with zero or one chapter, since there's nothing to indicate progress through. Snap on Scroll makes the page scroll snap to each chapter boundary instead of scrolling freely.

Snap on Scroll shows OFF on a brand-new section, even though it snaps until you touch it

A Story Mode section you've never opened the Layout tab on behaves as if Snap on Scroll is ON — that's the section's real saved default. But the moment you open the editor, the Snap on Scroll switch itself displays OFF. Flipping it and flipping it back doesn't restore the original unset state — it explicitly saves false. If you want scroll-snapping and the switch looks off, turn it on and save; don't assume the displayed state matches what's live until you've saved at least once.

Pinned Scroll and reduced motion

Whenever a visitor's device has Reduce Motion turned on at the OS level, or Motion is set to None, Pinned Scroll never activates its sticky/pinned behavior — it renders as a static, normally-flowing layout instead (each chapter's image sits directly above its text, no scroll-tracking). The same reduced-motion check also strips the Motion setting's reveal animation in Stacked presentation, so a visitor with Reduce Motion sees every chapter appear instantly rather than fading or sliding in.

Chapters not showing up

With zero chapters added, Story Mode renders an empty section — no error, no placeholder text, just blank space where the chapters would be. Add at least one chapter for anything to appear.

Blog Preview — whole-card click-through & Card Appearance

Every post card in Blog Preview — the image, title, excerpt, and meta line, not just the Read More link — is clickable and navigates to that post, on every Display Style (Grid, List, and Carousel alike). Clicking Read More itself still works exactly as before and doesn't double-navigate; it's just no longer the only clickable part of the card.

Cards aren't clickable-to-navigate inside the editor

While you're editing the page, clicking a Blog Preview card selects/edits the section instead of navigating away — the whole-card click-through is a customer-facing behavior only, disabled on the editor canvas so you can still work with the section. Preview or publish the page to see cards navigate on click.

Troubleshooting: clicking a card does nothing

A card only navigates if that post has a link to go to — if you're looking at placeholder/sample posts (no blog connected yet, or the section hasn't been configured with real posts), there may be no destination to navigate to. Confirm the section is pulling real posts before assuming the click behavior itself is broken.

Screen: Blog Preview section → Design tab → Image treatment group → Card shape.

Card Appearance gives you the shared background/border/shadow/padding/hover controls for every post card in the section — the same panel used across the library.

Card Appearance has no effect on the Carousel layout

This accordion only applies when the section's Display Style is Grid or List. Switch Display Style to Carousel and the accordion shows an explanatory note instead of the style controls ("Card Appearance applies only to the Grid and List display styles and does not affect the Carousel layout") — the Carousel layout's post cards render through a different, plainer markup path that doesn't read these fields at all. If you've set a background color or border here and it isn't showing up, check the section's Display Style first.

Announcement Bar — rotating through multiple messages

By default the Announcement Bar's Content tab shows a single Announcement Message field — the classic one-line banner. Open the Multi-Announcement Rotation group underneath it (its own accordion, with a hint reading "Add two or more announcements to rotate them automatically") to add a second message and turn the bar into an auto-rotating carousel instead.

Add announcement items

Click + Add in the Multi-Announcement Rotation group's item list. Each item gets its own Message, an optional Icon (emoji, shown to the left of the text), a Link (external URL, or a product/collection picked from your catalogue), and its own Background Color Override / Text Color Override — set these to make one announcement stand out from the bar's default colors (set below, in Bar Style).

Choose how they rotate

The Transition dropdown and Rotation Interval (ms) field only appear once you have two or more items in the list. Choose Static (no auto-rotate) to just show the first item with no timer, or Fade / Slide / Slide to auto-advance through every item on the interval you set (500–30,000ms, default 4000ms). Advancing wraps back to the first item after the last one, and the customer-facing bar also shows a row of pagination dots they can click to jump to any item directly.

The single-message field isn't gone — it's the fallback

Leaving the rotation list empty doesn't remove the bar — it keeps rendering the classic single-message field (Announcement Message, Call to Action link) exactly as before. The bar only switches to the rotating carousel once the list has one or more items in it, and it only activates the actual auto-rotate timer once there are two or more — a single rotation item shows that one message with no transition and no pagination dots, same as leaving the list empty. This is also why adding rotation items never breaks an existing bar: it's an additive, opt-in field.

If your rotation items link to products or collections, fill in the Store Base URL field in the Call to Action group (e.g. https://yourstore.billionbiz.store) — it's what the rotation items' product/collection links are built against. The bar-level Dismissible toggle, Bar Style (font size, background/text color, bottom border), and Bar Layout (position, sticky, scroll-hide, text alignment, height) controls apply to every rotation item the same way they apply to the classic single message.

Announcement Bar — schedule, countdown, direction, and dismissal

Screen: Online Store → Store Editor → open Announcement Bar. The same controls remain available when editing an older Secondary Announcement Bar.

Schedule visibility in Position & behaviour → Schedule

Set Schedule start and/or Schedule end. Before the start or at and after the end, the bar is hidden. Schedule timezone offers Shopper's browser time (the default), UTC, Asia/Kolkata, America/New_York, and Europe/London. Store timezone is not available to this storefront control yet, so choose an explicit zone when every visitor must see the change at the same moment.

Configure Countdown → Countdown behavior

Set Countdown ends at, then choose When countdown ends: Hide announcement removes the bar, while Switch message reveals Message after countdown and swaps to that copy at zero. If the replacement message is blank, the original message remains. The countdown deadline is separate from Schedule end; whichever rule hides the bar first wins.

Choose Position & behaviour → Marquee direction

Set Marquee direction to Left (the default) or Right. This changes the direction of the bar's moving content; it does not change the order of your saved messages.

Configure dismissal in Position & behaviour

Turn on Dismissible so customers have a close button. Open Remember dismissal, then set its Remember dismissal control to This session or For days. For days reveals Dismissal days, with a minimum of 1. Use Dismissal version to show the announcement again after an important content change to customers who dismissed an earlier version.

Why is the announcement missing?

In the Store Editor, check Position & behaviour → Schedule and whether Countdown → Countdown behavior → When countdown ends is set to Hide announcement after an elapsed deadline. If only some returning customers miss it, they may have dismissed the current Dismissal version; increase the version deliberately or wait for the configured session/day memory to expire. A close button appears only when Dismissible is on.

Announcement Bar — Bar Layout: only a sticky-top bar reserves space above the header

Screen: Announcement Bar section → Layout tab → Bar Layout. Two of its fields govern where the bar sits and whether it pushes the header down: Position (Top — default, or Bottom) and Sticky (fixed while scrolling) (off by default).

PositionStickyWhere it rendersReserves space above the header
TopOffIn normal document flow, wherever you placed the section on the page (first section or mid-page) — scrolls away with the pageNo
TopOnFixed to the very top of the viewport, above the headerYes
BottomOff or OnFixed to the bottom of the viewportNo

Only a bar that's both Position: Top and Sticky on actually claims header-offset space — a non-sticky top bar (including one placed as your page's first section) scrolls with the page like any other section, and a sticky-bottom bar occupies the opposite edge instead. If you have more than one sticky-top Announcement Bar mounted at once (for example on a page and its published header), the storefront reserves space for whichever one is tallest, and removing the taller one lets the remaining bar's own height take over automatically.

Why is there a blank gap above my header, or why does content start too low?

This only happens on a genuine sticky-top bar (Position: Top + Sticky on) — its measured height is what the storefront reserves as blank space above the fixed header. A non-sticky bar, or one set to Position: Bottom, is not supposed to reserve any space; if you still see a gap or a clipped hero with one of those, hard-refresh the storefront before assuming the section is misconfigured.

Before / After Slider and Before & After are now looks of Comparison Carousel

Both have been folded into Comparison Carousel (see Product Comparison — choose and order products above, under Product sections). If a page you built before has a Before / After Slider or Before & After section, it's untouched — it still renders and still opens in its own editor exactly as before; you just can't add a new one from the library. For a new page, add Comparison Carousel instead and set its Layout tab Toggle Style to Slider Handle — combined with the Slider Behavior accordion's Show Divider Handle and Initial Position controls, that reproduces the draggable-divider comparison both older sections provided.

Conversion sections

Sections aimed at nudging a purchase or a sign-up: a newsletter sign-up block, a referral-program invite, and gradient call-to-action banners.

A wide range of urgency and loyalty sections also live in this category: a Low Stock Alert banner with tiered urgency styling, a Limited Edition countdown for exclusive drops, a Deal of the Day spotlight with its own countdown, a Free Shipping Banner progress bar tied to the live cart total, a Loyalty Program promo showing points and tier progress, a Gift Finder quiz that narrows down results by price range, a Subscription CTA with a monthly/annual billing toggle, a Back in Stock notify-me form (email or SMS), a Wishlist Reminder nudge that reads the visitor's live wishlist, and a Pricing section for plan or product-tier comparison tables.

Free Shipping Banner — live threshold, coupon, and countdown

Screen: Online Store → Store Editor → open Free Shipping Banner → Shipping threshold.

Set Threshold source to Shipping rules to use the store's current free-shipping rule at runtime, or Manual amount to use Free shipping threshold. Turn on Use live cart total so the customer's cart contributes to the progress display; when it is off, the progress bar always shows 0% used. The published storefront recalculates the remaining amount from the live cart; the editor uses preview data.

In the same Shipping threshold group, set Coupon code, optional Coupon message, Countdown ends at, and When countdown ends (Hide countdown or Keep at zero). Customers can copy the coupon code; the editor preview does not write to their clipboard. The countdown can disappear at zero or remain visibly at zero without hiding the shipping progress itself.

Why is the threshold or offer missing?

For Shipping rules, confirm the store has an eligible free-shipping rule. If runtime shipping data is unavailable, the rest of the section can still render; choose Manual amount when you need a fixed fallback. Free shipping threshold must be greater than 0. The coupon row needs a Coupon code, and an expired countdown set to Hide countdown is intentionally absent. If the progress never moves, turn on Use live cart total and add an item to the storefront cart.

Gift Finder's Content tab has a Button Labels group with six editable button texts — Start Quiz, Next, Back, View Results, View Gift, and Shop All Gifts — so you can rename any step of the quiz flow without touching code; each defaults to that same wording if left blank.

Gift Card Band — denominations & the CTA target

Screen: Online Store → Landing Page Editor → Add section → Library, search "gift card" for Gift Card Band — a promotional strip for selling gift cards, with a row of denomination pills and a CTA.

Set the copy (Content tab)

Eyebrow, Heading (defaults to "Give the Gift of Choice" if left blank), and Subheading.

Configure denominations (Content tab → Denominations group)

Each denomination has an Amount, an optional Label (optional override) to show custom copy instead of the formatted price, and a Mark as popular toggle that gives that one pill an accent border and background — purely visual, it doesn't change what the pill does. A new section starts with four denominations (500 / 1,000 / 2,000 marked popular / 5,000, in your store's currency formatting); add or remove pills with Add Denomination and the ✕ on each card.

Set the CTA (Content tab → Call to Action group)

CTA Text (defaults to "Buy a Gift Card") and CTA Target — a link picker that accepts a product, a collection, or an external URL.

Background & layout (Layout tab)

Layout: Split (default — text on one side, denominations on the other) or Centered. Background Image URL is optional; once set, a Scrim Opacity slider (0–100%, default 45%) appears to darken the photo behind the text for readability.

Empty denominations list

Remove every denomination and the pill row simply disappears — heading, subheading, and CTA still render, just with a gap where the pills would be. There's no placeholder or empty-state message, so an accidentally-emptied list can look like a half-finished section rather than an error.

A second set covers popups, compliance, and promotional layout: a Popup Announcement (entry, exit-intent, scroll-depth, or timed trigger), a Newsletter Popup for email capture, a Cookie Banner and an Age Verifier for GDPR/CCPA and age-gate compliance, a Promo Banner and Promo Tiles for slim strips or tile grids, a Sticky Add-to-Cart bar that follows the visitor while scrolling a product page, and a Contact Form with configurable fields. Contact Form submissions go to a webhook you configure, or to BillionBiz's own handler if you leave that blank — either way you'll see a real error if delivery fails, never a false success message.

Secondary Announcement Bar is now part of Announcement Bar

Secondary Announcement Bar has been retired from + Add Section and folded into the plain Announcement Bar (Content & brand-story sections above). If a page you built before has a Secondary Announcement Bar section, it's untouched. For a new page, add Announcement Bar and open its Multi-Announcement Rotation group — see Announcement Bar — rotating through multiple messages above — to get the same second, rotating message strip Secondary Announcement Bar used to provide.

Promo Grid is now a look of Promo Tiles

+ Add Section shows one Promo Tiles card, not a separate Promo Grid card. Click the card to add the standard tile grid, or use the Promo Grid variant chip under it to add the tighter bento-style layout the old Promo Grid section used — searching "promo grid" still finds it. An existing Promo Grid section on a page you built before keeps rendering exactly as it did; this only changes how you add a new one.

Promo Tiles — columns, image ratio, and gap

Screen: Online Store → Landing Page Editor → select Promo Tiles → All settings → Content → Layout. These controls are available on the standard Promo Tiles layout in the current Store Editor; the Promo Grid variant uses its own layout controls.

ControlOptionsStorefront effect
Columns2, 3, or 4Sets the number of equal-width tile columns in each grid row
Image aspect ratio1:1 — Square, 4:3, 3:4, 16:9Sets every tile image frame to the selected proportion; images fill that frame
Tile gapNone, Small, Medium, LargeSets the horizontal and vertical space between tiles

A Columns value of 0 now falls back instead of breaking the page

Promo Tiles and the other grid-style sections that carry a Columns control (product listings, navigation grids, Multi-Column, Image Gallery, How It Works, and similar) share one underlying grid renderer. If a section's Columns value is ever saved or synced as 0 — for example via a corrupted import or an old draft — the section now falls back to a 3-column grid and still renders, instead of leaving that area of the page blank. Re-open the section and re-select a Columns value to clear the fallback and confirm the count you want.

Open the standard Promo Tiles section

Add Promo Tiles, or select an existing standard Promo Tiles section, and expand the Layout group in All settings. If you chose the Promo Grid variant, switch to its own layout controls instead.

Set the grid

Choose Columns, Image aspect ratio, and Tile gap. The preview rebuilds the grid with that column count, reshapes each tile image, and updates the spacing between tiles.

Save and publish

Check the result at the viewports you support, then save and publish the page. A Promo Tiles section with these fields unset keeps its earlier defaults: 3 columns, 4:3 images, and a Medium gap.

Why do I still see three columns or the old image shape?

Confirm you are editing the standard Promo Tiles layout in the current Store Editor, then check that the values are still selected after saving. Publish and refresh the storefront; the similarly named Promo Grid variant follows a different layout path and does not use this control group.

Promo Popup — announcement only, for now

Promo Popup is a modal for sale announcements or newsletter sign-up, triggered by exit-intent, scroll depth, a time delay, or immediately on load. Use it for announcements today: if you add an email field, the visitor sees a success message on submit, but that address doesn't reach a subscriber list yet — email capture on this section isn't wired to a backend. Use Newsletter Popup above if you need working email capture in a modal.

Industry-specific sections: Style & Lifestyle

+ Add Section groups these into two category tabs, Style (fashion and beauty) and Lifestyle (home, food, and electronics) — the five older per-industry tabs were merged into these two, but nothing about searching for a section changed: type "beauty," "fashion," "home," "food," or "electronics" in the search box and the matching cards still appear, since each section keeps its original industry as a searchable tag even after the re-grouping.

A set of sections built for particular product categories, including a lookbook, a seasonal-edit layout, and a Size Guide CTA for fashion; recipe cards, a meal planner, and Nutrition Highlights for food brands; a skin quiz and shade finder for beauty; a compatibility checker and a Setup Guide (numbered steps with per-step time estimates) for electronics; and room-inspiration, shop-by-room, and an AR Preview CTA for home goods.

Note

An older Specs Comparison section type has been retired from + Add Section — its electronics-only spec table was folded into the general-purpose Product Comparison section (under Product sections above), which any store can use regardless of industry. If your page already has a Specs Comparison section from before, it keeps working; you just can't add a new one.

Routine Builder and Shoppable Image are no longer their own cards

Routine Builder (beauty step-by-step routine builder) and Shoppable Image (a lifestyle photo with tap-to-shop product pins) have both been retired from + Add Section — their look and functionality were folded into sections that already existed. If a page you built before has one of these sections, it's untouched: it still renders and still opens in its own editor exactly as before. For a new page:

  • Use How It Works (Content & brand-story sections, above) instead of Routine Builder — it now carries Routine Builder's step fields, but there's no dedicated "Routine Builder" preset inside it yet, so match the look by hand with its own Layout and card controls.
  • Use Room Inspiration instead of Shoppable Image — set its Display Mode to Flat Image (single shoppable image, no room tabs) to get the same single-photo, tap-to-shop-pin layout Shoppable Image used to provide, without the multi-room tabs Room Inspiration normally shows.

Why don't customers see my Room Inspiration section?

On the published storefront, a Room Inspiration section with no rooms renders nothing. The hint "Add room images and hotspots in the editor to display them here." appears only inside the editor, never to customers. To make the section show: open it in the Store Editor, select the section, find the Rooms control, add at least one room and give it an image, then save and publish. Hotspots are optional.

Screen: Online Store → Store Editor → open Recipe Cards → Design → Layout, with Layout set to Carousel (the default; Grid has no dots).

In the plain carousel, each recipe card now fills the width of the carousel (on some template looks, wider screens show two or three cards across and phones show one), and the dots are measured from the real card width, so each dot lines up with one recipe. Previously the slides did not take a full width, so the dots jumped past recipes. No setting is involved. The dots show only when there is more than one recipe and the strip can scroll, and they are not drawn when the carousel uses the carousel-chrome arrows and pagination composition instead.

Recipe Cards — Card Appearance

Screen: Online Store → Landing Page Editor → select the Recipe Cards section → Design → Card style. The group has Card background, Border color, Border width, Corner radius, Shadow (None, Soft, Medium, Bold) and Hover effect (None, Lift, Zoom, Brighten, Glow). The older editor's Style tab → Card Appearance accordion is the same panel.

The same shared background/border/shadow/hover panel as Blog Preview above, applied to every recipe card. Unlike Blog Preview, there's no layout restriction here — Recipe Cards' Grid and Carousel display styles both route their cards through the same rendering path, so Card Appearance applies regardless of which one you've picked. Defaults match the section's existing look (your theme's surface background color, soft shadow, subtle lift on hover), so an existing Recipe Cards section renders unchanged until you open this accordion and change something.

Screen: Featured Collection section → Content tab, and Tabbed Products section → Content tab.

Both sections have a Card Style dropdown with two choices: Classic (the default, and how every existing Featured Collection or Tabbed Products section already renders) and Premium, a richer product-card treatment. Picking Premium and saving is enough — there's nothing further to configure on the card itself.

Only takes effect when Universal Card is off (legacy editor)

Both sections carry their own Use Universal Card toggle right below Card Style in the Content tab — a separate opt-in from the Universal Card (preview) on six sections group below, which covers a different set of sections (Best Selling Products, New Arrivals, Flash Sale, Trending Now, Shop by Category, and Category Circles). Switching Featured Collection's or Tabbed Products' own Use Universal Card on replaces the section's cards with the newer consolidated card design, and Card Style's Classic/Premium choice stops having any visible effect for as long as it stays on — Card Style only drives this section's original card markup.

Universal Card (preview) on six sections

Legacy editor wording

This section describes the legacy landing-page editor's Universal Card (Preview) group and Use Universal Card toggle. In the v3 store editor the control is Card system (Legacy or Universal), with an explicit Switch to universal cards action in the card-look group. This also covers Promo Tiles. See Card looks need universal cards for the v3 behaviour.

Opt-in preview, not a new default

This is a per-section switch you turn on yourself. It is not the default look for any section — every existing Best Selling Products, New Arrivals, Flash Sale, Trending Now, Shop by Category, and Category Circles section keeps rendering its current card exactly as before until you opt it in.

Six sections — Best Selling Products, New Arrivals, Flash Sale, Trending Now, Shop by Category, and Category Circles — share a newer, consolidated card design you can preview one section at a time. Each of these sections has a Universal Card (Preview) group in its Content tab, with the same controls in every section:

Turn on Use Universal Card

This is the opt-in switch. Off (the default) keeps the section's original card. On swaps every item in that section to the new card.

Pick a Card Layout

Six layouts: Image only, Image + text underneath, Image + text beside (left), **Image

  • text beside (right)**, Text overlaid on image, and Text-forward.

Set Show Wishlist Button

On by default. Only has an effect on the four product sections — see the category exception below.

Choose hover behaviour

Seven independent toggles: Image swap (crossfades to a second photo, only if one is set), Overlay text, Zoom, Reveal actions on hover (rather than always showing them), Colour wash, Caption slide-up, and Badge reveal on hover. Each is on or off by default per the section's own starting point, and each only does something when the underlying data supports it — a hover image-swap with no second image set simply doesn't swap.

Recently Viewed — show the wishlist heart

Recently Viewed has its own Universal-card wishlist control. It is on when the setting has never been saved, unless an older section already saved its corresponding wishlist setting off.

Use the Universal card system

Select Recently Viewed, open Design → Layout, and set Card system to Universal.

Open the Behaviour part

Open History behavior → Card actions, then set Show wishlist heart on or off. Save the page after changing it.

Verify the customer-facing card

Preview a visitor with recently viewed products. When the switch is on, the Universal product card shows its wishlist action; when it is off, that action is absent. Publish and refresh the storefront after confirming the result.

The control is hidden when Card system is Legacy, because legacy Recently Viewed cards do not render a wishlist action. It is also hidden when Layout is Grid and Premium card geometry is Contained editorial grid, because that premium geometry uses a separate card without a wishlist action.

Why can't I find Show wishlist heart?

First set Card system to Universal. If the control is still absent, change Premium card geometry away from Contained editorial grid, or use a layout that does not activate that premium grid geometry.

Category cards never show cart or wishlist actions — by design

Shop by Category and Category Circles are category content, not products — they carry no price or rating. The Show Wishlist Button toggle and the add-to-cart action stay honestly hidden on these two sections' cards regardless of how you set them; a control that can't apply to category data is never shown as a dead/disabled button. What you get instead on a category card: the category image, name, and (if your category has one) an item count — plus whichever hover effects you've turned on.

Flash Sale — which products it shows

Screen: Online Store → Landing Page Editor → select the Flash Sale section → Content → Products shown → Products to show. Pick the exact sale products, in order. A Flash Sale with no products, tag or collection chosen shows nothing on the published page unless it uses the Refined look (Design → Presentation → Refined, which new sections start with): then it fills from your catalog, up to the section's product count (4 when none is set). If you choose a tag or collection that matches no products, the section stays empty, because an explicit choice is never replaced by the catalog. Older sections on Classic keep showing nothing until you pick products.

Troubleshooting "why is my Flash Sale empty?": pick products, a tag or a collection; or switch Presentation to Refined for the catalog fill; then check the tag or collection actually contains published products.

Flash Sale — sold-progress bar

Flash Sale's countdown timer stays on the section itself either way. Its per-item sold-progress bar (the "X% Sold" bar under a product, controlled by the section's own Show Sold Bar toggle) carries over onto the Universal Card automatically when both that toggle is on and the product has a real sold-percentage value — you don't need to configure anything extra for it once Universal Card is on.

Trending Now's decorative urgency flame badge and its trend graph don't have an equivalent on the Universal Card yet — turning Universal Card on for this section loses them. Its plain low-stock count does carry over, shown as a "Only N left" note on the card.

Style navigation and utility sections in Store Editor v3

Screen: Online Store → Landing Page Editor → select the section → All settings → Design. Start with the section's real content, links and targets in Content, then choose a component look. The coordinated spacing and framing below activate after a styled look is selected. Keeping the original tile, or only changing Advanced while the original tile is selected, does not activate that coordinated treatment. A heading look needs heading content; a button look needs a rendered button.

Choose a look, check desktop and mobile, click Save, and Publish when ready. Test the actual links or tab switches on a fresh storefront page. A visual look keeps the section's existing content and destinations; it does not create a missing target, brand, measurement or button.

Product Tabs — make long details easier to scan

Screen: Online Store → Landing Page Editor → Product Tabs → All settings → Content. In Tabs, add each Tab label and Tab content. Add a Tab image and its Alt text when using Content layout → Text + image. Show icons controls the existing icons, and Sticky tab navigation controls the existing sticky behavior.

Open Design → Tab navigation look. Choose Editorial underline for an underlined active tab, Retail pills for compact pills, Segmented for a grouped switch, or Quiet text for a quiet text treatment. Section natural keeps the section's own tab style. Styled navigation gives tab buttons a larger touch target and readable content width; it keeps each tab's content and images. Use Active tab style, Tab alignment and Tab density directly below the look tiles to refine a selected look.

For a lower dot selector, choose Dots in Design → Carousel controls. Those dots select a content tab; they do not add product slides. When no Tab navigation look is configured, the styled dots replace the upper navigation. A configured Tab navigation look takes precedence for that upper row. Check that customers can distinguish the tabs from the selected panel's content. For a more visible section title, choose Boxed in Heading look to frame an existing heading as a pill.

If styling appears unchanged, confirm a styled tile is selected and that the section has tabs. If an image is missing, check Content layout and the image inside that tab before changing Media look on another section. Preview long tab labels on mobile and test every panel after publishing.

Screen: Online Store → Landing Page Editor → Pill Anchor Nav → All settings → Content → Pills. For each pill, set Pill label and Target section anchor ID to the anchor ID of a real section on this page. Enter the ID itself. In Scroll behaviour, use Highlight the pill in view, Stick to top on scroll and Sticky offset for the existing scrolling behavior.

Open Design → Tab navigation look and choose Retail pills or Segmented for distinct selected states, or Editorial underline / Quiet text for lighter navigation. The styled presentation gives links larger touch targets and removes the edge fade. Heading look → Boxed frames the existing heading without changing where the pills scroll.

If a pill does nothing, compare its Target section anchor ID with the destination section's anchor ID. Changing a look cannot repair an unmatched ID. If a sticky header covers the destination, check the existing sticky offset and test the page on mobile. A highlighted pill requires Highlight the pill in view and a real destination; a look alone does not add scroll tracking.

Screen: Online Store → Landing Page Editor → Mega Menu → All settings → Content → Columns. Add a Column heading and Links, with Link text and Link URL for each destination. Use Featured image for the column image and its Alt text / Image link, or Promo tile for Tile image, Tile label, Button text and Tile link. Enable Show featured images and Show promo tiles in Menu for the elements you want customers to see. Opens on keeps its existing Hover or Click behavior.

Open Design → Tab navigation look and choose a styled tile for the column navigation. A selected Media look can also frame the existing featured or promo images. The styled menu uses larger link targets and a link-and-media composition on desktop; mobile stacks the content and keeps the tab list scrollable. Featured images use a wide frame on desktop and a taller frame on mobile, so check the crop and alt text at both sizes.

If an image does not appear, confirm the relevant Show featured images or Show promo tiles control and its image source. A media look does not supply an image. If a link opens the wrong page, correct Link URL, Image link or Tile link in Content; choosing a new look preserves those values. Test both opening the menu and following a destination after publishing.

Size Chart — keep measurements readable

Screen: Online Store → Landing Page Editor → Size Chart → All settings → Design → Tab navigation look. Choose Segmented for the measurement-unit switch, or another styled tab tile for its preferred active state. The styled chart increases button targets and aligns table cells while preserving the configured measurements and the existing unit-toggle setting. Check both units when the toggle is enabled, and scroll a wide chart on mobile.

Heading look → Boxed frames an existing title. A styled Card text look can show a "Measurements in cm" or "Measurements in inches" note for the selected unit; it does not fill in missing rows. If the unit switch is hidden, check the section's existing unit-toggle setting. If the chart is empty, add the measurements in Content before styling it. A look does not convert missing or incorrect measurements into valid sizing data.

Brand Index A–Z — frame the directory heading

Screen: Online Store → Landing Page Editor → Brand Index A–Z → All settings → Design → Heading look. Choose Boxed to frame a populated heading, or Plain to keep the original heading treatment. Keep the real brand names, logos and destinations in Content. Check a brand link and the directory's existing filtering on mobile after publishing. If there is no visible heading to frame, supply the heading first; changing its look does not add brands to the directory.

Divider — choose spacing, a rule or a section label

Screen: Online Store → Landing Page Editor → Divider → All settings → Design → Divider size & style. Set the native Style, Height, Line thickness, Line color and Full width (edge to edge) for the separation you need. Custom height is used with the Custom height choice; Ornament mark is for an ornamental rule. In Content → Divider label, Label text supplies a section label when the native Style is Section label.

Open Design and choose a divider look: Current divider keeps the native style; Blank spacer creates space; Hairline, Ornamental and Gradient fade create their respective rules; Heading rule arranges a label with a rule. The native settings stay saved, while a styled look can add spacing and a minimum height. Check the preview; use Current divider with the native Style when you need its original height. When using a section label, you can also choose Heading look → Boxed; its side rules are hidden on narrow mobile screens to leave room for the label. Existing ornament choices remain in effect where the selected divider uses an ornament.

If you wanted only whitespace, choose Blank spacer and check Height. If you wanted a visible label, check Label text and the native Section label style. A heading look needs that label; it does not invent one. Inspect the section boundaries on mobile as well as desktop before publishing.

Screen: Store Editor v3 → select a Featured Collection section → Cards group.

Choose Card video

Set Card video to Off (the default), Play when visible, Always or On hover. It plays the video uploaded on a product on that product's card; a product without a video keeps its photo. Visitors who prefer reduced motion or are on a slow connection always see the still photo.

Add a Card ribbon

Type short text in Card ribbon text, for example "BUY 2 GET 1 FREE". The ribbon shows on every card in the section. Leave the field empty for no ribbon.

Pick the ribbon colour

Once text is entered, Card ribbon colour appears: Sale, Primary, Dark or Gold. Until then the field shows "Enter Card ribbon text to choose its colour."

Publish and check

Save, publish and open the storefront on a product that has a video and on one that has none.

Why doesn't my card video or ribbon show?

  • The product has no uploaded video, or Card video is Off.
  • The visitor's device asks for reduced motion or data saving, or the connection is slow: the photo stays.
  • The ribbon text is empty.
  • Only Featured Collection has these two controls; other product rows do not show them in the inspector.

Screen: Store Editor v3 → select a Featured Collection section → Cards group.

Use the Premium card look

Set Card look to Premium. Link product titles to product page appears only while Card look is Premium, Card system is Legacy (the default), Card preset (Layout group) is Default, and Premium card geometry is not Contained editorial grid on the Grid layout. With Classic cards, Card system set to Universal, a Card preset of Editorial, Minimal or Bold, or the Contained editorial grid geometry, those cards are drawn by their own card, so the switch is hidden and has no effect.

Switch it on

Turn on Link product titles to product page. Each card's product title becomes a link to that product's page. For a product that has variants (for example sizes or colours), the add-to-cart button opens the product page so the shopper can choose a variant first, instead of adding at once. Products without variants add to the cart as before.

Publish and check

Save, publish and open the storefront. Click a product title, and click add-to-cart on a product that has variants.

The switch is off by default, and off writes nothing: titles stay plain text and existing stores are unchanged. The links and the variant redirect work on the published storefront; inside the editor preview, add-to-cart on a variant product does not navigate.

Why don't my product titles link?

  • Card look is Classic: switch it to Premium.
  • Card system is Universal: the switch is hidden and the Universal card ignores it; set Card system back to Legacy.
  • Card preset is Editorial, Minimal or Bold, or Premium card geometry is Contained editorial grid on the Grid layout: those use their own card, which does not read this switch. Set Card preset to Default and Premium card geometry to Standard cards.
  • The switch is off, or you have not published yet.

Screen: Store Editor v3 → select a Testimonial Rich Carousel section → Layout group → Marquee rows (1 or 2).

The field appears only when Layout is Kinetic marquee and Source is Store reviews; otherwise the inspector explains that it is used only on that layout and source. Enter 2 for two rows that scroll in opposite directions; leave it empty (or 1) for a single row. If the field is missing, check that the source is not Manual testimonials.

Screen: Store Editor v3 → select a Video Spotlight Carousel section → Layout group.

Switch Layout to Reels grid

Layout offers Carousel and Reels grid. The grid shows tall 9:16 video tiles edge to edge and appears on the storefront only when at least one product has a video.

Optionally add an Instagram link

With Reels grid selected, Instagram profile link adds a "Follow us on Instagram" button under the tiles. Once a link is set, Instagram button text lets you change the label. Nothing is pulled from Instagram: the tiles are your own product videos.

Set Reels video playback

In the Playback group, Reels video playback offers Off, Play when visible, Always and On hover. Visitors who prefer reduced motion or are on a slow connection see the still poster.

Why is my Reels grid empty or missing its button?

No product has an uploaded video, so there is nothing to show. The Instagram button is missing when the link is empty or Layout is still Carousel. The link, button text and playback fields are hidden until Reels grid is chosen.

Best Selling and Hero Product Showcase — add-to-cart under the image and mobile image focus

  • Best Selling: in the Cards group, Show add-to-cart below the image moves the add-to-cart button out of the photo and under it. It is available only while Show add to cart is on.
  • Hero Product Showcase: in the Background image group, Mobile image focus sets which part of the background photo stays in view on phones, written as "x% y%" (0% 0% is top-left, 100% 100% is bottom-right). Leave it empty for the centre. It is available only while Show background image is on.

Add-to-cart button text, brand fill and phone image stacking (Store Editor v3)

Four controls were added to the v3 Store Editor. Open Online Store → Store Editor, pick the page, select the section, and use the Content tab of the section's inspector. Save and publish afterwards, then check the published page, not only the editor preview.

Best Selling — Add-to-cart button text.

Open the Cards group

Select Best Selling, then open Content → Cards.

Keep Show add to cart on

Add-to-cart button text appears only while Show add to cart is on. If it is off, the field is hidden and the editor tells you to turn Show add to cart on.

Type your wording

Enter the wording you want, for example ADD TO BASKET. The field's placeholder shows the default, ADD TO CART. Leave it empty to keep that default.

Best Selling — Fill the add-to-cart button with the brand colour. In the same Cards group, switch this on to turn the button under the photo into a solid brand-colour button instead of an outline. It is visible only when both Show add to cart and Show add-to-cart below the image are on. With the button still on the photo, the toggle is hidden and the editor says to turn on Show add-to-cart below the image.

Best Selling — Show best sellers until you pick products. Select Best Selling, open Content → Product source, set Product source to Manual selection, and switch on Show best sellers until you pick products. While no products are picked, the section shows your best sellers instead of an empty placeholder; as soon as you pick products, only your picks show. The switch is off by default and is visible only while Product source is Manual. With Auto (best sellers) the section already lists best sellers, so the switch is hidden.

Best Selling — Flat add-to-cart button. Select Best Selling, open Content → Cards, and switch on Flat add-to-cart button. The grey strip behind the button under the photo disappears and the button uses the standard 4px corner radius. It is visible only while Show add to cart, Show add-to-cart below the image and Fill the add-to-cart button with the brand colour are all on; otherwise the editor says to turn on the brand-colour fill. Like the brand fill, it applies only to the current (revision 2) card rendering. Off keeps the strip.

Hero Banner — Image shadow. Select Hero Banner, open Content → Media, and choose Shadow or None under Image shadow. None removes the drop shadow around the image when it sits inside the banner as a framed picture; the corner rounding stays. Shadow is the default and keeps today's look. Layouts where the image fills the whole banner have no frame, so the setting changes nothing there.

Hero Banner — Darken behind text on mobile. Select Hero Banner, open Content → Media, and switch on Darken behind text on mobile. On phones and small tablets (under 900px wide) an extra dark layer sits behind the hero text so it stays readable over a bright photo. The toggle is off by default, and off writes nothing: the image keeps its normal darkening. It is visible only while Hero layout is Full-bleed backdrop (including its Editorial — text block anchored left text panel) or Frosted panel; on every other layout the control is hidden because those layouts do not render the layer. Image darkening, just above it, still sets the darkening on all screen sizes.

Hero Carousel — Darken behind text on mobile. Select Hero Carousel, open Design → Height & image darkening, and switch on Darken behind text on mobile. Below 900px wide (phones and small tablets) the dark layer over each slide image is held at no less than 60% darkness, so light headline text stays readable over a bright photo. A slide whose own Image darkening is already above 60% keeps its stronger value. The toggle is off by default, and off writes nothing: the slide keeps its normal darkening. It is always shown, with no condition.

Hero Carousel — Image fit on mobile. In the same Design → Height & image darkening group, Image fit on mobile is a two-way switch: Fill (the default) crops each slide image to the box, and Fit shows the whole image below 768px wide. Use Fit for banners with text baked into the picture, which Fill would crop. Desktop is unchanged either way.

It takes effect only when all of these hold:

  • the hero carousel uses the newer rendering (revision 2). A hero carousel from a Store Template ships with it only where the template sets it; one on the earlier rendering ignores the toggle;
  • the section uses the default layout (variant A, the classic centred layout), the only one whose image layer this applies to;
  • the visitor's screen is under 900px wide.

Without it, on the newer rendering, the dark layer on screens under 768px is capped at 35% so a phone photo is not over-darkened. Turning the toggle on replaces that cap with the 60% floor.

Featured Product — Add-to-cart button text. Select Featured Product, open Content → Call to action, and fill Add-to-cart button text (placeholder and default Add to Cart). It appears only while Show add-to-cart button is on. Empty keeps Add to Cart.

Flash Sale — Add-to-cart button text. Select Flash Sale, open Content → Cards, and fill Add-to-cart button text (placeholder and default Add to Cart). It applies to every deal card. This field has no on/off condition in the editor, so it is always shown. Empty keeps Add to Cart.

Hero Product Showcase — Stack the photo under the text on phones. Select Hero Product Showcase, open Content → Background image, and switch on Stack the photo under the text on phones. On screens narrower than 480px the text comes first and the photo sits below it, 260px tall, instead of sitting behind the text. Wider screens are unchanged. The toggle is visible only while Show background image is on, and it is also hidden when the section uses the pinned-photo (hotspots) layout.

Why don't I see this control, or why didn't my wording change?

  • No brand-fill toggle on Best Selling: it needs Show add to cart on and Show add-to-cart below the image on. Turn both on and it appears.
  • No Darken behind text on mobile toggle on Hero Banner: change Hero layout to Full-bleed backdrop or Frosted panel; the other layouts hide it.
  • Darken behind text on mobile changed nothing on desktop: correct. It applies only below 900px, so check on a phone or narrow window. If a phone shows no change either, the section is on the earlier rendering or on a layout other than the default one; also confirm you published.
  • Best Selling still shows a placeholder with Manual selection: switch on Show best sellers until you pick products (Product source must be Manual), and confirm you published. It cannot show products your catalog does not have yet.
  • No flat-button toggle on Best Selling: turn on Fill the add-to-cart button with the brand colour first (which itself needs the two switches above).
  • No button-text field: Best Selling and Featured Product hide it while their add-to-cart switch is off. Flash Sale always shows it.
  • Text saved but the storefront still says Add to Cart: the custom wording and the brand fill are read only by the current (revision 2) storefront rendering, which is what stores created from a store template use. A section on the earlier rendering keeps the default wording and the outline button. Also confirm you published.
  • A Featured Product call-to-action that repeats the cart wording shows only once: on the current rendering, a custom button text that just restates "Add to cart/bag/basket/box" or your own add-to-cart text is dropped so one buy button shows.
  • No phone-stacking toggle on Hero Product Showcase: turn on Show background image, and use a layout other than pinned photo.

Hero Product Showcase, Stats Counter and Guarantee banner: choose Design Classic or 2026

Hero Product Showcase, Stats Counter and Guarantee banner each have an opt-in Design control with two choices, Classic and 2026. Classic is the original look and is the default: a section you have never touched, and every section on a store that already exists, stays Classic. 2026 switches that one section to the refreshed treatment. The control's own help text reads "2026 adds the refreshed treatment for this section. Classic keeps the original look."

Screen: Store Editor → open the page → select the section → Design tab → Design group → Design.

Select the section

In the Store Editor, open the page that holds the section and click the Hero Product Showcase, Stats Counter or Guarantee banner section on the canvas.

Open the Design tab and its Design group

In the inspector, click the Design tab (the others are Content and Behaviour). The control sits in a group titled Design; click the group header if it is collapsed.

Pick Classic or 2026

Choose 2026 in the segmented Design control to opt this section in. Choose Classic to go back; picking Classic removes the saved setting, so the section is exactly as it was before you opted in. Nothing changes on your live store until you publish.

Only these three sections have this control. Opting one section in does not change any other section or page, and the control never saves a value until you click 2026.

Hero Product Showcase: Text over image

On Hero Product Showcase only, the same Design group has a second segmented control, Text over image, with three choices: Auto, Light and Dark. It sets the colour of the text that sits over the image overlay on the 2026 design. The help text reads "Auto picks light or dark text for readability over the image overlay." Auto is the default when you never set it, and Light or Dark force that text colour.

The control is visible only while Design is set to 2026. On Classic it is hidden, and the editor's note for it is "Choose the 2026 design above to edit this." Switch Design to 2026 and Text over image appears right below it.

Why don't I see the Design control, or Text over image?

  • You are looking for Text over image on Classic. It appears only on Hero Product Showcase, and only after Design is set to 2026. Pick 2026 first.
  • Your store is not on the build that includes it yet. Each control appears only when the store's section definitions support it. Until then the Design group, or just Text over image, does not exist for that section; nothing is broken and the section stays Classic.
  • You are on the Content or Behaviour tab. Both controls are on the Design tab only.
  • You are in the old Landing Page Editor. The classic editor is frozen and never gets these controls; use the Store Editor.
  • It is a different section. Other sections, including Hero Banner and Hero Split, do not have a Classic or 2026 choice.

Rich Text, Trust Badges and Custom HTML — style the visible content

For Rich Text, go to Online Store → Landing Page Editor → Rich Text → All settings → Content, enter Text, and set Presentation → Prose. A styled heading or quote look gives existing prose a readable centered measure and framed heading or pull-quote treatment. It preserves the text. These prose treatments do not apply to Code block presentation; keep code formatting under its own controls. If a heading or quote look appears to do nothing, check that the text actually contains that kind of content and that Presentation is Prose.

For Trust Badges, go to Online Store → Landing Page Editor → Trust Badges → All settings → Content → Layout → Layout → Guarantee banner. Populate the existing badges and, if needed, Guarantee banner → CTA text and CTA link. A styled Heading look or Call to action look gives this presentation an open badge arrangement, with three columns on desktop and one on mobile. It keeps the badge content and link behavior. Other layouts keep their own arrangement, so check Layout before expecting the Guarantee banner treatment.

For Custom HTML, go to Online Store → Landing Page Editor → Custom HTML → All settings → Content. Supply HTML and, if desired, the native Heading, Button text and Button link. Choose Heading look or Call to action look in Design to style those native elements around the HTML. The styled wrapper limits their reading width and adds spacing, and its typography can affect the HTML content. It does not rewrite your HTML or its links. Render in a sandboxed frame retains the separate frame behavior. If the section is absent, check that HTML is populated; if a native button is absent, check Button text before changing its look. Preview embedded content and follow the native button's real link before publishing.

Sections that offer component looks

In the v3 store editor, some sections show a component look group in the Design lens of All settings. See Choosing a component look for how the picker works. A group appears only where the section actually contains that piece:

  • Card looks (a card group plus Price look and Meta stack look where they apply): Best Selling Products, New Arrivals, Flash Sale, Trending Now, Recently Viewed, Featured Collection, Tabbed Products, Shop by Category, Category Circles and Promo Tiles. These sections show card looks on the storefront once their Card system is Universal. While a section uses classic (Legacy) cards, the picker keeps its tiles disabled and shows a notice with a Switch to universal cards button. Shade Finder also offers card looks, with no notice: its layout, hover, price and meta stack apply under either system, and it has no design or material controls. Promo Tiles uses offer card looks after the same explicit switch. Price look is for product cards only; Meta stack look is for product and category cards.
  • Media look: Hero Video, Shoppable Image, Shoppable Video, Video Section, Video Hero Overlay, Video Spotlight Carousel, Video Testimonials, Hero Split, Multi-Column, Alternating Columns, Why Choose Us, Featured Product (Rich), Press Logos Band, Split Hero Scrub, and the media items inside composite sections.
  • Announcement bar: the Announcement Bar section has its own five-look editor.
  • Free shipping banner: its own five look tiles plus content fields.
  • Tab navigation look: Tabbed Products, the collection tabs section, Product Tabs, Pill Anchor Nav, Mega Menu and Size Chart. See Style navigation and utility sections for setup and troubleshooting.
  • Form input look: Contact Form and Newsletter CTA.
  • Heading look and Carousel chrome: available on most sections that have a heading or a carousel (well over a hundred sections have a heading look). Carousel chrome is opt-in: a section that has never had a carousel look picked renders exactly as before.
  • Composite sections (carousel, grid, marquee, split, stack, tabs) add the section-level composite editor described on the editor page.

Call to action look is available on supported hosts, including Newsletter CTA and Hero Banner. Go to Online Store → Landing Page Editor → select the section → All settings → Design → Call to action look. See Give buttons a shared look for the four styled tiles, controls, preserved action behavior, and presentation-specific limits. Other look groups depend on the section's supported components and populated look catalog; use its normal Content, Design, and Behaviour controls when the group you need is unavailable.

Configure family members in Store Editor v3

Use this guide when you choose a named member inside a section family in the current Store Editor. The Content, Design, and Behaviour controls below belong to that member. The earlier category references on this page also describe the classic editor, whose tabs and labels can differ.

Screen: Online Store → Landing Page Editor → Add section → Library → choose a family member → select its outline row.

Choose the member you want

Open Online Store → Landing Page Editor → Add section → Library. Open the relevant family and choose its named member from the table below. After adding it, select its row in the page outline.

Open its controls

Open All settings, then choose Content, Design, or Behaviour and expand the group listed for that member below. Selecting a different outline row changes which section you edit.

Save and check the customer result

Select Save to save your edits. Saving a draft and publishing are separate actions; use Publish when the page is ready for customers. Check the published page at desktop and mobile widths, including each image, countdown, chapter, and button destination you changed.

FamilyMember to chooseMain setup group
Featured productLimited EditionContent → Content details; Behaviour → Playback & countdown
Featured product3D / AR ViewerContent → Content details
Promo popupNewsletter PopupBehaviour → Playback & countdown
Image banner midpageStory ModeContent → Content details
Image banner midpageImage + Text SlideshowContent → Content details; Behaviour → Playback & countdown
Gift finderSize Guide CTAContent → Content details; Design → Layout
Room inspirationIngredient SpotlightContent → Content details
Brand story splitFounder StoryContent → Founder
Hero bannerHeadline CollisionContent → Content details; Design → Layout

The saved section can retain its family name while showing the chosen member's controls. For example, a Limited Edition member belongs to Featured product; select that member's outline row to edit its quantity and countdown. Opening the inspector alone does not fill or replace saved content. If you see unrelated fields, check the selected outline row and the member you chose.

Limited Edition — stock, collector badge, and deadline

Choose Online Store → Landing Page Editor → Add section → Library → Featured product → Limited Edition, then select its outline row. Open Content → Content details to configure the drop's image, stock display, and collector badge.

ControlWhat to enter or changeCustomer result
Quantity remainingEnter the remaining quantity, at least 0.Updates the remaining-stock text and the stock bar relative to the section's total quantity.
Show collector badgeTurn on to display the collector number.Enables the collector badge when a number is also filled in.
Collector numberEnter the edition identifier, such as 007.Displays the identifier in the enabled collector badge.
Product imageChoose the image for this drop.Displays the drop's product image.

Open Behaviour → Playback & countdown → Countdown. Set End time to the deadline in the store timezone shown beside the picker, then enable Show days if you want days alongside hours, minutes, and seconds. The date is saved as an absolute UTC time, so customers share the same deadline.

If the collector badge is missing, check both Show collector badge and Collector number. A past deadline displays zeroed countdown units; check the date and timezone before publishing. Quantity remaining is a section display value: changing it does not adjust catalogue inventory.

3D / AR Viewer — fallback image and crop focus

Choose Online Store → Landing Page Editor → Add section → Library → Featured product → 3D / AR Viewer, then select its outline row. Open Content → Content details → Fallback image.

ControlWhat to enter or changeCustomer result
ImageChoose a still image of the product.Provides a fallback when there is no model or scene; it can also replace a scene for a visitor who requests reduced motion.
Image descriptionDescribe the product view.Supplies alternative text for the fallback image.
Focal point, horizontal (%)Enter a value from 0 to 100.Moves the crop focus from left to right.
Focal point, vertical (%)Enter a value from 0 to 100.Moves the crop focus from top to bottom.

Edit both focal-point coordinates to keep the product visible when the image is cropped. Each coordinate edit preserves the other coordinate and the image information.

If the fallback image does not appear, check the viewer's configured source: a model takes priority over the scene and still image. A scene normally takes priority over the still image. Setting a fallback image does not replace the configured model.

Newsletter Popup — fixed or per-visitor countdown

Choose Online Store → Landing Page Editor → Add section → Library → Promo popup → Newsletter Popup, then select its outline row. Open Behaviour → Playback & countdown → Countdown.

Enable the timer

Turn on Show countdown. The popup's normal display trigger still determines when the popup opens; this toggle adds a timer inside it.

Choose a shared deadline or visitor duration

For a shared offer deadline, set End time using the displayed store timezone. For a rolling window, clear End time and enter Per-visitor duration (seconds), at least 1. A filled-in End time takes priority over the duration.

Write the running and ended labels

Set Countdown label for the text before the running timer and Ended message for the text shown once it expires. Save the draft, publish when ready, and open the customer page afresh to check the popup and timer.

Customers see hours, minutes, and seconds while the timer is running, then the ended message. If the timer is missing, confirm Show countdown is on and either a deadline or duration is set. If changing the duration has no effect, clear the fixed End time first. Previewing an already open popup is insufficient for checking a newly configured per-visitor window; reopen the customer page to start a fresh instance.

Story Mode — edit and order chapters

Choose Online Store → Landing Page Editor → Add section → Library → Image banner midpage → Story Mode, then select its outline row. Open Content → Content details → Chapters.

Add a chapter

Fill the new chapter row and select Add. Repeat for each part of your story. Use Move up and Move down to change the sequence, or Remove to delete a chapter.

Write the chapter and choose its image

Enter Heading and Story text. Under Image, choose the Image and fill in Image description for alternative text. Editing the heading preserves the chapter's image and identity.

Choose the layout and optional link

Set Chapter layout to Image left, Image right, Image above, or Text only. Fill in both Button text and Button link if the chapter should take customers elsewhere.

Customers read the chapters in the saved order. In the normal chapter layout, Text only hides the chapter image; keeping an image saved lets you switch back later. A chapter button appears only when both its text and link are filled in. If the story is empty, add at least one chapter; if a button is missing, check both button fields. The earlier Story Mode reference describes presentation and motion behavior separately.

Image + Text Slideshow — slide content and playback

Choose Online Store → Landing Page Editor → Add section → Library → Image banner midpage → Image + Text Slideshow, then select its outline row. Open Content → Content details → Slides.

Control in each slideWhat it changes
Image → Image, Image descriptionThe desktop image and its alternative text.
Mobile image → Image, Image descriptionAn optional mobile image; without it, the desktop image remains the fallback. The mobile description is retained with your edits, but the customer image currently uses the desktop Image description, falling back to the slide title when that description is unset.
EyebrowThe short label above the slide title.
TitleThe slide heading. Editing it preserves the slide's saved image information and identity.
TextThe slide's body copy.
Button text, Button linkThe slide's CTA label and destination. Check both before publishing.

Fill a new row and select Add to create a slide. Use Move up, Move down, and Remove to maintain the sequence. Then open Behaviour → Playback & countdown:

ControlEffect and edge case
PlaybackManual scroll lets customers move through the slides; Autoplay rotates them automatically.
Slide interval (milliseconds)Sets the autoplay interval; the displayed default is 5000 milliseconds (5 seconds). It does not set the pace of Manual scroll.
Show playback progressDisplays progress during autoplay when there is more than one slide on the customer page. The progress animation respects reduced-motion preferences.

If the slideshow is empty, add at least one slide. If autoplay appears still, confirm Playback is Autoplay and there is more than one slide. The editor does not show the customer playback progress bar, so check that setting on the published page. If mobile imagery looks unchanged, check that the intended slide has a Mobile image rather than editing another slide's image.

Choose Online Store → Landing Page Editor → Add section → Library → Gift finder → Size Guide CTA, then select its outline row.

Set the destination and image

Open Content → Content details. Use Button link to choose the size-guide destination and Image to select the accompanying image.

Choose the presentation

Open Design → Layout. Set Layout to Image left, Image right, or Background image. Image right is the default. Background image places the chosen image behind the copy.

Check the guide as a customer

Save the draft and publish when ready. On the customer page, select the size-guide button and confirm that it opens the destination you chose.

The button is deliberately inactive in the editor preview. If it does nothing there, check the published customer page. If customers reach the wrong page, review Button link. This CTA links to the supplied destination; choosing it does not create a size-chart popup. Shared Design → Background remains available for the section background, separately from the image layout.

Ingredient Spotlight — ingredient pins and positions

Choose Online Store → Landing Page Editor → Add section → Library → Room inspiration → Ingredient Spotlight, then select its outline row. Open Content → Content details → Ingredient pins.

Control in each pinWhat to enter or change
NameThe ingredient name.
DescriptionThe ingredient's explanatory text.
Vertical position (%)A value from 0 to 100 for the pin's top-to-bottom position.
Horizontal position (%)A value from 0 to 100 for its left-to-right position.

Fill a new pin row and select Add. Use Move up, Move down, and Remove to maintain the order. Changing one position coordinate preserves the other coordinate. Shared Design → Background also remains available.

Customers see the ingredient names and descriptions from these pins when the detailed ingredient list is empty. If the section already has detailed ingredients, those names and descriptions take priority; the pin positions still apply to the detailed entries in matching order. Keep the pin order aligned with the detailed list. If a name edit seems ignored, check which list supplies the displayed content before changing it again.

Founder Story — show a founder title

Choose Online Store → Landing Page Editor → Add section → Library → Brand story split → Founder Story, then select its outline row. Open Content → Founder, turn on Show founder title, and enter Founder title, such as Founder and designer. These controls are already part of Founder Story.

The title input is hidden while Show founder title is off. In the founder-name presentation, customers see the title when the toggle is on and the title contains text. If it is missing, check the toggle and the text, save the draft, and publish the updated page.

Headline Collision — overlapping image and image description

Choose Online Store → Landing Page Editor → Add section → Library → Hero banner → Headline Collision, then select its outline row.

Write the headline first

Open Content and fill in the headline. Headline Collision shows nothing to customers while its headline is empty, so an image alone never appears.

Add the overlapping image

Open Content → Content details. Overlapping image is the picture that sits over the headline. Choose or upload one. Fill in Image description with a short sentence describing the picture; screen readers read it aloud and search engines use it. Leave it empty only for a purely decorative image.

Size and place it

Open Design → Layout. Image size is Small, Medium (the default) or Large. Image position (horizontal %) moves the image left (negative) or right (positive) from the centre of the section, from -50 to 50; the field shows 15 until you change it. Image position (vertical %) moves it up (negative) or down (positive), from -50 to 50; it shows 0 until you change it.

Align the text

Still in Design → Layout, Text alignment is Left, Center (the default) or Right. It aligns the eyebrow and headline and the button position.

Choose the stacking

Still in Design → Layout, set Image stacking to In front of headline (the default, the image covers part of the letters) or Behind headline (the letters sit over the image).

Save and check as a customer

Select Save, then Publish when ready, and check the published page at desktop and mobile widths.

If no Overlapping image is set, customers see the headline only; the size, position and stacking controls have nothing to act on. If the image is missing on the published page, confirm the headline is filled and the image was chosen, then publish again. If it hides too much of the headline, move it with the position fields or switch Image stacking to Behind headline.

Media sections — how-to for the latest polish

Each subsection starts from Online Store → Store Editor → Landing, then select the section.

Slideshow — slide copy, scrim and arrows

Open Content position (under Layout). It offers Over image and Below image; an untouched section behaves as Over image, so each slide's Heading, Body, and Button text with Button link now always show on the photo (earlier, a section whose position had never been saved dropped the copy).

  • Over image — copy sits at the bottom of the slide on a smooth dark fade that stays strong behind the text and clears toward the top, with a soft text shadow. A slide with no photo has no dark fade; its copy uses your page text colour on the light background.
  • Below image — the photo is clean and the copy appears centred under it, with the button in your accent colour.
  • Show arrows (under Transition & navigation) draws 48px round arrows on a darker, blurred backing so they stay visible on bright photos.

Why can't I read my slide text? Add a photo to the slide or switch Content position to Below image; very pale photos can still reduce contrast, so pick a darker crop.

Hero Split — button width

The Button text button now hugs its label instead of stretching across the whole text column. Nothing to set: shorten or lengthen Button text and the button follows. A full-width button on an older page means the page was not republished.

Split Hero Scrub — height, image pane and progress ticks

Open the section's Frames and Layout groups.

  • These are minimum heights, never a maximum, so the pane grows with its content. On a phone the image pane is at least 60% of the screen height or 32rem, whichever is smaller (68% or 34rem with a Media look). From 768px wide up, the text and image sit side by side and the section and image pane are at least one full screen height or 44rem, whichever is smaller.
  • With two or more Frames, small progress ticks sit at the bottom-left of the image pane; the current frame's tick is longer. They are decorative and are hidden from screen readers.
  • A frame with no image shows a faintly tinted pane in your text colour rather than a grey slab.
  • Text side (Left or Right) decides which side the image takes; the headline wraps in balanced lines and the subheading is kept to a readable width.

Why isn't the image or the progress ticks showing? A frame with no image shows only the tinted pane, and the ticks need two or more Frames; add an image to each frame under Frames. If the text is on the wrong side, change Text side under Layout.

Video Section — play button and header position

Open Video source (MP4, YouTube, or Vimeo), Playback, and Overlay content.

Get the play button

For an MP4 with Show player controls on and Autoplay off, the video first shows its poster with one large round play button over it (spoken to screen readers as "Play" plus your Heading, or "Play video" with no heading). Select it and playback starts; the browser's own control bar then appears. YouTube and Vimeo videos keep their own player, and a section using a Media look keeps the standard controls.

Place the header

In Display mode → Featured, Overlay content → Position moves the Eyebrow, Heading, and Body block: Center (default), Bottom left aligns it left, Bottom right aligns it right. Text color now colours the eyebrow and body as well as the heading. Inline mode always stays left-aligned.

Why is there no play button? Show player controls is off, Autoplay is on, the source is a YouTube/Vimeo link, or the video has not yet scrolled into view.

Video Hero Overlay — captions and poster

Open Captions. Captions show by default: type the line in Caption text, and turn Show captions off to hide it. The caption appears as a small pill over the video only when Caption text has something in it; with the text empty, nothing is drawn. This is the on-screen text for people watching without sound, not a subtitle file. The Poster image you set under Video is also given to the video itself, so it shows before playback starts.

Why isn't my caption showing? Caption text is empty (only spaces counts as empty), Show captions has been turned off, a Content position (the nine-point grid) is set on the section, which hides the caption pill, or the page was not republished after you typed it. A poster that does not appear means Poster image is empty under Video.

Hero Video — captions file

Captions (VTT) URL (in the Video group) attaches a subtitle track. Leave it empty and no track is added at all — nothing is broken and the browser console stays clean. Add a VTT link to give viewers a captions option in the player.

Why don't viewers see a captions button? Captions (VTT) URL is empty, the link does not open a valid VTT file, or the video is a YouTube or Vimeo link. The field works for uploaded (native) video only; YouTube and Vimeo embeds get no captions track, so use their own caption settings.

Parallax Band and Mid-Page Banner — empty banners

A Parallax Band or Mid-Page Banner with no image and no copy (no eyebrow, heading, subheading, or button that has both label and link) is not published: customers see no grey slab. In the Store Editor the empty banner stays visible so you can still select and fill it. A Parallax Band with copy but no image shows its text on the muted fallback, with the text colour corrected automatically if it would be hard to read.

Why did my banner disappear? Add an image or at least a heading to it and republish.

Image description on banners

Parallax Band and Mid-Page Banner (Image banner midpage) each have an Image description field under Online Store → Landing Page Editor → select the section → All settings → Content → Content details. It is the image's alt text, read by screen readers and used by search engines. Describe what the picture shows; keep it short. When you replace the picture through the Image field, the description you already entered is kept, so update it only if the new picture shows something different.

Choose a countdown look

In Online Store → Store Editor → Landing, select a section that has a countdown, open Design → Countdown look, and choose a tile. The four campaign treatments are:

  • Campaign badge pairs the deadline with the section's existing campaign or collector badge.
  • Coupon ticket places an existing redeemable coupon beside the deadline; its copy action still uses the configured coupon, not a sample code.
  • Availability rail pairs the deadline with actual stock or delivery progress.
  • Product window places the section's configured product image beside the deadline.

A look changes appearance, not campaign content. Set the end time, coupon, product image or progress using that section's existing controls. If a section does not supply the content a treatment needs, the storefront shows its timer instead; choosing a tile does not invent a badge, coupon, stock count or product image. For example, Free Shipping Banner supplies coupon and delivery-progress treatments, but does not supply a product image for Product window.

On Announcement Bar and Free Shipping Banner, the four campaign tiles remain visible but cannot be selected in a short bar. Each shows Needs an 80px+ bar. Increase Announcement Bar's Bar height (px) to at least 80, or set Free Shipping Banner's Height to Tall, then return to Countdown look. The original and simpler timer treatments remain usable in short bars.

Choose Reset look to return to the original timer appearance. This does not clear your deadline, coupon or other campaign content. Click Save, reopen the same section and check the selected tile before publishing. Saving a draft does not publish it. If the timer is missing, check that countdown display is enabled, that an end time is set and that the campaign has not expired; changing its appearance does not restart it.

Countdown date picker and draft troubleshooting

End time uses the store timezone printed beside the picker and saves an absolute UTC time. While the timezone loads, the date input is disabled. If it cannot load, the picker becomes available after 5 seconds with a message such as Store time could not be loaded. Using Asia/Kolkata; check the time before saving. Check the displayed timezone and intended deadline before saving. A later valid settings response can update the displayed timezone without changing the saved deadline.

If customers still see old content after Save, check whether you published that draft and whether you are viewing the intended page. For the broader save and publish workflow, see the Landing Page Editor guide.

Linking buttons and CTAs

View All destinations and product-card actions

In the Store Editor, open a supported section, then open View all link → View all link. Turn on Show view all link; this reveals Link URL and Link text. The switch is off by default, so a section using the new shared control adds no View All link until you opt in. Set Link URL when you need an explicit destination and Link text when the button needs custom wording, then save and publish.

When a supported section can derive a destination and Link URL is empty, one category uses /products?category= followed by that category's ID, a collection uses /collections/ followed by its slug, review sections use /reviews, offers use /offers, and general product feeds use /products.

On product cards, add-to-cart is immediate only for simple products; a product with variants opens its product page. Category and collection cards navigate to their browse destination, and testimonial cards never receive product cart actions.

Why don't customers see the View All link, or why does it go nowhere?

Reopen View all link on the same section instance and confirm Show view all link is on. If the section cannot derive a usable destination, fill Link URL explicitly. Confirm the referenced category, collection, or custom destination still exists, then save, publish, and refresh the storefront.

Any field that points somewhere else — a button, a "shop now" link, a card's click target — opens the same link picker instead of a raw URL box. Choose one of four link types:

  • External URL — any full web address, validated as you type.
  • Collection / Category — search and pick one of your store's categories.
  • Product — search and pick a specific product.
  • Page anchor — jump to another section further down the same page, picked from a list of the page's current sections.

Dynamic text variables

Use a dynamic text variable when a section should show current store, date, or customer information instead of fixed copy.

Open the section's text field

Go to Online Store → Pages, open the page in the Landing Page Editor, select the section, and open its Content tab. Place your cursor in the headline, body-copy, or other text field where the value should appear.

Open the variable menu

Select the small code icon — two angle brackets — at the end of the field. Its tooltip is Insert variable. The menu is grouped under STORE, DATE, and CUSTOMER, and includes a Search variables... box.

Insert the variable

Select a menu item. The editor inserts its complete token at the cursor; keep both pairs of braces and do not change the text inside them.

  • Store name — {{store.name}} shows your company name, or your store name if no company name is set. If neither is available, it shows Your Store.
  • Support email — {{store.email}} shows the public support email from your store's contact details. If none is available, it shows support@store.com.
  • Today's date — {{date.today}} shows the current date, formatted for the storefront language. It does not depend on a saved field.
  • Current year — {{date.year}} shows the current four-digit year. It does not depend on a saved field.
  • First name — {{customer.firstName}} shows the signed-in customer's first name. When no name is available, it shows there.
  • Email — {{customer.email}} shows the signed-in customer's email address. When no email is available, the token becomes empty text.

Signed-out visitors get the fallback for both customer variables: there for First name and empty text for Email. The editor preview shows a realistic fallback value so you can see roughly how the text will read.

A mistyped or unsupported token is not removed. The storefront shows it to visitors exactly as you typed it, including its braces, so you can find and correct it.

The Footer editor's Copyright text uses its own separate copyright mechanism; these landing-section variables do not change how that field works.

Why do visitors see a token instead of a value?

The token is unsupported or mistyped. Reopen the field, remove it, then use Insert variable to choose one of the six supported menu items above.

Why does the greeting say "there"?

The First name variable falls back to there when the visitor is signed out or their account has no first name. This lets copy such as "Hello, {{customer.firstName}}" remain readable without showing a blank name.

Recurring controls: Eyebrow, Motion, Badge & Image Style

Several small control groups appear across a wide range of sections — rather than repeat the same explanation on every section above, here's what each one does and roughly which sections have it.

Eyebrow — a short label line shown above a section's heading (e.g. "NEW COLLECTION"). It comes in two variants, matched to what that section's renderer actually reads — you can't switch a section between them, so a section only ever shows the fields for its own variant:

  • Plain text — a single Eyebrow Text field, nothing else. Sections: FAQ, Collection Showcase, Mega Category Grid, Shop by Concern, Dynamic Showcase, New Arrivals, Product Bundles, Trending Now, Certifications, Customer Reviews, Guarantee Banner, Influencer Picks, Instagram Feed, UGC Gallery, and Size Guide CTA.

  • Text + style + color — an Eyebrow Text field, an Eyebrow Style picker (Caps, Dash, Numbered, Theme), and an Eyebrow Color swatch. Sections: Back in Stock, Free Shipping Banner, Gift Finder, Limited Edition, Low Stock Alert, Referral Program, Subscription CTA, and Wishlist Reminder.

  • Text + style — an Eyebrow (optional) text field and an Eyebrow style switch with Caps, Dash, Numbered and Theme. Sections: Deal of the Day, Setup Guide and Meal Planner. Caps is the default; Theme also renders caps. A plain-text eyebrow saved earlier stays visible and is upgraded the first time you edit it. Deal of the Day also has a separate Eyebrow text field that is used first; the style group there is labelled Eyebrow (fallback) and is used when that field is blank.

Motion — an entrance-animation setting for the section as it scrolls into view: a Motion Preset picker (Fade, Slide Up, Zoom, Stagger, Text Reveal, or None to turn the animation off), an Easing picker (Standard, Emphasized, Spring), and a Duration (ms) field. Sections: Back in Stock, Deal of the Day, Limited Edition, Low Stock Alert, and Shop By Room.

Note

This is the first entrance-animation control any of these five sections has had — previously whatever motion they had, if any, was fixed and couldn't be turned off. Pick None to disable it.

Badge — a small pill-shaped label (e.g. "NEW", "BESTSELLER") with a Badge Text field (leave it blank to hide the badge entirely), a Badge Style picker (Pill, Square, Minimal), and Badge Background Color / Badge Text Color swatches. Sections: Shade Finder, How It Works, Sustainability Story, Timeline, Setup Guide, Seasonal Edit, Meal Planner, Nutrition Highlights, Recipe Cards, Room Inspiration, and Image Collage.

Badge Style — Square currently looks the same as unset

On the sections listed above, only Pill (fully rounded corners) and Minimal (sharp corners) currently render differently from each other — picking Square renders the same as leaving the style unset. It's a safe choice, just not visually distinct yet.

This is a different, newer control from the Hero Banner's Badge Text (Eyebrow) field and the Hero Carousel's per-slide badge described under Hero & banner sections above — those use their own, older field shapes and aren't affected by anything in this section.

Image corner radius — an Image corner radius dropdown (labeled exactly that in the field itself) sits in the Design tab's Image treatment group on every section built around a photo or product image — around a hundred sections across the library, from hero and category imagery down to review-photo tiles. Choose None (square corners), Small, Medium, Large, Extra large, or Pill (fully rounded); leave it on Default (theme) and the image keeps whatever corner rounding your active theme already applies. A section you built before this control shipped renders exactly as it did — Default (theme) resolves to your theme's existing radius, not a fresh square or round default, so nothing changes until you deliberately pick a value.

Some sections apply this to a card, not just the raw image

On a handful of sections — Store Events is one — this control's radius is applied to the image's own rounded container inside a card layout, rather than to a single standalone photo. If a section's images sit inside cards, expect the radius to shape that image slot specifically, not the whole card's outer corners.

Image Shape and How images fill the shape are separate from corner radius. Collection Showcase offers both controls; see Collection Showcase image shape and fill. Hero Video has a fixed video frame with a fill control; see Hero Video — video image treatment.

Image treatment — corner radius, aspect ratio and fit (Store Editor v3)

Many image-led sections share one Image treatment group. Open Online Store → Landing Page Editor → select the section → Design → Image treatment. It has up to three controls:

  • Corner radius — None, S, M, L, XL or Pill. Rounds the corners of the section's images.
  • Image aspect ratio — Original, Square, 4:5, 3:4, 4:3, 3:2 or 16:9. Original keeps each image at its own shape. Leave it unset for the section's default crop.
  • How images fill the shape — Fill shape crops the image to the frame; Fit inside keeps the whole image visible.

Every control starts unset. An untouched section renders exactly as it did before, so existing pages do not change until you choose a value. Choosing an aspect ratio or fit also records that the crop was set on purpose; clearing the control returns the section to its own default.

Which controls a section shows:

Controls shownSections
Corner radius onlyHero Banner, Hero Carousel, Slideshow (full-image), Skin Quiz CTA, Free Shipping Banner, Content Slider, Certifications, Image Gallery, Instagram Feed, Marquee, Press Logos Band, Press Mentions, Stats Counter, Trust Badges, UGC Gallery, Video Testimonials, Why Us, New Arrivals, Product Comparison, Recently Viewed, Shop by Brand, Shop by Category, Shop by Concern, Shoppable Video, Trending Now
Corner radius and aspect ratioFounder Story, Multi-Column
Corner radius and fitBrand Story Split, Hero Video (shown as Video image treatment), Image Banner (mid-page), Customer Photo Wall, Lookbook, Video Section, Video Spotlight Carousel, Category Circles, Collection List, Featured Collection, Promo Tiles, Shop by Price, Tabbed Products, Sticky Add to Cart
Corner radius, aspect ratio and fitHero Split, Slideshow (split), Video Hero Overlay, Best Selling, Complete the Look, Deal of the Day, Featured Product, Flash Sale, Gift Finder, Influencer Picks, Product Tabs, Shade Finder

Two sections name the group differently. Hero Product Showcase offers Image Shape (aspect ratio) and How images fill the shape, and only when a background image is shown (turn on Show background image first). Split Hero Scrub offers radius only, as Frame image corner radius.

Note

Two sections hide the group until it can apply. Shop by Price shows it only when Layout is Cards (only the Cards layout shows images). Sticky Add to Cart shows it only when Show product image is on. In Shop by Concern, the radius applies only to tiles with no Shape set; a tile with its own Shape keeps its own corners.

Where aspect ratio and fit take effect. Corner radius is applied by every section in the table. Aspect ratio and fit reach the published image on the sections that offer them, including:

  • Featured Collection and Tabbed Products (the classic product card), Flash Sale, and every Best Selling layout. In Best Selling a saved Image aspect ratio takes priority over the item style's own aspect ratio.
  • Complete the Look, Product Tabs, Shade Finder (main image; swatch thumbnails keep their own crop), Deal of the Day, Gift Finder, Hero Split, Slideshow (split), Video Hero Overlay, Collection List, Category Circles, Promo Tiles, Lookbook, Customer Photo Wall, Video Section, Video Spotlight Carousel, Image Banner, Sticky Add to Cart, Timeline, Blog Posts and Blog Preview.
  • Featured Product (fit applies to the main image and thumbnails) and Influencer Picks (the grid picks and the Instagram frames).
  • Comparison Carousel: fit applies to the slider, button, split and fade comparisons. The Grid layout comparison still crops to fill.

Shop by Price offers corner radius and fit only; the editor no longer offers an aspect ratio control there. A section with no saved image treatment looks the same as before.

Tip

Why don't customers see my aspect ratio or fit? Check that the change was saved and published, and look at the published page, not only the editor preview. Only sections that offer the control honour it, and only where the section draws images in that spot. If Image treatment is missing, the section's layout does not draw images (see the note above).

Image treatment on editorial sections (Store Editor v3)

The same Design → Image treatment group is on these sections, with these specifics:

  • Blog Posts, Blog Preview and Timeline: corner radius, aspect ratio and fit. In Blog Preview, Design → Image treatment → Card shape → Post image aspect ratio (Square, Portrait 3:4, Landscape 4:3, Widescreen 16:9) sets the post image crop; it is hidden once Image aspect ratio above is set, because that one takes precedence. Leave both unset for the default 4:3 crop (16:9 on the featured card).
  • Customer Reviews: corner radius sits in the Testimonial images fieldset. The radius there does not reach the Standard and Product-focused cards. Review card shape → Card aspect ratio (Square or Wide) applies to the Standard and Product-focused review cards only.
  • Comparison Carousel: corner radius and fit.
  • Recipe Cards and Sustainability Story: corner radius.
  • Newsletter CTA: corner radius, for the Split layout (variant C) only. Variants A and B ignore it.
  • How It Works: corner radius, for step photos only. Steps whose media type is not Photo (icon or video) ignore it.

Tip

Why doesn't my corner radius show on Newsletter CTA or How It Works? Check the layout (Split only) or that the step's media type is Photo.

Hero family — extra layout and image controls (Store Editor v3)

These controls sit in the section's Design tab. For each, select the section first: Online Store → Landing Page Editor → select the section.

  • Parallax Band — Image parallax strength. Design → Layout → Image parallax strength is a slider from 0 to 1 in steps of 0.1; it shows 0.4 until you change it. Higher moves the image more as visitors scroll; 0 keeps the image still. Visitors whose device asks for reduced motion always get a still image. This is separate from the section background Parallax setting. The band's copy also follows Design → Typography scale → Font family now; leave it unset to keep the band's own font.
  • Referral Program — Background image opacity. After you add a Background image (Design → Layout), Background image opacity appears: 0 to 100 in steps of 5, showing 100. 100 is full strength; lower values fade the image into the section colour. Until a background image is set the control is hidden ("Add a background image first.").
  • Image + Text Slideshow — Text position. Design → Layout → Text position is Beside the image (the default), Over the image, centred or Over the image, bottom.
  • Hero Carousel — Slide style (all slides). Design → Slide style (all slides) sets defaults for every slide; a slide can still override its own aspect ratio and text case.
    • Slide image aspect ratio — Inherit, Square 1:1, Portrait 3:4, Landscape 4:3 or Wide 16:9. A slide with its own aspect ratio wins.
    • Colour wash over slides — tints every slide image at 35% strength.
    • Text-side scrim — 0 to 100 in steps of 5. It is an edge gradient behind the text. 0 switches the scrim off and also removes the automatic one; unset keeps the automatic scrim.
    • Scrim direction (Side to side or Top to bottom), Scrim start colour and Scrim end colour appear only once the scrim is above 0 ("Set the text-side scrim above 0 first.").
    • Slide text color, Slide text font size, Slide text font weight (Inherit, or 300 to 900) and Slide text transform.

Tip

Why don't customers see the new look? Unset controls leave the section exactly as before, so nothing changes until you pick a value. For Referral Program the opacity only appears with a background image, and for Hero Carousel the scrim colours only appear with the scrim above 0.

Nutrition Highlights — build the panel (Store Editor v3)

Choose Online Store → Landing Page Editor → Add section → Library → Nutrition Highlights, then select its outline row.

Write the heading

Open Content. Fill in Eyebrow, Heading and Subheading.

Add highlights

In Highlights, add one row per nutrient or claim. Each row has Label, Value, Unit (for example g, mg or kcal), Icon and Accent color. Icon offers Seedling (protein), Flame (calories), Leaf, Water drop, Box (serving) or Custom emoji. Choosing Custom emoji shows a field named Custom emoji or icon name; clear it to go back to the preset icons.

Add the product image and badge

Set Product image and, optionally, Mobile product image (shown on phones; falls back to the product image). In Badge, set Badge text, Background, Text color and Badge shape (Pill, Square or Minimal).

Choose the layout

Pick Display style: Split (the default; a list beside the image), Cards (a two-column grid) or Table (nutrition label style), which shows value and unit with no image. Mobile image layout is Stack, image on top, Stack, image below or Hide image on mobile; unset, Split puts the image on top and the other styles put it below.

Colour the icons

Open Design → Highlight colors. Section accent color is the icon-circle colour for every highlight. Turn on Allow per-highlight colors to use each row's own Accent color. For the rounded corners of the product image use Design → Image treatment.

Tip

Why don't customers see the image or icon colours? The Table style has no product image and no icon circles, so Mobile image layout, Section accent color and Allow per-highlight colors are hidden for it. Per-row Accent color is ignored unless Allow per-highlight colors is on.

Why is my Nutrition Highlights stats panel full width?

On a Refined Nutrition Highlights with no product image set, the live store drops the image half and the stats panel takes the full width. Add a product image to get the two-column layout back. The editor is unaffected.

Trust Badges — Card style (Card grid variant)

Open Online Store → Landing Page Editor → select the Trust Badges section → Content → Card style. The group appears only for the Card grid variant (Variant B); other variants hide it.

Controls: Card background, Border color, Border width (0 to 8 px, starts at 1), Corner radius (0 to 40 px in steps of 2, starts at 8), Shadow (None, Soft, Medium, Bold) and Hover effect (None, Lift, Zoom, Brighten, Glow).

Your first edit fills the other card values with the defaults the section was already using, so changing one control does not unexpectedly restyle the rest. Once a card style exists, it replaces the built-in card look as a whole.

Tip

Why don't customers see my card style? It only applies to the Card grid variant. Switch the section variant first, then set the card style.

Alternating Columns — rows, image shape and side

Open Online Store → Landing Page Editor → select the Alternating Columns section → Content.

  • Image & text rows: Rows, where each row has Image (with Alt text), Eyebrow, Heading, Body, Button text and Button link, and Image shape, which is set per row: Square (1:1), Landscape (4:3) (the default), Portrait (3:4), Wide (16:9) or Photo (3:2).
  • Layout & motion: Image side (Alternate left and right (the default), Always left or Always right), Text alignment (vertical: Top, Center (the default) or Bottom), Space between rows and Section padding (each None, Small, Medium or Large), and Entrance motion (Reveal (the default) or None).

Tip

Why don't customers see my change? Save and publish, then check the published page. Image side, spacing and padding apply to every row at once; image shape is set on each row.

Card, spacing and heading controls on product sections (Store Editor v3)

  • Flash Sale — Card look. Design → Card look: Card shape (Default (rounded), Rounded, Square, Pill, Circle), Card shadow (Default (none), None, Subtle, Medium, Strong), Card background, Card border color and Card border width (0 to 8 px). These apply only to the Legacy card system and are hidden when Card system is Universal.
  • FAQ — Item card. Design → Question & Answer Style → Item card: Item card background, Item corner radius (0 to 48) and Item border width (0 to 8).
  • Last row alignment. In Featured Collection, Complete the Look and Tabbed Products: Content → Layout → Last row → Last row alignment is Start, Center or End and places an incomplete final row of products. In Featured Collection it shows only for grid layouts, not carousel or scrollable ones.
  • Section padding. Featured Collection and Dynamic Showcase: Content → Layout → Section padding is None, S, M or L.
  • Complete the Look — Grid gap. Content → Layout → Grid gap: None, Tight, Default or Airy.
  • Hero Product Showcase — heading and subheading text. Design → Heading typography and Subheading typography: colour, font size and font weight for each. The font family comes from Design → Typography scale → Font family.
  • Shop by Concern — Heading typography. Design → Heading typography: Heading style, Heading decoration, Heading transform and Heading alignment. Alignment is hidden once a component look controls it.

Note

A colour field in these groups cannot be cleared by emptying the hex box. Use the row's Reset instead.

Card size, View all and button looks on product sections

  • Card size. In Design → Layout, Card size (S, M, L, XL or Custom, with Custom card width (px)) fits as many cards of that width as each row allows. Once set it wins over the Columns setting in Collection Tabs (grid layout) and Seasonal Edit (grid). Unset, the column count decides as before.
  • View all in a grid. Collection Tabs in its grid layout now shows the View all link you configured for the section (its label and link). The carousel layout keeps its own link.
  • Call to action look. In Collection Tabs and Dynamic Showcase, a look chosen under All settings → Design → Call to action look styles the Add to cart button. It needs Show add to cart buttons (Product actions) turned on. With no look chosen, the button is unchanged.
  • Composite carousel. Its View all link goes to the section's configured View all link, falling back to the all-products page. Turning wishlist off for an item hides its heart.
  • Custom HTML. Design → Typography scale → Font family now applies to the section's content; unset, nothing changes.
  • Influencer Picks. The featured portrait keeps the Corner radius saved under Design → Image treatment.

Tip

Why don't customers see the new button look or card size? The button look needs Show add to cart buttons on. Card size only overrides Columns once a size is chosen, and only in the grid layouts named above.

Presentation — Classic or Refined (Store Editor v3)

Every section whose contract supports it has a Presentation control with two choices: Classic and Refined. Classic is the original look. Refined is the premium treatment, with more even spacing and a tidier layout. The control's own hint reads "Refined adds the premium card treatment. Classic keeps the original look."

Sections with the control: Why Us, Influencer Picks, Trust Badges, Skin Quiz CTA, Seasonal Edit, Dynamic Showcase, Gift Finder and Compatibility Checker.

Eleven more sections have it too: Multicolumn Alternating, Slideshow (non-hero), Promo Popup, Newsletter Popup, Image Banner (mid-page), Parallax Band, Video Section, Tabbed Products, Collection Tabs, Blog Posts and Blog Preview. Their hint reads "Refined adds the premium treatment. Classic keeps the original look." (The Newsletter Popup, Parallax Band and Collection Tabs hint says "premium card treatment".)

The remaining sections carry the same two-button switch. The single sections include: AR Preview CTA, Back in Stock, Best Selling, Book an Appointment, Calculator, Cascading Lookup, Collection List, Collection Showcase, Comparison Carousel, Content Slider, Customer Photo Wall, Divider, FAQ, Flash Sale, Founder Story, Free Shipping Banner, Gift Card Band, Hero Countdown, Hero Split, Lookbook, Low Stock Alert, Multicolumn, New Arrivals, Promo Banner, Recently Viewed, Recipe Cards, Referral Program, Room Inspiration, Shop by Room, Split Hero Scrub, Stats Counter, Sticky Add-to-Cart, Store Locator, Subscription CTA, Sustainability Story, Timeline and Trending Now. Six are the composite sections: Carousel, Grid, Marquee, Split, Stack and Tabs. On the composites the switch is a drop-down labelled Presentation under Design → Appearance; its two options are Classic and Refined. On the other single sections, the switch sits in its own Presentation group on the Design tab (Design → Presentation), the only control in that group.

Open the section

Choose Online Store → Landing Page Editor → select the section, then open the tab shown in the table below.

Open the group

Open the group named in the table. Presentation is a two-button switch.

Pick Classic or Refined

Click Refined to turn the premium treatment on, or Classic to go back. Publish the page to change the live storefront.

SectionTabGroupWhat Refined changes
Why UsDesignCard lookA card whose icon name the storefront cannot draw loses its empty icon circle. Cards with no icon keep an invisible spacer, so card text lines up when only some cards have icons.
Influencer PicksDesignCardsEach influencer's picks sit in a centred grid of tiles 9 to 11 rem wide instead of a fixed 2 or 3 columns. A pick's name shows under its tile instead of on a dark strip over the image. The influencer name uses a slightly smaller heading size. The portrait area is dropped when an influencer has no image.
Trust BadgesContentLayoutThe panel gets 40 to 72 px of vertical and 20 to 40 px of side padding. The heading has a clear gap above the badges and uses a semibold weight. This applies to every variant.
Skin Quiz CTADesignLayoutThe panel gets the same padding. The background tint becomes a centred wash instead of a fade from the left. The text block is centred, with space under the eyebrow and heading, and the subheading is capped at a readable width. A button style the section does not recognise renders as a filled button instead of a plain text link.
Seasonal EditDesignLayoutThe heading, description and image become a full-width two-column intro, with the product grid below it at full width. Classic keeps a narrow sticky sidebar beside the grid. The image uses a 4:5 frame unless an image look is set. Spacing under the eyebrow, heading and description is wider.
Dynamic ShowcaseDesignSpacingThe panel gets the same padding. The heading row has a clear gap above the items. In the multi-item row, items start at the left edge instead of being centred.
Gift FinderDesignLayoutThe quiz card becomes a flat card with a hairline border, no shadow, a corner radius capped at 16 px, and padding that shrinks on narrow screens. The quiz intro text is left-aligned.
Compatibility CheckerDesignLayoutThe empty Not Compatible warning panel is hidden when you have listed no incompatible devices. The centred block gets a little side padding on small screens.
Multicolumn AlternatingDesignSpacingSwitches the image-and-text rows to the premium treatment. Its other groups are Image & text rows and Layout & motion.
Slideshow (non-hero)DesignLayoutSwitches the slideshow to the premium treatment.
Promo PopupDesignLayoutSwitches the popup to the premium treatment.
Newsletter PopupDesignLayoutSwitches the popup to the premium treatment.
Image Banner (mid-page)DesignLayout & styleSwitches the banner to the premium treatment.
Parallax BandDesignLayoutSwitches the band to the premium treatment.
Video SectionDesignVideo layoutSwitches the video block to the premium treatment.
Tabbed ProductsDesignLayoutRefined card, tab and call-to-action spacing.
Collection TabsDesignLayoutRefined card, tab and call-to-action spacing.
Blog PostsDesignLayoutRefined card, tab and call-to-action spacing.
Blog PreviewDesignLayoutRefined card, tab and call-to-action spacing.

Complete the Look and Subscription CTA on Refined

On a Refined Complete the Look, a look with no products and no featured image renders nothing on the live store, and a look with no products hides the add-all bundle button (default label Add All to Cart) even when the add-all button is switched on. The editor still shows the section so you can fill it in. On a Refined Subscription CTA with no image set, the picture area shows a line-art box icon in your store's accent colour; Classic shows a 📦 emoji instead.

Troubleshooting "why doesn't my Complete the Look show?": add at least one product (or a featured image), then republish.

Which one will a section use?

  • A section added from the library starts as Refined. Every section type listed above seeds the Refined value when you add it, so a freshly inserted section already has the premium treatment on; check the switch if it looks different.
  • Every section already on a page keeps the Classic look. Classic is stored by leaving the setting empty, and an empty setting always renders the original markup, so a platform update does not restyle pages you already built.
  • Applying a preset from a composite section's preset grid (Design tab) keeps the section's Refined look; it no longer drops back to Classic.
  • Refined is opt-in. A section you already have stays on Classic until you choose Refined; new sections you add start on Refined.
  • You can switch either way at any time. Switching to Classic removes the setting from the saved section; switching to Refined saves it again. Your content (text, images, items) is not touched.

Tip

Why does my older section still look the same after an update? It is on Classic. Open the section, find Presentation in the group shown above and click Refined. Why did a new section look different from an old one of the same type? The new one started as Refined; set the older one to Refined, or the new one to Classic, to match them.

Note

Not seeing Presentation? It exists only in the Store Editor v3 and only on sections whose contract supports it (the sections above, plus others such as Rich Text and Collapsible Content). Open the tab and group named in the table: Trust Badges lists it under Content → Layout, Dynamic Showcase and Multicolumn Alternating under Design → Spacing, Why Us under Design → Card look, Influencer Picks under Design → Cards, and the rest under Design → Layout (the exceptions are Image Banner (mid-page) under Design → Layout & style and Video Section under Design → Video layout).

Hide section when empty (Blog Posts, Blog Preview, Tabbed Products, Collection Tabs)

Blog Posts, Blog Preview and Tabbed Products have a Hide section when empty switch in the same Design → Layout group as Presentation. Collection Tabs has the same switch on the Content tab in its Product actions group, next to Show add to cart buttons. Blog Posts also repeats the switch on the Content tab under Posts, and Tabbed Products under Category tabs; both places edit the same setting.

Open the section

Choose Online Store → Landing Page Editor → select Blog Posts, Blog Preview, Tabbed Products or Collection Tabs.

Switch it on or off

Find Hide section when empty: on Blog Posts, Blog Preview and Tabbed Products it is under Design → Layout; on Collection Tabs it is under Content → Product actions. Its hint reads: "On the live store, hides this section while it has nothing to show. The editor still shows it so you can add content."

With it on, the live store drops the section while it has nothing to show: Blog Posts when it has no posts, Tabbed Products when no category tab has a product. The editor keeps showing the section so you can fill it. Sections added from the library after this change start with the switch on. Sections already on a page keep their saved value; if it was never set, the section renders as before.

Tip

A section vanished from the storefront, why? It has no posts (Blog Posts, Blog Preview) or no products (Tabbed Products), and Hide section when empty is on. Add content, or switch it off to show the empty section again.

Custom HTML — Refined copy layout

Custom HTML has two extra controls in its Custom HTML group on the Content tab.

Turn on Refined copy layout

Choose Online Store → Landing Page Editor → select the Custom HTML section → Content → Custom HTML and switch on Refined copy layout. Its hint reads: "Pads copy-first snippets (a heading, text and button) and gives the button an outlined style. Leave off to keep your HTML exactly as written."

Pick Refined layout alignment

Refined layout alignment appears only once Refined copy layout is on. Choose Left (default) or Centre to centre such snippets. While the switch is off the control stays hidden, with the note about turning on Refined copy layout first.

Tip

Why did my HTML not change? Both controls are off by default, so existing HTML renders exactly as written. Why is there no alignment control? Refined copy layout is off.

Controls moved from Content to Design (Store Editor v3)

In Store Editor v3 a set of shared look controls live on the Design tab, grouped by purpose, whichever section you are editing:

ControlDesign groupWhere to find it now (any section that has the control)
Background colourBackgroundDesign → Background → Background colour
Text alignmentTextDesign → Text → Text alignment
Heading sizeTextDesign → Text → Heading size
ColumnsLayoutDesign → Layout → Columns
Columns on mobileLayoutDesign → Layout → Columns on mobile
Content positionLayoutDesign → Layout → Content position
Gap between itemsSpacingDesign → Spacing → Gap between items
Space around sectionSpacingDesign → Spacing → Space around section

If you look for one on the Content tab, a pill there reads for example "Card look: Moved to Design → Card look" (or "Heading look: Moved to Design → Heading look") and jumps you to the new place. The inspector search box also finds a moved control by its old name, for example type "Columns" and the control appears with its Design group shown. Values you saved earlier are unchanged; only where you edit them moved.

Smaller Store Editor v3 controls

Story Mode — Look. Choose Story Mode → Design → Layout → Look and pick Classic or Refined. Its hint reads "Refined adds the premium chapter treatment. Classic keeps the original look." Classic is stored by leaving the setting empty, so Story Mode sections already on a page keep their original look until you click Refined. Your chapters are not touched.

Not seeing it? Look is on the Design tab, not Content, and only in Store Editor v3. If the page still looks the same after you pick Refined, publish the page; the editor preview and the live store update separately.

Meal Planner — Text alignment. Choose Meal Planner → Design → Layout → Text alignment and pick Left, Center or Right. It is saved as the section's layout alignment, which the storefront reads first; an older saved alignment still shows in the control until you change it. An unset value renders centred.

Not seeing it? Text alignment is on the Design tab in the Layout group, not on Content. Its hint says it applies when a component look is selected; with no look selected it will not change the storefront.

Recently Viewed — card controls. Under Design → Layout: Card preset (Default, Editorial, Minimal, Bold), Premium card geometry (Standard cards or Contained editorial grid, which only affects the Grid layout) and Card system (Legacy or Universal). Under Design → Card look: Card background (colour) and Product title style with Title colour and Title size (8 to 48 px). Leave them untouched and existing cards render as before. Why do my cards look unchanged? Card system is on Legacy and Card preset on Default.

FAQ — Answer color. In FAQ → Design → Question & Answer Style the Answer color swatch colours the answer text. The group also holds Item background, Active item background, Question color and Icon color.

Not seeing it? The group is on the Design tab, not Content. An older editor shows the same colours as Answer Color and so on, on the Style tab.

Hero Banner — button colours. Under Hero Banner → Content → Buttons, Primary button appearance edits the primary button's colours and corner radius, and Secondary button appearance edits its background, text and border colour. Unset values follow the active theme. Which primary options appear depends on the layout: a text-link button shows only text colour, and a few layouts show colour and corner radius without text colour.

Not seeing it? Primary button appearance is hidden when the hero is an absorbed variant of another section and when the layout is the offer strip with a text link, which uses a fixed colour. Secondary button appearance appears only after you type Secondary button text. Both are on the Content tab under Buttons.

View all and button links. A View all link whose address is unsafe (starting with javascript:, vbscript: or data:) is not used on the storefront; the section falls back to its default safe destination instead. If a link goes somewhere you did not type, check it for one of those prefixes.

Decorative shapes

Every section's Design tab has a Decorative shapes group — it's a shared group every section has, not a per-section add-on. Click + Add Shape and a row appears with a Shape picker (Circle, Blob, Square, Ring, Triangle, Dots), a Position picker (top-left, top-right, bottom-left, bottom-right, center-left, center-right), a Color field, a Size (px) field, and an Opacity field (0–1). Add as many shapes as you want; each gets its own remove button.

Shapes now paint above the section background

Decorative shapes used to sit behind a section's own background color or image and were invisible on any section with an opaque background — only sections with no background at all ever showed them. They now stack above the section's background by default, so a shape you add is visible regardless of what background the section has. If you added shapes before this fix and never saw them appear, they're there now — open the section's Design tab to check its Decorative shapes list.

Typography enum axes — for Hero Banner, Hero Split, Hero Video, and Featured Product in the current Store Editor, use Rich heading and subheading typography in the current Store Editor above. Other section panels whose Design tab has a Heading typography, Subheading Typography, or Description Typography accordion (next to that accordion's existing Color, font weight, and font size fields), four more controls now sit inside it: a Text align button row (Left/Center/Right/Justify), a Style toggle (Normal/Italic), a Decoration toggle (None/Underline/Strikethrough), and — heading, subheading, and description accordions all get it — a Text transform dropdown (Default/None/Uppercase/Lowercase/Capitalize). None of these accordions write anything on their own just by being open; an existing section keeps rendering unchanged until you actually change one of these fields. Sections with at least one of these accordions: Hero Product Showcase, Hero Countdown, Flash Sale, Founder Story, Shop by Category, Mega Category Grid, Why Choose Us, Pricing, Customer Reviews, and FAQ — not every listed section has all three accordions (Hero Countdown, for example, has Heading and Subheading Typography but not Description Typography).

FAQ has a second, separate heading typography control

FAQ's own Heading Style group, described under Content & brand-story sections above, is a different, older control living in FAQ's own Content tab — it already exposed these same four axes before this update. The Style-tab Heading Typography accordion described here is a second, independent control on the same section; setting one doesn't change the other.

Why Choose Us and Pricing each also got a narrower, standalone Heading Style control — just a Decoration toggle (None/Underline/Strikethrough) for the section's own heading text, on top of whatever the Heading Typography accordion above already sets. On Why Choose Us and Pricing it's the Design tab's Heading typography group. Neither section's renderer reads anything else off this field yet — only Decoration has a visible effect here, and it's a separate field from the Heading Typography accordion's own Decoration toggle, so setting one doesn't change the other.

Theme presets

Themes aren't applied from inside the section library itself — your page's colours, typography, and spacing come from your store's active theme pack, set once in the Theme Hub and inherited by every section on every page. Click the Brand icon on the Landing Page Editor's left rail to open the Styles panel in a drawer on the right; it shows which pack is currently active and links straight to the Theme Hub to change it. Any colour tweak you make in the Styles panel applies only on top of that pack, only for this page.

If you want a look the Theme Hub's ready-made packs don't cover, the Styles panel also lets you create your own custom theme: pick one of five base families (Surface Depth, Anti-Aesthetic, Retro Futurist, Atmospheric, Editorial Craft), then set your own primary/secondary/surface colours, a typography pairing, and a spacing rhythm (Compact, Balanced, Spacious, or Airy).

For typography, the Styles panel's Typography section has two tabs: Google Fonts, where you search and pick a Body Font and a Heading Font from a large searchable catalogue, and Custom Font, where you can upload your own .woff2 font file (up to 5MB) and give it a family name — it's then served from your store's CDN and available anywhere a font can be chosen.

Beyond that page-wide pair, any individual section has its own Font family picker. In the v3 Store Editor, select the section, open Design, and expand Typography scale. Pick a font from the picker to override the theme font for that one section. Leave it empty and the section keeps using your page's Body/Heading fonts above. To remove an override you set, choose Default (inherit) in the picker: it removes the saved value entirely rather than saving an empty one, so the section falls back to the theme font cleanly. In the legacy editor the same picker sits under the section's Style tab as Font Family (this section).

Theme Customization

Further down the Styles panel, between Border Radius and Additional CSS, the Theme Customization group lets you fine-tune typography, spacing, motion, and individual sections' colours for this one page only. Every field starts blank — blank means "inherit whatever your store theme already sets" — so adding this group to an existing page changes nothing until you actually pick a value.

Override the typography (optional)

Under Typography:

  • Typography Voice — the same curated, 62-pairing font catalog as the header/footer's own Type Pairing control (see Color Schemes and Type Pairing), grouped into editorial, geometric, display, and monospace tiers — for example "Playfair Display + Inter" or "Space Grotesk + Space Mono". Leave it on Template default to keep using your theme pack's fonts.
  • Heading Weight — 300 to 900, in the usual steps (300, 400, 500, 600, 700, 800, 900). Leave it on Default weight to inherit.
  • Heading Transform — None, Uppercase, or Capitalize, applied to every heading on the page. Leave it on Default transform to inherit.

Each of these three has its own reset (circular arrow) icon that appears once you've picked a value — click it to clear that one field back to blank/inherit.

Set a Spacing Rhythm (optional)

Choose Compact, Standard, or Generous to tighten or loosen the vertical spacing between every section on the page at once. Standard is the default — picking Compact or Generous reveals a reset icon next to the dropdown to put it back.

Set a Motion style (optional)

Choose Standard, Cinematic, Snappy, Bouncy, or None to change how sections and elements animate in as visitors scroll. Standard is the default — the same reset-icon pattern applies once you pick anything else.

Per-Section Styling (optional)

Below Motion, every section currently on the page gets its own row with three colour pickers — Ink (text), Bg (background), and Accent — plus a per-field reset icon and, once you've changed anything in that row, a Reset section button that clears all three at once. A section with no override here simply inherits the page's theme like normal; you only need to touch a row for the one or two sections you want to visually break out from the rest.

No per-section theme packs here

Unlike the Pages Program's config picker (used for pages like Maintenance and other standalone templates), this Per-Section Styling group does not let you assign a whole different theme pack to one section — only the three colour fields above. If you're looking for a per-section theme-pack swap, that control lives in the Pages Program picker, not here.

Why don't my Theme Customization changes show on the storefront?

Common causes:

  • You haven't published. Like every other Styles panel change, these are draft-only until you publish the page — see Publishing & the preview link.
  • A per-section override is winning where you expected the page-wide setting to apply. Per-Section Styling always overrides the page's Typography/Spacing/Motion settings for that one section — if a section still looks unchanged after a page-wide tweak, check whether that section has its own Ink/ Bg/Accent override set and use its Reset section button if you want it to inherit again.
  • A brand font is set, or your store's active Theme pack still wins. For fonts specifically, the order is: your store's brand heading/body fonts (Store Branding → Logo & Identity → Typography, linked in via the Use Brand Kit switch below or set directly) beat a Typography Voice pairing you pick here, which in turn beats your active Theme pack's own fonts (Theme Hub), which beats the template's built-in fonts. If picking a Typography Voice pairing doesn't change your headings or body text, check Store Branding first — a brand font set there always wins. If a pairing you picked a while ago still shows your Theme pack's fonts instead, reopen Typography Voice and re-select the same pairing once — this re-saves it so it takes precedence over the Theme pack going forward.

Brand Kit

At the top of the Styles panel's Colors section, a Use Brand Kit switch links this specific page's colours and fonts to your store's actual branding, instead of leaving you to copy them by hand. It's an opt-in — turning it on doesn't touch any other page, and every page you haven't opted in keeps rendering exactly as it does today.

What Brand Kit links, and what it doesn't

  • Brand colour and Accent colour — pulled from Store Branding → Logo & Identity → Brand Colors (see Store Branding).
  • Heading font and Body font — pulled from the same screen's Typography section, as a pair.
  • Your store's logo (and dark-mode logo, if you've set one) is not part of this switch — it already shows in your storefront's header and footer everywhere, on every page, whether or not Brand Kit is turned on anywhere.
  • Everything else on the page — layout, spacing, border radius, section content — is untouched.

Turning Use Brand Kit on for the first time on any page also turns on a store-wide setting behind the scenes, so once you've linked one page, later changes to your brand colours or fonts in Store Branding take effect on every page that has the switch on, without reopening each one. Turning the switch off on a single page only unlinks that page — it doesn't undo the store-wide setting, since another page may still depend on it.

While Brand Kit is on for a page, its Primary Color, Secondary Color, and Accent Color fields below the switch go disabled — you're now looking at values controlled elsewhere, not ones you can hand-edit here. Turn the switch back off if you want to set a one-off colour just for this page again. The Body Font and Heading Font pickers, by contrast, are never disabled: if you pick a font here that's different from this page's own previous default, that specific choice keeps winning over Brand Kit's font, even while the switch stays on — the same "your explicit choice on this page wins" rule that already protects a colour you'd customized before ever turning the switch on.

Note

This is the same switch and the same underlying setting as the guided setup's brand step — see Guided first-time setup. Whichever screen you use it from, it's one setting per page.

Tip

If you're not sure which section to reach for, search the library by what you're trying to communicate ("trust," "urgency," "story") rather than by section name — the search matches descriptions too.

Next steps