My patterns Docs · v1.0.0

Getting started

My patterns is a Shopify Online Store 2.0 theme with six styles, a block-based product page and content that can come straight from your metafields and metaobjects. This guide covers setup, every section and setting, and how to get help.

Install the theme

  1. In your Shopify admin, go to Online Store → Themes.
  2. In the Theme Store listing, choose the style you want and select Try theme or Buy theme. The theme is added to your theme library.
  3. Select Customize to open the theme editor. Nothing changes on your live store until you select Publish.

Choose a style

Every style is the same theme with its own colors, fonts, spacing and layouts. You can switch style later in Theme settings → Theme style, and your content is kept.

Style Best for Look
My patterns Most stores Neutral, clean, with a mega menu and a sidebar filter
Fortune Beauty, wellness, gifts Warm, rounded, serif headings, centered logo
Pop Streetwear, electronics, bold brands Dark, sharp corners, full-width header and horizontal filters
Happy Minimal catalogs, art, design Monochrome, drawer menu, edge-to-edge product grid
Sovereign Luxury, jewelry, furniture Refined, centered cards, generous spacing, transparent header on the home page
Reel Fashion, lifestyle, night-time brands Dark with gold accents, portrait images, drawer menu

Each style also has its own home page and product page templates (for example index.fortune and product.fortune). To use one, open the template picker at the top of the editor, or assign the template to a product in the admin.

First steps checklist

  • Logo and colors: go to Theme settings → Logo and Theme settings → Colors (color schemes).
  • Menus: create your main menu and footer menus in Content → Menus, then pick them in the Header and Footer sections.
  • Home page: add, remove and reorder sections. Every section shows a short hint in the editor until it has content.
  • Product page: open a product template and add blocks to Product information (price, variants, buy buttons, size chart, spec highlights and more).
  • Cart: choose the cart type (drawer or page) and the free-shipping bar in Theme settings → Cart.
  • Policies and contact: fill in Settings → Policies and add a Contact form section to your contact page.

Customizing

Sections and blocks

Sections are the building blocks of each page. Most content sections accept theme blocks (headings, text, buttons, images and more) that you can add, reorder and nest. Sections that list items (slides, rows, FAQ questions, testimonials) use their own item blocks. Most sections also accept app blocks, so blocks from your installed apps can sit inside it.

Common settings that most sections share:

  • Color scheme, Section width (standard, wide or full) and top and bottom padding, with separate mobile values.
  • Design: heading size, weight, letter spacing, color, and Hide on mobile / Hide on desktop.
  • Section divider: an angled, curved or wave edge above or below the section.
  • Custom CSS that applies to that section only.

Images and focal points

Cropped images (banners, slides, cards, collection tiles and galleries) follow the focal point you set on the image in Content → Files or in the image picker. Set the focal point on the important part of the photo, and it stays in view on every screen size.

Product page

The Product information section is built from blocks. Add only what you need, in any order. Highlights:

  • Variant picker with swatches from Shopify's native color and image swatches.
  • Size chart: a pop-up or drawer that can show a different chart per product (see Data sources).
  • Spec highlights and Content blocks: reusable specs and accordions (shipping, returns, care).
  • Quantity breaks: shows volume pricing from the custom.quantity_breaks metafield. Create a matching automatic discount so the price is applied at checkout.
  • Complementary products: "Pairs well with" products from Shopify Search & Discovery.
  • 3D models and AR: product models open in Shopify's viewer, with "View in your space" on supported phones.

Below the product information you can add Product reviews, Product specifications, Key ingredients, How to use, Bundle products, Products by metafield and Related products.

Data sources and metafields

Many sections can fill themselves from your store data, so you enter content once and reuse it.

How a data source works

Sections that list reusable entries have a Data source text setting, pre-filled with a sensible default. Type one of these:

You type What shows
faq_item All entries of that metaobject type
faq_item: shipping, returns Only these entries, in this order (use the entry handles)
custom.faq_items The entries in that list metafield on the current product, collection, article or page

Leave it blank to turn the source off. You don't need the connect button next to these fields; just type the value.

If your metaobject definition uses different field keys, map them in Field keys, for example question=title, answer=body.

To find an entry's handle, open Content → Metaobjects, select the type and open the entry. The handle is shown on the entry page.

Default types and fields

Section or block Default data source Fields read
Collapsible content (FAQ) faq_item question, answer
Testimonials testimonial quote, author, caption, avatar, rating
Shop by brand brand name, logo, description, url
Lookbook story image, heading, body, products
Store locator location name, address, hours, phone, email, directions_url, image, map_embed_url
Promotion banner promotion message, link, link_label, image, start_date, end_date
Key ingredients custom.ingredient_list name, benefit
Product reviews custom.customer_reviews author, rating, title, body, date, verified, image
Product specifications custom.spec_groups title, rows
Size chart block product metafield custom.size_guide, then the default entry heading, description, image, table
Content blocks block product metafield custom.content_blocks, then the default entries heading, body, icon, link, link_label
Spec highlights block product metafield custom.specs, then the default entries label, value, icon

Per-product content

For product blocks, the product's own metafield always wins. Open a product in the admin, find the metafield (for example Size guide or Content blocks) and pick the entries there. The block's Default entries field (for example content_block: shipping, returns) is used only for products without their own entries.

Create the definitions in one click

The free My patterns Companion app has a Content setup screen that creates every definition above, and the product metafields that point to them, in one step. You can also give a type your own handle. If you do, type the same handle in the section's Data source.

You can also create them by hand in Settings → Custom data.

Apps

My patterns works on its own; no app is required. Where an app adds a feature, the theme gives it a place:

  • App blocks can be added inside the product section and most content sections.
  • App slots on product cards, next to the product title and in the header let apps such as wishlists place their buttons without editing code.
  • Theme bridge: apps can supply data to the theme's own back-in-stock and reviews interface through window.MyPatterns.registerProvider(name, provider). Apps written for the older name window.Velocity still work.

Review apps that write Shopify's standard reviews.rating metafields (such as Judge.me, Loox, Okendo or Shopify Product Reviews) show star ratings on product cards and the product page automatically.

Languages and translations

The theme includes storefront translations for English, French, German, Spanish and Italian. To change any text, or to add a language, use Online Store → Themes → … → Edit default theme content, or install Translate & Adapt.

Performance and accessibility

  • Use images at least 1600 px wide for full-width banners, and let the theme handle resizing; it serves smaller files to smaller screens.
  • Keep the number of sections with autoplaying video or sliders low on the home page.
  • Every image picker has an alt text field in Content → Files; fill it in for accessibility and SEO.
  • Menus, drawers, tabs and pop-ups work with a keyboard and respect the "reduce motion" system setting.

Frequently asked questions

How do I switch to another style without losing my content? Go to Theme settings → Theme style and pick a new style. Colors, fonts and layouts change; your sections and blocks stay. To try a style safely, duplicate the theme first.

A section is empty on my live store but shows a hint in the editor. Why? Sections hide themselves when they have no content, so shoppers never see empty boxes. Add blocks, pick a collection or product, or set the section's Data source.

My FAQ, brands or store locations don't show. What should I check? Check that the section's Data source matches your metaobject type handle exactly, that the entries are set to Active, and that the definition has Storefront access turned on in Settings → Custom data.

How do I show a different size chart on each product? Create size guide entries, then set each product's Size guide metafield. Products without one use the block's Default size guide entry.

Quantity breaks show on the product page but the discount isn't applied at checkout. The block only displays the tiers. Create a matching automatic discount in Discounts (Amount off products, same minimum quantity and percentage).

How do I add a wishlist? The theme leaves space for app buttons on product cards, next to the product title and in the header. Install a wishlist app (for example My patterns Companion) and turn on its app embed; its buttons appear in those places.

Can I use my own reviews app? Yes. Add the app's block to the product page, or turn off the theme's review section. Star ratings come from Shopify's standard reviews.rating metafield, which most review apps write.

How do I change the font or add my own? Use Theme settings → Typography. Fonts come from Shopify's font library, including bold and italic styles.

How do I edit text that isn't in a section setting, such as "Add to cart"? Use Edit default theme content from the theme's menu.

Will theme updates overwrite my changes? Settings, sections and content are kept when you update. Direct code edits are not, so keep code changes to a minimum and note them before updating.

Does the theme support Shopify Markets, multiple currencies and languages? Yes. Add the country and language selectors in the Header and Footer sections.

How do I get help? Use the support form. We reply within two business days.

Support policy

What we help with. Questions about the theme's features and settings, setup guidance, and bugs in the theme's code, for stores using an unmodified copy of My patterns.

What is outside support. Custom code changes, problems caused by edits to the theme code or by third-party apps, and store design or content work. We'll still point you in the right direction where we can.

Response time. We reply to every request within two business days (Monday to Friday, excluding public holidays). Most requests are answered sooner.

Bugs. If you find a bug such as a broken layout, a dead link or a logic error, we fix it in the next theme update. Critical bugs that stop shoppers from buying are fixed immediately.

How to contact us. Use the support form and include your store URL, the style you use, and screenshots of the problem. Please don't share your store password or staff account details; if we need access, we'll ask for a collaborator request through Shopify.

Theme updates. Updates are free and appear in Online Store → Themes. Each update is listed in the changelog below.

Changelog

1.0.0 — First release: six styles (My patterns, Fortune, Pop, Happy, Sovereign, Reel), block-based sections, data sources for metafields and metaobjects, 3D models and AR, complementary products, the Shopify account component, and focal-point-aware images.

Settings reference

Every setting, with the same names you see in the theme editor. Select a name to expand it.

Theme settings

Age verifier
SettingTypeNotes
Enable age verificationOn/off
Default: Off
HeadingText
Default: Are you 18 or older?
MessageRich text
Confirm button labelText
Default: I am of age
Decline button labelText
Default: Leave
Decline redirect URLLinkWhere to send visitors who decline. Leave blank to show a message instead.
Image / logoImage
Animations
SettingTypeNotes
Transition durationSlider 0–600ms
Default: 200ms
Reveal sections on scrollOn/off
Default: On
Shine effect on hoverOn/off
Default: Off
Hover effect for cards and mediaChoice: None, Raise, 3D tilt
Default: None
Back in stock
SettingTypeNotes
Controls the "Notify me when available" product block.
Requests handled byChoice: Theme: emailed to you via the contact form, App: a connected back-in-stock app, Off: I use another app's block
Default: Theme: emailed to you via the contact form
Theme mode needs no app; you get an email for each request and notify shoppers yourself. App mode sends automatic restock alerts (and text messages, if the app supports them) and falls back to the contact form when no app is connected.
Badges
SettingTypeNotes
Show sale and sold-out badgesOn/off
Default: On
PositionChoice: Top left, Top right, Bottom left, Bottom right
Default: Top left
ShapeChoice: Rounded, Square, Pill, Ribbon
Default: Rounded
Corner radiusSlider 0–40px
Default: 4px
Ribbon widthSlider 44–120px
Default: 64px
Applies to the Ribbon style. Ribbons always hang from the top of the card.
Custom badges (from product tags)
Add a tag to any product in the format BADGE_[name] to show a custom badge. Example: tag BADGE_Best Seller shows a "Best Seller" badge. Uses the badge style above and its own position/colors below.
Custom badge positionChoice: Top left, Top right, Bottom left, Bottom right
Default: Top right
Independent of the sale/sold-out badge. If both are in the same corner they stack neatly.
Custom badge backgroundColor
Default: #6a3fb5
Custom badge textColor
Default: #ffffff
Price drop badge (native sale price)
Shown when a product's Compare-at price is higher than its price. Also appears next to the product-page price. Use [percent] in the text to insert the discount %, e.g. "Save [percent]%".
Price drop textText
Default: Price drop
Show on product pageOn/off
Default: On
Price drop badge backgroundColor
Default: #e23d3d
Price drop badge textColor
Default: #ffffff
Discount code badge (from product tags)
Add a tag shaped [CODE]_DISCOUNT_[amount] to a product, e.g. SUMMER_DISCOUNT_20%. Use [amount] and [code] in the text below. Display only — create a matching Shopify discount to enforce it at checkout.
Show discount code badge on cardsOn/off
Default: Off
Discount code textText
Default: [amount] off
Discount code badge backgroundColor
Default: #6a3fb5
Discount code badge textColor
Default: #ffffff
Automatic discount badge (from product tags)
Add a tag shaped AUTODISCOUNT_[amount] to a product, e.g. AUTODISCOUNT_15%. Use [amount] in the text below. Display only — create a matching Shopify automatic discount to enforce it at checkout.
Show automatic discount badge on cardsOn/off
Default: Off
Automatic discount textText
Default: [amount] off
Automatic discount badge backgroundColor
Default: #1c7c54
Automatic discount badge textColor
Default: #ffffff
Badge priority
A product card has room for only one discount badge. When several apply, the one with the lowest priority number wins (1 = highest). Sold-out always takes precedence.
Price drop priorityChoice: 1 (highest), 2, 3
Default: 1 (highest)
Discount code priorityChoice: 1 (highest), 2, 3
Default: 2
Automatic discount priorityChoice: 1 (highest), 2, 3
Default: 3
Sold-out badge
Sold-out badge backgroundColor
Default: #666666
Sold-out badge textColor
Default: #ffffff
Blog cards
SettingTypeNotes
Text alignmentChoice: Left, Center, Right
Default: Left
Corner radiusSlider 0–40px
Default: 8px
Border thicknessSlider 0–12px
Default: 0px
Border opacitySlider 0–100%
Default: 10%
Brand story
SettingTypeNotes
Shown in the footer via a Brand information block.
HeadlineRich text (one line)
DescriptionRich text
ImageImage
Image widthSlider 50–550px
Default: 100px
Breadcrumbs
SettingTypeNotes
Show breadcrumbsOn/off
Default: On
Breadcrumb sourceChoice: Automatic, From menu, Product category (Shopify taxonomy)
Default: Automatic
Automatic: from the collection a product was viewed in (and a collection's custom.parent_collection metafield). From menu: from a navigation menu you choose. Product category: from each product's Shopify category (falls back to Automatic where unavailable).
Breadcrumb menuMenuUsed when Breadcrumb source is "From menu". The current page is located in this menu and the trail is built from its parents. Falls back to Automatic if not found.
Separator styleChoice: Slash (/), Chevron (›), Dot (•)
Default: Slash (/)
Vertical paddingSlider 0–40px
Default: 12px
Buttons
SettingTypeNotes
Border thicknessSlider 0–12px
Default: 1px
Border opacitySlider 0–100%
Default: 100%
Corner radiusSlider 0–40px
Default: 0px
Shadow opacitySlider 0–100%
Default: 0%
Shadow horizontal offsetSlider -12–12px
Default: 0px
Shadow vertical offsetSlider -12–12px
Default: 4px
Shadow blurSlider 0–20px
Default: 5px
Show back-to-top buttonOn/off
Default: On
Cart
SettingTypeNotes
Cart typeChoice: Drawer, Page
Default: Drawer
Show vendorOn/off
Default: Off
Show item priceOn/off
Default: On
Show price-drop savingsOn/off
Default: On
Sums the Compare-at savings across the cart and shows a total. This is a native "was" price difference, not a checkout discount.
Price-drop savings labelText
Default: Price drop
Enable cart noteOn/off
Default: Off
Free-shipping messageTextShown in the cart. Leave blank to hide.
Free-shipping progress bar
Show free-shipping progress barOn/off
Default: Off
Free-shipping threshold (in your store currency, e.g. 100)Number
Default: 100
Message before threshold (use [amount])Text
Default: You're [amount] away from free shipping
Message once unlockedText
Default: You've unlocked free shipping!
Cart upsell (drawer)
Show "You might also like" in the cart drawerOn/off
Default: Off
Cart upsell headingText
Default: You might also like
Number of productsSlider 1–4
Default: 3
Prefer curated products from a product metafieldOn/off
Default: Off
When the cart's first product has the metafield below (Product list), show those instead of automatic recommendations. Falls back to automatic when empty.
Curated upsell metafield namespaceText
Default: custom
Curated upsell metafield keyText
Default: cart_upsells
Cart reward bar
Show spend-more reward barOn/off
Default: Off
A second progress bar toward a reward tier (e.g. a discount or gift). Shown below the free-shipping bar.
Reward threshold (in your store currency, e.g. 150)Number
Default: 150
Reward name (used for [reward])Text
Default: 10% off
Message before threshold (use [amount] and [reward])Text
Default: Spend [amount] more to unlock [reward]
Message once unlocked (use [reward])Text
Default: You've unlocked [reward]!
Gift wrap productProductCreate a product (e.g. "Gift wrapping") and select it here to offer gift wrapping in the cart.
Show floating cart buttonOn/off
Default: Off
A cart button that stays visible while scrolling.
Collection cards
SettingTypeNotes
Text alignmentChoice: Left, Center, Right
Default: Center
Corner radiusSlider 0–40px
Default: 8px
Border thicknessSlider 0–12px
Default: 0px
Border opacitySlider 0–100%
Default: 10%
Colors
SettingTypeNotes
color_schemesColor schemes
Default page color schemeColor scheme
Currency format
SettingTypeNotes
To change currency codes, go to your Markets settings.
Show currency codesOn/off
Default: On
Dropdowns and pop-ups
SettingTypeNotes
Border thicknessSlider 0–24px
Default: 1px
Border opacitySlider 0–100%
Default: 10%
Corner radiusSlider 0–40px
Default: 0px
Shadow opacitySlider 0–100%
Default: 0%
Shadow horizontal offsetSlider -12–12px
Default: 0px
Shadow vertical offsetSlider -12–12px
Default: 4px
Shadow blurSlider 0–20px
Default: 5px
Google
SettingTypeNotes
Verification and tags
Search Console verification codeTextThe content value from the google-site-verification meta tag.
Merchant Center verification codeText
Inputs
SettingTypeNotes
Border thicknessSlider 0–12px
Default: 1px
Border opacitySlider 0–100%
Default: 55%
Corner radiusSlider 0–40px
Default: 0px
Shadow opacitySlider 0–100%
Default: 0%
Shadow horizontal offsetSlider -12–12px
Default: 0px
Shadow vertical offsetSlider -12–12px
Default: 4px
Shadow blurSlider 0–20px
Default: 5px
Layout
SettingTypeNotes
Max page widthSlider 1000–1600px
Default: 1280px
Space between sectionsSlider 0–100px
Default: 48px
Corner radiusSlider 0–24px
Default: 0px
Text directionChoice: Auto (by language), Left to right, Right to left
Default: Auto (by language)
Auto follows each language (e.g. Arabic/Hebrew render right-to-left automatically).
Media
SettingTypeNotes
Border thicknessSlider 0–24px
Default: 0px
Border opacitySlider 0–100%
Default: 5%
Corner radiusSlider 0–40px
Default: 0px
Shadow opacitySlider 0–100%
Default: 0%
Shadow horizontal offsetSlider -12–12px
Default: 0px
Shadow vertical offsetSlider -12–12px
Default: 4px
Shadow blurSlider 0–20px
Default: 5px
Option buttons
SettingTypeNotes
Border thicknessSlider 0–12px
Default: 1px
Border opacitySlider 0–100%
Default: 55%
Corner radiusSlider 0–40px
Default: 0px
Shadow opacitySlider 0–100%
Default: 0%
Shadow horizontal offsetSlider -12–12px
Default: 0px
Shadow vertical offsetSlider -12–12px
Default: 4px
Shadow blurSlider 0–20px
Default: 5px
Product cards
SettingTypeNotes
Image ratioChoice: Adapt to image, Square (1:1), Portrait (3:4)
Default: Square (1:1)
Show vendorOn/off
Default: Off
Show second image on hoverOn/off
Default: On
Style
Card styleChoice: Standard, Boxed
Default: Standard
Text alignmentChoice: Left, Center, Right
Default: Left
Spacing between details (desktop)Slider 0–24px
Default: 6px
Vertical gap between title, price, buttons, etc.
Spacing between details (mobile)Slider 0–24px
Default: 6px
Show product ratingOn/off
Default: On
Rating position (desktop)Choice: Below title, Below price, On image (bottom-left)
Default: Below title
Rating position (mobile)Choice: Below title, Below price, On image (bottom-left)
Default: Below title
Star sizeSlider 10–24px
Default: 14px
Star colorColor
Default: #f5a623
Show review countOn/off
Default: On
Variant swatches
Show variant swatchesOn/off
Default: On
Shows color/image swatches on cards (uses each product's option swatches). Hover previews the image; click opens that variant.
Swatch displayChoice: Auto (color or image), Color only, Variant image only
Default: Auto (color or image)
Auto uses native swatch colors/images, then falls back to variant photos.
Swatch shapeChoice: Circle, Square
Default: Circle
Swatch sizeSlider 14–40px
Default: 20px
Swatch borderOn/off
Default: On
Max swatches per cardSlider 2–8
Default: 5
Show volume-pricing noteOn/off
Default: On
Shows a small "Volume pricing available" note on cards for products that have quantity-break tiers (metafield custom.quantity_breaks). The full tier table shows on the product page.
Boxed card style
These controls style the card frame (border, padding, shadow). They only take effect when "Card style" above is set to Boxed.
Corner radius (boxed)Slider 0–40px
Default: 8px
Border thickness (boxed)Slider 0–12px
Default: 1px
Border opacity (boxed)Slider 0–100%
Default: 10%
Inner padding (boxed)Slider 0–32px
Default: 16px
Shadow opacity (boxed)Slider 0–100%
Default: 0%
Shadow vertical offsetSlider -12–12px
Default: 4px
Shadow blurSlider 0–30px
Default: 10px
Enable quick viewOn/off
Default: On
Reviews
SettingTypeNotes
Shows the Product reviews section. Star ratings read Shopify's standard review metafields, which most review apps write. Add reviews by hand (customer_review entries) or connect a reviews app. Using another reviews app? Turn this off and add its block to the Product reviews or Apps section.
Enable theme reviewsOn/off
Default: Off
Search behavior
SettingTypeNotes
Enable predictive searchOn/off
Default: On
Show product vendorOn/off
Default: Off
Show product priceOn/off
Default: On
Side panels
SettingTypeNotes
Border thicknessSlider 0–24px
Default: 0px
Border opacitySlider 0–100%
Default: 10%
Shadow opacitySlider 0–100%
Default: 0%
Shadow horizontal offsetSlider -12–12px
Default: 0px
Shadow vertical offsetSlider -12–12px
Default: 4px
Shadow blurSlider 0–20px
Default: 5px
Social media
SettingTypeNotes
Social accounts
FacebookLink
InstagramLink
TikTokLink
YouTubeLink
X (Twitter)Link
PinterestLink
Surfaces
SettingTypeNotes
Border thicknessSlider 0–24px
Default: 0px
Border opacitySlider 0–100%
Default: 10%
Corner radiusSlider 0–40px
Default: 0px
Shadow opacitySlider 0–100%
Default: 0%
Shadow horizontal offsetSlider -12–12px
Default: 0px
Shadow vertical offsetSlider -12–12px
Default: 4px
Shadow blurSlider 0–20px
Default: 5px
Typography
SettingTypeNotes
Heading fontFont
Body fontFont
Body font scaleSlider 90–130%
Default: 100%
Announcement bar
SettingTypeNotes
Background colorColor
Default: #1a1a1a
Slider arrow colorColor
Default: #ffffff
Show separator lineOn/off
Default: On
Full-width textOn/off
Default: Off
Off keeps text within the page width.
Vertical paddingSlider 4–24px
Default: 8px
Typography
Font sizeSlider 11–20px
Default: 14px
Font weightChoice: Regular, Medium, Semibold, Bold
Default: Regular
UppercaseOn/off
Default: Off
Letter spacingSlider 0–4px
Default: 0px
Behavior
TransitionChoice: Instant, Fade
Default: Instant
Show slide dotsOn/off
Default: Off
Let shoppers dismissOn/off
Default: Off
Adds a close button; remembered on the shopper's device.
Social media icons
Show icons on desktopOn/off
Default: Off
Announcements
Auto-rotate announcementsOn/off
Default: On
Change everySlider 3–12s
Default: 5s
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Blocks

Announcement

SettingTypeNotes
Content for center
Icon (emoji)TextOptional; shown before the center message.
Text for centerText
Default: Free shipping over $100
URL for centerLink
Center text colorColor
Default: #ffffff
Content for left side
Text for left sideText
URL for left sideLink
Left text colorColor
Default: #ffffff
Content for right side
Text for right sideText
URL for right sideLink
Right text colorColor
Default: #ffffff
Header
SettingTypeNotes
Layout
Desktop logo positionChoice: Top left, Top center, Middle left, Middle center
Default: Middle left
MenuMenu
Desktop menu typeChoice: Dropdown, Mega menu, Drawer
Default: Dropdown
Drawer opens fromChoice: Left, Right
Default: Left
Show social icons in drawerOn/off
Default: Off
Enable featured image for level 2 items without a level 3 menuOn/off
Default: On
Mega menu styleChoice: Link columns, Image cards, Tabs with products
Default: Link columns
Image cards: each sub-collection becomes a large image card. Tabs: sub-links on the left; hovering one shows its own links and 4 of its products.
Dropdown submenus opening styleChoice: Side, Below
Default: Side
Applies to the Dropdown menu type.
Open menu onChoice: Hover, Click
Default: Hover
Center menu when logo position is on topOn/off
Default: Off
Menu hover effectChoice: None, Underline, Highlight
Default: None
Header widthChoice: Standard, Full width
Default: Standard
Search
Show predictive searchOn/off
Default: On
Search bar width (desktop)Slider 200–640px
Default: 460px
Maximum width. It shrinks automatically if space is tight so it never overlaps the menu or icons.
Search bar styleChoice: Open, Modal
Default: Open
Search bar textTextEnter comma separated best seller items names. Example: 'Dining Table', 'Chairs', 'Outdoor Patio'
Search text animation durationSlider 1000–8000ms
Default: 4000ms
Utility textRich text (one line)Small text beside the header icons (e.g. a phone number or promo).
Header behavior
Sticky headerChoice: None, On scroll up, Always, Reduce logo size
Default: On scroll up
Shadow when stickyOn/off
Default: Off
Transparent header on homeOn/off
Default: Off
Overlays the first homepage section (use with a hero as the first section); turns solid on scroll.
Show separator lineOn/off
Default: On
Account iconChoice: 1, 2, 3
Default: 2
Show account iconOn/off
Default: On
Desktop account menuChoice: Shopify account, Theme dropdown
Default: Shopify account
Shopify account opens the customer account sheet and shows the customer's avatar when signed in. It is always used on mobile.
Customer account menuMenu
Cart iconChoice: 1, 2, 3
Default: 2
Color
Color schemeColor scheme
Menu color schemeColor schemeApplied to dropdown, mega menu, and drawer panels.
Localization
Show country/currency selectorOn/off
Default: On
Country/region selector widthSlider 100–320px
Default: 170px
Show language selectorOn/off
Default: On
Language selector widthSlider 80–240px
Default: 120px
Mobile layout
Mobile logo positionChoice: Center, Left
Default: Center
Mobile logo widthSlider 40–240px
Default: 120px
Spacing
Bottom marginSlider 0–100px
Default: 0px
Top paddingSlider 0–50px
Default: 20px
Bottom paddingSlider 0–50px
Default: 8px
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Blocks

Mega menu image

SettingTypeNotes
Menu item nameTextEnter the name of the menu item you want the images to apply to. Save to see changes.
Image section heightSlider 10–60%
Default: 40%
Image section widthSlider 20–100%
Default: 58%
Image radiusSlider 0–100px
Default: 10px
Image border thicknessSlider 0–10px
Default: 0px
Text styleChoice: Button, Plain Text
Default: Button
Button styleChoice: Outline, Solid
Default: Solid
First imageImage
Link for first imageLink
Text for first imageRich text
Second imageImage
Link for second imageLink
Text for second imageRich text
Third imageImage
Link for Third imageLink

Mega menu products

SettingTypeNotes
Shows a product promo inside the mega menu of the parent menu item whose title matches the text below.
Parent menu itemTextMust exactly match a top-level menu item title (case-insensitive).
HeadingText
Default: Featured
ProductsProducts
"Shop all" collection (optional)Collection
"Shop all" labelText
Default: Shop all
Image menu
SettingTypeNotes
Color schemeColor scheme
MenuMenu
HeadingRich text (one line)Optional title above the strip.
Heading sizeSlider 14–48px
Default: 24px
Heading alignmentChoice: Left, Center, Right
Default: Left
Tile sizingChoice: Fixed size, Fit columns
Default: Fixed size
Fixed uses exact pixel width/height. Fit columns sizes tiles to show a set number across the screen.
Tile widthSlider 80–240px
Default: 152px
Tile heightSlider 60–240px
Default: 120px
Minimum columns (desktop)Slider 3–10
Default: 8
Minimum columns (mobile)Slider 2–5
Default: 4
ShapeChoice: Circle, Rounded, Square, Blob
Default: Rounded
Border thicknessSlider 0–20px
Default: 0px
Corner radiusSlider 0–100px
Default: 14px
Tile backgroundChoice: None, Surface, Fade
Default: None
Tile background shows behind PNG images. Fade adds a soft shadow glow.
Tile background colorColor
Default: #f4f4f4
Shadow colorColor
Default: #00000026
Arrows
Show scroll arrows (desktop)On/off
Default: On
Arrow styleChoice: Circle (filled), Outline, Minimal (chevron only)
Default: Circle (filled)
Arrow positionChoice: Beside the strip, Over the strip edges, Top-right
Default: Beside the strip
Arrow sizeSlider 28–60px
Default: 40px
Show arrows on hover onlyOn/off
Default: Off
Labels
Label positionChoice: Below the tile, Over the image, Hidden
Default: Below the tile
Label sizeSlider 0–22px
Default: 0px
0 = theme default.
Label weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Label colorColor
Layout
Gap between tilesSlider 4–40px
Default: 16px
Center tiles when they fitOn/off
Default: Off
Auto-scrollOn/off
Default: Off
Auto-scroll speedSlider 2–10s
Default: 4s
Show scrollbar (desktop)On/off
Default: On
Turn off for a cleaner strip. Users can still scroll or use the arrows.
Hover highlightChoice: None, Underline, Lift (3D), Color tint
Default: Underline
Padding
TopSlider 0–100px
Default: 24px
BottomSlider 0–100px
Default: 24px
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Also accepts: theme blocks, app blocks.

Scrolling announcement
SettingTypeNotes
Color schemeColor scheme
Lead text (repeats)Rich text (one line)
Font sizeSlider 12–48px
Default: 18px
DirectionChoice: Right to left, Left to right
Default: Right to left
SpeedSlider 1–55
Default: 30
Bar heightSlider 30–120px
Default: 48px
Border thicknessSlider 0–6px
Default: 0px
Separator between itemsChoice: None, Dot (•), Line (|), Dash (—), Star (✦)
Default: None
Padding
TopSlider 0–60px
Default: 0px
BottomSlider 0–60px
Default: 0px
Padding top (mobile)Slider 0–120px
Default: 0px
Padding bottom (mobile)Slider 0–120px
Default: 0px
Design
Hide on mobileOn/off
Default: Off
Hide on desktopOn/off
Default: Off
Section divider
Top dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Bottom dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Divider colorColorUsually the color of the adjacent section/background.
Divider heightSlider 8–160px
Default: 40px
Divider height (mobile)Slider 8–160px
Default: 24px
Width
Section widthChoice: Standard, Wide, Full width
Default: Standard
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Blocks

Item

SettingTypeNotes
TextRich text (one line)
Default: Free shipping over $50
Icon (optional)Image
LinkLink
Text colorColor

Product page

Bundle products
SettingTypeNotes
Shows products from a product metafield (list of products) as a buyable bundle. Set the bundle products per product under Settings > Custom data > Products.
HeadingRich text (one line)
Default: Frequently bought together
Heading font sizeSlider 15–60px
Default: 27px
Heading alignmentChoice: Left, Center, Right
Default: Left
Heading alignment (mobile)Choice: Same as desktop, Left, Center, Right
Default: Same as desktop
DescriptionRich text
In-box headingText
Default: Complete the set
Shown inside the bundle box (e.g. "Complete the set"). Leave blank for the theme default.
LayoutChoice: Checklist (toggleable items), Row (frequently bought together)
Default: Row (frequently bought together)
Checklist lets shoppers uncheck extras; Row shows a plus-separated line.
Preselect extra itemsOn/off
Default: On
Checklist layout: start extras checked (on) or unchecked / opt-in (off).
"This item" labelText
Default: This item
Small eyebrow on the current product's card (e.g. "This item"). Leave blank to hide.
Bundle price / button positionChoice: Below the products, Right of the products
Default: Below the products
Color schemeColor scheme
Product cards
Image ratioChoice: Adapt to image, Portrait, Square
Default: Square
Show second image on hoverOn/off
Default: Off
Show vendorOn/off
Default: Off
Show variant swatchesOn/off
Default: Off
Lets shoppers pick each product's variant right in the bundle.
Card widthSlider 90–360px
Default: 150px
Show border around imagesOn/off
Default: Off
Image corner radiusSlider 0–30px
Default: 8px
Discount
Shows a discounted bundle total. To actually charge it, create a matching Shopify automatic discount (Discounts > Create > Amount off products) scoped to these products. See the section on discounts.
Bundle discountSlider 0–90%
Default: 0%
Box
Maximum widthSlider 480–1600px
Default: 640px
The box never grows wider than the page content area, so a large value makes it fill the available width.
Inner paddingSlider 0–60px
Default: 24px
Border thicknessSlider 0–12px
Default: 1px
Border radiusSlider 0–40px
Default: 12px
Section padding
Top paddingSlider 0–100px
Default: 48px
Bottom paddingSlider 0–100px
Default: 48px
Top padding (mobile)Slider 0–100px
Default: 36px
Bottom padding (mobile)Slider 0–100px
Default: 36px
Design
Heading weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase headingOn/off
Default: Off
Heading size (mobile)Slider 14–44px
Default: 22px
Heading colorColor
Section divider
Top dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Bottom dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Divider colorColorUsually the color of the adjacent section/background.
Divider heightSlider 8–160px
Default: 40px
Metafield source
Metafield namespaceText
Default: custom
Metafield keyText
Default: bundle_products
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Also accepts: theme blocks, app blocks.

How to use
SettingTypeNotes
Steps metafieldText
Default: custom.how_to_use
Multi-line text, one step per line: "Step title: what to do".
Use the Step blocks when a product has noneOn/off
Default: On
Turn off to hide the section on products without the metafield.
CaptionText
Default: Ritual
HeadingRich text (one line)
Default: How to use
Heading sizeSlider 20–64px
Default: 36px
Heading alignmentChoice: Left, Center
Default: Left
LayoutChoice: Steps in a row, Vertical timeline
Default: Steps in a row
Steps per rowSlider 2–5
Default: 4
Color schemeColor scheme
Top paddingSlider 0–120px
Default: 72px
Bottom paddingSlider 0–120px
Default: 72px

Also accepts: theme blocks, app blocks.

Blocks

Step

SettingTypeNotes
TitleText
Default: Step
TextRich text
ImageImage
Key ingredients
SettingTypeNotes
Reads each product's own metafields and hides on products without them.
CaptionText
Default: What's inside
HeadingRich text (one line)
Default: Key ingredients
Heading sizeSlider 20–64px
Default: 36px
Data
Key ingredients metafieldText
Default: custom.key_ingredients
Multi-line text, one per line: "Name: what it does".
Key ingredients sourceText
Default: custom.ingredient_list
A list metafield (namespace.key) of ingredient entries, a metaobject type, or "type: handle, handle". Used instead of the text metafield when it has entries.
Field keysTextOnly if your definition uses other field keys: name=your_key, benefit=your_key.
Full ingredient list metafieldText
Default: custom.ingredients
Full list labelText
Default: Full ingredient list
Full listChoice: Collapsed, Always shown
Default: Collapsed
Image
ImageImage
Image metafieldText
Default: custom.ingredients_image
A file metafield; overrides the image above on products that have it.
Image positionChoice: Left, Right
Default: Left
Style
Number the ingredientsOn/off
Default: On
Color schemeColor scheme
Top paddingSlider 0–120px
Default: 72px
Bottom paddingSlider 0–120px
Default: 72px
Product information
SettingTypeNotes
Enable sticky column on desktopOn/off
Default: On
Which column stays fixedChoice: Image (details scroll), Details (image scrolls)
Default: Details (image scrolls)
Choose "Image" when product details are long, so the image stays in view while the details scroll.
Color schemeColor scheme
Enable section viewOn/off
Default: Off
Places the product in a coloured, rounded panel.
Sectioned view section colorColor
Default: #f5f5f5
Sectioned view background radiusSlider 0–40px
Default: 10px
Show breadcrumbsOn/off
Default: On
Limit text to a readable widthOn/off
Default: Off
Caps the description/text width so long copy stays legible.
Media
Desktop media widthSlider 40–65%
Default: 55%
Constrain media to screen heightOn/off
Default: Off
Media fitChoice: Original, Fill
Default: Original
Image ratio (when Fit = Fill)Choice: Portrait 4:5, Square 1:1, Landscape 4:3, Wide 16:9
Default: Square 1:1
Gallery layoutChoice: Thumbnails beside, Thumbnails below, Stacked (scroll through), Collage grid, Carousel with peek, Filmstrip (full width)
Default: Thumbnails beside
Stacked and Collage show every image and suit a sticky info column. Filmstrip puts a full-width image strip above the product details. On mobile, all of them become a swipe gallery.
Collage patternChoice: One large, then pairs, Pairs, Alternating large and pairs
Default: One large, then pairs
Filmstrip image heightSlider 360–800px
Default: 600px
Gap between imagesSlider 0–32px
Default: 8px
Desktop media positionChoice: Left, Right
Default: Left
Position is automatically optimized for mobile.
Image zoomChoice: Hover to zoom, Click to open lightbox, None
Default: Click to open lightbox
Lightbox opens the image full-screen on click.
Mobile layoutChoice: Thumbnails, Dots
Default: Thumbnails
Dots colorColor
Default: #000000
Enable video loopingOn/off
Default: Off
Group gallery by variantOn/off
Default: Off
Shows only the selected variant's media. Name each variant's images with the option value in the image alt text (e.g. "Red - front"). Falls back to all images when none match.
Show previous / next arrowsOn/off
Default: On
Show image counterOn/off
Default: Off
Thumbnail sizeSlider 48–110px
Default: 72px
Media corner radiusSlider 0–32px
Default: 12px
Section padding
Top paddingSlider 0–100px
Default: 36px
Bottom paddingSlider 0–100px
Default: 36px
Padding top (mobile)Slider 0–100px
Default: 24px
Padding bottom (mobile)Slider 0–100px
Default: 24px
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Also accepts: app blocks.

Blocks

Vendor

SettingTypeNotes
Link to vendor's productsOn/off
Default: Off
Links the vendor name to a page of all products from that vendor.
Desktop sizeChoice: Small, Medium, Large
Default: Small
Mobile sizeChoice: Small, Medium, Large
Default: Small
WeightChoice: Default, Regular, Medium, Semibold, Bold
Default: Default
UppercaseOn/off
Default: Off
Letter spacingSlider 0–4px
Default: 0px
Text colorColor
AlignmentChoice: Left, Center, Right
Default: Left
PrefixTexte.g. "By" or "Brand:" before the name.
Brand logo (optional)
Logo metafieldTextA product metafield holding an image (namespace.key), e.g. custom.brand_logo. Shows the logo instead of the name.
Logo heightSlider 16–60px
Default: 28px
Spacing
Top spacingSlider 0–32px
Default: 0px
Bottom spacingSlider 0–32px
Default: 4px
Show on desktopOn/off
Default: On
Show on mobileOn/off
Default: On

Title

SettingTypeNotes
Desktop heading sizeChoice: Small, Medium, Large
Default: Medium
Mobile heading sizeChoice: Small, Medium, Large
Default: Small
Exact size — desktopSlider 0–64px
Default: 0px
0 = use the preset above.
Exact size — mobileSlider 0–48px
Default: 0px
0 = use the preset above.
WeightChoice: Theme default, Light, Regular, Medium, Semibold, Bold
Default: Theme default
UppercaseOn/off
Default: Off
Letter spacingSlider -2–6px
Default: 0px
Line heightSlider 0–2
Default: 0
0 = theme default.
ColorColor
AlignmentChoice: Left, Center, Right
Default: Left
Top spacingSlider 0–32px
Default: 0px
Bottom spacingSlider 0–32px
Default: 0px

Price

SettingTypeNotes
Price size — desktopSlider 0–48px
Default: 0px
0 = theme default.
Price size — mobileSlider 0–40px
Default: 0px
0 = theme default.
Price weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Price colorColor
Sale price colorColor
Compare-at colorColor
Compare-at sizeSlider 0–30px
Default: 0px
0 = theme default.
Layout
LayoutChoice: Inline, Stacked (compare-at below)
Default: Inline
AlignmentChoice: Left, Center, Right
Default: Left
Savings
Show savingsChoice: Don't show, Amount (Save $20), Percent (Save 20%), Amount + percent
Default: Don't show
Savings labelText
Default: Save
Price range
Show "From" price when variants differOn/off
Default: Off
Shows the lowest variant price until a variant is chosen.
"From" labelText
Default: From
Note
Tax / shipping noteRich text (one line)e.g. Tax included. Shipping calculated at checkout.

Description

SettingTypeNotes
PresentationChoice: Plain text, With heading, Collapsible row
Default: Plain text
HeadingText
Default: Description
Open by defaultOn/off
Default: On
Heading sizeSlider 0–36px
Default: 0px
0 = default.
Heading weightChoice: Default, Regular, Medium, Semibold, Bold
Default: Default
Content
SourceChoice: Product description, Metafield, Metafield, else description
Default: Product description
Metafield keyText
Default: custom.short_description
namespace.key of a rich text or multi-line text metafield.
Excerpt length (words)Slider 0–120
Default: 0
0 = full content. An excerpt shows as plain text with formatting removed.
Read more
Collapse long descriptionsOn/off
Default: Off
Truncates the description and adds a "Read more" toggle.
Collapse onChoice: All screens, Mobile only, Desktop only
Default: All screens
Collapse byChoice: Height, Number of lines
Default: Height
Collapsed heightSlider 80–500px
Default: 200px
Collapsed linesSlider 2–20
Default: 6
"Read more" labelTextLeave blank for the theme default.
"Read less" labelTextLeave blank for the theme default.
Toggle styleChoice: Text link, Underlined link, Link with chevron, Outline button
Default: Text link
Fade out collapsed textOn/off
Default: On
Typography
Text sizeSlider 0–24px
Default: 0px
0 = default.
Line heightSlider 0–2.4
Default: 0
0 = default.
Text colorColor
AlignmentChoice: Left, Center, Justified
Default: Left
Maximum line lengthChoice: Full width, Narrow (~60 characters), Medium (~70 characters), Wide (~80 characters)
Default: Full width
Formatting
Bullet styleChoice: Default, Checkmark, Dash, Accent dot
Default: Default
Link and bullet colorColor
Image corner radiusSlider 0–30px
Default: 0px
Container
StyleChoice: None, Tinted panel, Bordered card
Default: None
BackgroundColor
Border colorColor
PaddingSlider 0–48px
Default: 0px
0 = default.
Corner radiusSlider 0–30px
Default: 0px
0 = theme default.
Top spacingSlider 0–60px
Default: 0px
Bottom spacingSlider 0–60px
Default: 0px

Rating (reviews metafield)

SettingTypeNotes
By default the stars read Shopify's product-rating metafields reviews.rating + reviews.rating_count (populated by the free Shopify Product Reviews app and most review apps), falling back to custom.rating + custom.rating_count if those are used instead. To use a review app's own badge, switch the source below — the app then takes priority and the metafield stars are hidden.
Rating sourceChoice: Shopify rating metafield (default), Third-party review app
Default: Shopify rating metafield (default)
Review app badge codeLiquidPaste your review app's product-rating/badge Liquid or HTML (e.g. Judge.me, Loox, Okendo, Stamped, Yotpo). Only used when the source above is set to a third-party app.
Stars
Star styleChoice: Solid, Outline empty stars, Rounded
Default: Solid
Star sizeSlider 10–40px
Default: 18px
Gap between starsSlider 0–10px
Default: 2px
Star colorColorLeave empty to use the theme's accent color.
Empty star colorColorLeave empty for a light tint of the text color.
Text
Average rating numberChoice: Hidden, Before stars, After stars
Default: Hidden
Show review countOn/off
Default: On
Count formatChoice: (24), 24 reviews, 24 ratings
Default: (24)
Custom count labelTextOverrides the format above. [count] = number of reviews, e.g. "[count] happy customers".
Text colorColor
Text sizeSlider 0–20px
Default: 0px
0 = default.
Link and empty state
Link to the reviews sectionOn/off
Default: On
Reviews section anchorText
Default: #reviews
The Product reviews section uses #reviews. For a review app, use its widget's anchor.
Products with no reviewsChoice: Hide the rating, Show empty stars, Show text only
Default: Hide the rating
No-reviews textTextLeave blank for "No reviews yet".
Layout
AlignmentChoice: Left, Center, Right
Default: Left
Top spacingSlider 0–40px
Default: 0px
Bottom spacingSlider 0–40px
Default: 8px

Inventory / shipping text

SettingTypeNotes
Shipping / delivery text
Shipping textChoice: None, Ships in X days (relative), Delivery date range
Default: Ships in X days (relative)
Ships in (days, 0 to hide)Slider 0–30d
Default: 3d
Used with "Ships in X days".
Delivery range: earliest (days from today)Slider 0–60d
Default: 3d
Used with "Delivery date range".
Delivery range: latest (days from today)Slider 1–90d
Default: 7d
Stock
Low-stock thresholdSlider 0–50
Default: 10
Show "Only N left" when stock is at or below this (0 = off). Requires inventory tracking.
Show exact quantity when stock is lowOn/off
Default: On
Off shows a generic "Low stock" message instead of the number.
IndicatorChoice: Dot, Stock bar, Icon, None
Default: Dot
In-stock colorColor
Low-stock colorColor
Sold-out colorColor
Wording
In stock textText
Low stock textText
Exact quantity textTextUse [n] for the number, e.g. "Only [n] left".
Sold out textText
Backorder / pre-order textText
Default: Available on backorder
Shown when stock is 0 but the product still sells (continue selling).
Dispatch cutoff
Show order-by countdownOn/off
Default: Off
Cutoff hour (24h, store time)Slider 0–23h
Default: 15h
Cutoff textText
Default: Order within [timer] for same-day dispatch
Use [timer] where the countdown should appear.
Appearance
Font sizeSlider 0–22px
Default: 0px
0 = default.
Font weightChoice: Default, Regular, Medium, Semibold, Bold
Default: Default
Text colorColor
AlignmentChoice: Left, Center, Right
Default: Left
Top spacingSlider 0–32px
Default: 0px
Bottom spacingSlider 0–32px
Default: 0px

Variant picker

SettingTypeNotes
Add this to control the variant selector's style and position. Without it, the selector falls back to swatches inside the Buy buttons block.
Picker styleChoice: Color swatches, Image swatches, Buttons (pills), Dropdown
Default: Color swatches
Swatch sizeSlider 30–80px
Default: 44px
Auto-detect swatch optionsOn/off
Default: On
Options whose values have Shopify swatches (colour/image) render as swatches; the rest use the style above.
Per-option styleText (multi-line)One per line: Option name : style. Styles: color, image, button, dropdown. e.g. Color : color
Availability
Unavailable valuesChoice: Dim, Strike through, Hide, No change
Default: Dim
How to show option values that can't be combined with the current selection.
Appearance
Swatch shapeChoice: Square, Rounded, Circle
Default: Rounded
Selected styleChoice: Ring, Solid border, Checkmark
Default: Ring
Swatch border colorColor
Space between valuesSlider 2–20px
Default: 8px
Scroll values on mobileOn/off
Default: Off
Keeps long size runs on one line.
Labels
Show selected value in labelOn/off
Default: On
Label sizeSlider 0–22px
Default: 0px
0 = default.
Label weightChoice: Default, Regular, Medium, Semibold, Bold
Default: Default
Uppercase labelsOn/off
Default: Off

Quantity selector

SettingTypeNotes
Add this to position the quantity stepper on its own. Without it, the stepper stays inside the Buy buttons block.
Layout
Desktop layoutChoice: Own row (stacked), Inline with Add to cart
Default: Own row (stacked)
Inline puts the stepper beside the Add to cart button to save space.
Mobile layoutChoice: Own row (stacked), Inline with Add to cart
Default: Own row (stacked)
AlignmentChoice: Left, Center, Right
Default: Left
Stacked layout only.
Label
Label positionChoice: Above, Beside the stepper, Hidden
Default: Above
Automatically hidden in the inline layout.
Label textTextBlank uses the theme translation.
Uppercase labelOn/off
Default: Off
Stepper
StyleChoice: Buttons (− 1 +), Plain input, Dropdown
Default: Buttons (− 1 +)
HeightSlider 0–64px
Default: 0px
0 = default. Match your Add to cart button height.
WidthSlider 0–220px
Default: 0px
0 = automatic.
Corner radiusSlider 0–40px
Default: 8px
Quantity rules
Shopify's product quantity rules (minimum, maximum, increment) are applied automatically. Use the overrides below only if you need to force different limits.
Minimum overrideSlider 0–20
Default: 0
0 = use Shopify's rule.
Maximum overrideSlider 0–100
Default: 0
0 = use Shopify's rule.

Buy buttons

SettingTypeNotes
Add to cart button
Add to cart labelTextBlank uses the theme translation.
Sold out labelText
Pre-order labelText
Show bag iconOn/off
Default: Off
Button styleChoice: Solid, Outline
Default: Solid
Full widthOn/off
Default: On
Button heightSlider 0–72px
Default: 0px
0 = theme default.
Corner radiusSlider 0–40px
Default: 8px
Button backgroundColor
Button text colorColor
Space between buttonsSlider 0–24px
Default: 10px
Checkout buttons
Show dynamic checkout buttonOn/off
Default: On
Checkout button positionChoice: Below Add to cart, Above Add to cart
Default: Below Add to cart
Show Shop Pay Installments bannerOn/off
Default: On
Pre-order
Show pre-order noteOn/off
Default: On
Pre-order noteTextBlank uses the theme translation.
Subscriptions
Purchase options headingTextBlank uses the theme translation.
Purchase options layoutChoice: Radio list, Bordered cards
Default: Radio list
Other
Show gift-card recipient formOn/off
Default: On
For gift-card products only: lets the buyer email the card to someone with a message and send date.
Sticky add to cart
Enable sticky add to cart on mobileOn/off
Default: On
Enable sticky add to cart on desktopOn/off
Default: Off
Sticky add to cart button widthSlider 30–100%
Default: 50%

Share

SettingTypeNotes
DisplayChoice: Share button (device share sheet), Row of network icons, Button that opens network list
Default: Share button (device share sheet)
The share button uses the phone's share sheet, and copies the link on desktop.
Button labelText
Default: Share
Use the device share sheet on mobileOn/off
Default: On
Phones that support it get the share sheet instead of the icons.
Leading labelTexte.g. "Share:" before the icons.
Networks
FacebookOn/off
Default: On
X (Twitter)On/off
Default: On
PinterestOn/off
Default: On
Includes the product image.
WhatsAppOn/off
Default: On
TelegramOn/off
Default: Off
EmailOn/off
Default: On
Copy linkOn/off
Default: On
Shared link
Include the selected variantOn/off
Default: On
Add UTM tagsOn/off
Default: Off
Adds utm_source=<network>&utm_medium=share so shares appear in analytics.
Share textText
Default: Check out [product]
[product] = product title.
"Link copied" messageTextLeave blank for the theme default.
Icons
Icon styleChoice: Plain, Outlined circle, Filled circle, Rounded square
Default: Plain
ColorsChoice: Monochrome, Brand colors
Default: Monochrome
Icon sizeSlider 14–36px
Default: 18px
Icon and text colorColorMonochrome only.
Show network name on hoverOn/off
Default: On
Layout
AlignmentChoice: Left, Center, Right
Default: Left
Gap between iconsSlider 0–30px
Default: 10px
Divider aboveOn/off
Default: Off
Top spacingSlider 0–60px
Default: 16px
Bottom spacingSlider 0–60px
Default: 0px

Store pickup

SettingTypeNotes
Shows local pickup availability for the selected variant. Set up locations in Settings → Locations.
Status line
Available textTextUse [location] for the store name. Blank uses the theme translation.
Unavailable textTextUse [location] for the store name.
IndicatorChoice: Dot, Map pin, Store, None
Default: Dot
Available colorColor
Unavailable colorColor
Show addressOn/off
Default: Off
Show "Get directions" linkOn/off
Default: Off
Opens Google Maps directions to the store.
Directions link textText
Default: Get directions
Hide block when pickup is unavailable everywhereOn/off
Default: Off
Availability modal
Modal headingTextBlank uses the product title.
List available stores firstOn/off
Default: On
Enable store searchOn/off
Default: Off
Shown when you have more than two locations.
Search placeholderText
Default: Search stores
No-results textText
Default: No stores match your search.
Appearance
Font sizeSlider 0–22px
Default: 0px
0 = default.
Font weightChoice: Default, Regular, Medium, Semibold, Bold
Default: Default
Text colorColor
AlignmentChoice: Left, Center, Right
Default: Left
Top spacingSlider 0–32px
Default: 0px
Bottom spacingSlider 0–32px
Default: 0px
Reserve and pay at pickup note
Informational only. Shows automatically ONLY when the product has pickup availability. To actually accept it, add a manual payment method (Settings → Payments → Manual payment methods, e.g. "Pay at store pickup").
Show "reserve and pay at pickup" noteOn/off
Default: Off
Note textText
Default: Reserve online & pay when you pick up
"Check availability" button
Button textText
Default: Check availability at other stores
StyleChoice: Text link, Outline, Solid
Default: Text link
SizeChoice: Small, Medium, Large
Default: Medium
Full widthOn/off
Default: Off
Show location iconOn/off
Default: Off
Accent colorColorBorder + text (Outline/Text link), or background (Solid). Blank = theme color.
Text color (Solid / Outline hover)ColorBlank = theme default.

Size chart

SettingTypeNotes
Button labelText
Default: Size chart
Which source to use? SAME chart on every product → use Image or Page below. DIFFERENT charts per product group → reference a size guide entry from each product (metafield below), or use direct product metafields (image + JSON table). First match wins: product size guide → product metafields → default entry → page/image.
Metaobject (reusable)
Product size guide metafieldText
Default: custom.size_guide
namespace.key of a product metafield that references a size guide entry.
Default size guide entryTextType it: size_guide: entry-handle. No need for the connect button. Per-product guides are picked on the product's size guide metafield (key above) and win over this.
Direct product metafields
Enter your metafield keys as namespace.key. The image shows first, then the table. Table metafield must be JSON shaped {"headers":[...],"rows":[[...]]}.
Image metafield keyTexte.g. custom.size_chart_image (a File metafield)
Table metafield keyTexte.g. custom.size_chart_table (a JSON metafield)
Legacy (same for all products)
PagePage
ImageImage
Button appearance
StyleChoice: Text link, Outline, Solid
Default: Outline
SizeChoice: Small, Medium, Large
Default: Medium
Full widthOn/off
Default: Off
Show ruler iconOn/off
Default: On
Accent colorColorBorder + text (Outline/Text link), or background (Solid). Blank = theme color.
Text color (Solid / Outline hover)ColorBlank = theme default.
Popup
Open asChoice: Centered popup, Side drawer
Default: Centered popup
Bottom sheet on mobileOn/off
Default: Off
WidthChoice: Small, Medium, Wide
Default: Wide
Corner radiusSlider 0–30px
Default: 0px
0 = theme default.
Chart heading sizeSlider 0–36px
Default: 0px
0 = default.
Placement
Size option nameText
Default: Size
The variant option this chart belongs to. Used for the settings below and for highlighting the selected size.
Show beside that option's labelOn/off
Default: Off
Moves the link next to the option name in the variant picker. The Variant picker block must be present.
Only show on products with that optionOn/off
Default: Off
Units
Show cm / in switchOn/off
Default: Off
Converts numeric cells (including ranges like 80–84). The first column and text such as S or EU 38 are left alone.
Chart data is written inChoice: Centimetres, Inches
Default: Centimetres
Show first inChoice: Centimetres, Inches
Default: Centimetres
Table
Highlight the selected sizeOn/off
Default: On
Matches the chosen option value against the first column.
Sticky header row and first columnOn/off
Default: On
Striped rowsOn/off
Default: Off
Row spacingChoice: Comfortable, Compact
Default: Comfortable
Cell alignmentChoice: Left, Center
Default: Left
Table text sizeSlider 0–20px
Default: 0px
0 = default.
Header backgroundColor
Header textColor
Border colorColor
Extra content
How to measure imageImage
How to measure textRich textAdding an image or text adds a "How to measure" tab.
Fit hintTextShown under the button, e.g. "Runs small — we recommend sizing up".
Fit hint metafield keyTextnamespace.key of a text metafield. Overrides the fit hint per product.
Footer noteRich texte.g. "Still unsure? Contact us" with a link.
Top spacingSlider 0–60px
Default: 12px
Bottom spacingSlider 0–60px
Default: 12px

Tab

SettingTypeNotes
Tab headingText
Default: Tab
ContentChoice: Rich text, Page, Product description, Product metafield
Default: Rich text
ContentRich text
PagePageIf set, the page content is used instead of the text above.
Metafield keyTextnamespace.key of a rich text or multi-line text metafield, e.g. custom.materials.
Hide this tab when it has no contentOn/off
Default: On
IconChoice: None, Shipping (truck), Returns, Warranty / secure, Eco / natural, FAQ / help, Package, Gift, Sizing, Support, Time
Default: None
Open this tab firstOn/off
Default: Off
Tab group style
Only the FIRST tab block's style settings are used — they apply to the whole tab group. Link straight to a tab with #tab- plus its heading in lowercase with dashes, e.g. #tab-shipping-returns.
StyleChoice: Underline, Pills, Boxed (segmented), Minimal text
Default: Underline
AlignmentChoice: Left, Center, Stretch to full width
Default: Left
On mobileChoice: Wrap tabs onto lines, Scroll tabs sideways, Turn into an accordion
Default: Wrap tabs onto lines
Label sizeSlider 0–24px
Default: 0px
0 = default.
Label weightChoice: Default, Regular, Medium, Semibold, Bold
Default: Default
Uppercase labelsOn/off
Default: Off
Inactive label opacitySlider 20–100%
Default: 60%
Active label colorColor
Indicator / active backgroundColorUnderline color, or the active pill/box background.
Divider line colorColor
Panel backgroundColor
Panel paddingSlider 0–40px
Default: 0px
0 = none.
Panel corner radiusSlider 0–30px
Default: 0px
Fade in when switching tabsOn/off
Default: On
Top spacingSlider 0–60px
Default: 16px
Bottom spacingSlider 0–60px
Default: 16px

Content blocks

SettingTypeNotes
Reusable accordions (shipping, returns, care…) from a metaobject LIST. Per product: set the metafield below (any namespace.key). It takes priority; the default list is used for products without one.
HeadingText
Heading sizeSlider 0–40px
Default: 0px
0 = default.
Heading alignmentChoice: Left, Center, Right
Default: Left
Layout and behavior
LayoutChoice: Accordion, Bordered cards, Plain rows
Default: Accordion
Open behaviorChoice: All closed, Open first, Open all, One at a time
Default: All closed
Toggle iconChoice: Plus / minus, Chevron, Caret, None
Default: Plus / minus
Title weightChoice: Default, Regular, Medium, Semibold, Bold
Default: Default
Space between itemsSlider 0–24px
Default: 0px
Divider / border colorColor
Body text sizeSlider 0–20px
Default: 0px
0 = default.
Hide row iconsOn/off
Default: Off
Row icon sizeSlider 16–48px
Default: 24px
Open the first oneOn/off
Default: Off
Legacy — use "Open behavior" above instead.
Per-product metafield
Metafield namespaceText
Default: custom
Metafield keyText
Default: content_blocks
A product metafield of type "list of metaobject references". Overrides the default list for that product.
Field mapping
Which metaobject field fills each role. Defaults suit a metaobject with fields heading / body / icon / link / link_label. Blank roles are skipped.
Heading field keyText
Default: heading
Body field key (rich text)Text
Default: body
Icon field keyText
Default: icon
Link field key (URL)Text
Default: link
Link label field keyText
Default: link_label
The link's text, e.g. "Support". Falls back to "Learn more".
Open link in new tabOn/off
Default: Off
Default list
Default entriesTextType the entries: type: handle, handle (or just the type for all entries). No need for the connect button. Per-product entries are picked on the product's metafield (key above) and win over this list.

Spec highlights

SettingTypeNotes
Reusable label/value specs from a metaobject LIST. Per product: set the metafield below (any namespace.key). It takes priority; the default list is used for products without one.
HeadingText
ColumnsChoice: Auto-fit, 2 columns, 3 columns, 4 columns
Default: Auto-fit
LayoutChoice: Cards, Minimal (no border), Spec table, Chips, Icon list
Default: Cards
Mobile columnsChoice: Automatic, 1 column, 2 columns
Default: Automatic
Applies to Cards and Minimal layouts.
Content orderChoice: Label above value, Value above label
Default: Label above value
Items shown before "Show all"Slider 0–20
Default: 0
0 = show every item.
"Show all" labelText
Default: Show all specs
Row dividersOn/off
Default: Off
For Spec table, Icon list and Minimal layouts.
Per-product metafield
Metafield namespaceText
Default: custom
Metafield keyText
Default: specs
A product metafield of type "list of metaobject references". Overrides the default list below for that product.
Field mapping
Which metaobject field fills each role. Defaults suit a metaobject with fields label / value / icon / description / link. Unmapped roles are skipped.
Label field keyText
Default: label
Value field keyText
Default: value
Icon field keyText
Default: icon
Description field keyText
Default: description
Optional small line under the value.
Link field keyText
Default: link
Optional URL field — makes the whole tile clickable.
Open link in new tabOn/off
Default: Off
Default list
Default entriesTextType the entries: type: handle, handle (or just the type for all entries). No need for the connect button. Per-product entries are picked on the product's metafield (key above) and win over this list.
Icons
The icon field can be an image, or text naming a preset: truck, shield, leaf, recycle, ruler, box, award, clock, drop, star, heart, globe, bolt, check, info.
Icon sizeSlider 0–64px
Default: 0px
0 = default.
Icon styleChoice: Plain, Circle badge, Rounded-square badge
Default: Plain
Icon colorColorApplies to preset icons.
Icon badge backgroundColor
Heading
Heading sizeSlider 0–36px
Default: 0px
0 = default.
Heading weightChoice: Default, Regular, Medium, Semibold, Bold
Default: Default
Heading alignmentChoice: Left, Center, Right
Default: Left
Heading colorColor
Appearance
Content alignmentChoice: Left, Center
Default: Left
Show tile borderOn/off
Default: On
Tile backgroundColor
Border / divider colorColor
Corner radiusSlider 0–30px
Default: 0px
0 = theme default.
Gap between itemsSlider 0–40px
Default: 0px
0 = default.
Tile paddingSlider 0–40px
Default: 0px
0 = default.
Label colorColor
Label sizeSlider 0–24px
Default: 0px
0 = default.
Value colorColor
Value sizeSlider 0–32px
Default: 0px
0 = default.
Value weightChoice: Default, Regular, Medium, Semibold, Bold
Default: Default
Top spacingSlider 0–60px
Default: 0px
Bottom spacingSlider 0–60px
Default: 0px

Volume pricing

SettingTypeNotes
Uses Shopify's native volume pricing when the product has it configured (real, enforced-at-checkout prices — no extra setup). Otherwise falls back to the custom.quantity_breaks JSON metafield (list of {"quantity":N,"discount":PERCENT}), which DISPLAYS tiers only — pair it with a matching Shopify automatic discount to enforce. Hides when neither exists.
HeadingText
Default: Buy more, save more
Heading sizeSlider 0–32px
Default: 0px
0 = default.
Heading alignmentChoice: Left, Center, Right
Default: Left
Clicking a tier sets the quantityOn/off
Default: On
Layout
LayoutChoice: List, Table (with headers), Cards
Default: List
Qty column labelText
Default: Qty
Save column labelText
Default: Save
Price column labelText
Default: Price
Tiers
Show quantity rangesOn/off
Default: On
Shows 2–4, 5–9, 10+ instead of 2+, 5+, 10+.
Show the single-unit rowOn/off
Default: Off
Adds a 1+ row so the ladder starts at one.
Savings displayChoice: Percent off, Amount off per unit, Total saved, Don't show
Default: Percent off
Show total price per tierOn/off
Default: Off
"each" wordingTextBlank uses the theme translation.
Highlight
Highlight tier numberSlider 0–8
Default: 0
0 = none. 1 = the first tier, 2 = the second, and so on.
Badge textText
Default: Best value
Appearance
Tier border colorColor
Selected tier colorColor
Corner radiusSlider 0–24px
Default: 8px
Space between tiersSlider 0–20px
Default: 8px
Top spacingSlider 0–32px
Default: 0px
Bottom spacingSlider 0–32px
Default: 0px
Metafield fallback
Metafield namespaceText
Default: custom
Metafield keyText
Default: quantity_breaks
JSON list of {"quantity":N,"discount":PERCENT}. Ignored when native volume pricing is configured.

Variant specification

SettingTypeNotes
HeadingText
Default: Specifications
Metafield namespaceText
Default: custom
Fields (one per line)Text (multi-line)Format: key or key : Label. Row order = line order. Use CLEAN variant metafield keys (e.g. material) so collection filters stay clean. Leave blank to auto-detect legacy _1_/_2_ keys instead.
Heading sizeSlider 14–40px
Default: 20px
Heading alignmentChoice: Left, Center, Right
Default: Left
Layout
LayoutChoice: Rows (table), Grid (key–value cards), Inline (chips)
Default: Rows (table)
Row styleChoice: Divided, Striped, Borderless
Default: Divided
Applies to the Rows layout.
Divider colorColor
DensityChoice: Comfortable, Compact
Default: Comfortable
Labels and values
Label column widthSlider 20–60%
Default: 35%
Rows layout.
Label weightChoice: Regular, Medium, Semibold, Bold
Default: Semibold
Uppercase labelsOn/off
Default: Off
Label colorColor
Value alignmentChoice: Left, Right
Default: Left
Rows layout.
Color swatch sizeSlider 10–28px
Default: 14px
Collapsible
Show as collapsible sectionOn/off
Default: Off
Open by defaultOn/off
Default: On

Trust badges

SettingTypeNotes
LayoutChoice: Grid, Inline row with dividers, Cards, Compact list
Default: Grid
Badges per row (desktop)Choice: 1 column, 2 columns, 3 columns, 4 columns, Auto-fit
Default: 2 columns
Badges per row (mobile)Choice: 1 column, 2 columns, 3 columns, 4 columns, Auto-fit
Default: 1 column
Columns apply to Grid and Cards. Inline and Compact list flow on their own.
AlignmentChoice: Automatic, Left, Center
Default: Automatic
Automatic: 1 column puts the icon beside the text; 2+ columns stack it above centered text.
Badge 1
IconChoice: None, Shield, Lock, Truck, Return, Leaf, Gift, Support, Check, Medal, Card, Star, Clock, Globe
Default: Shield
Pick a built-in icon, or upload an image below.
Badge 1 iconImage
Badge 4 textText
Default: Secure checkout
SubtitleText
LinkLink
Badge 2
IconChoice: None, Shield, Lock, Truck, Return, Leaf, Gift, Support, Check, Medal, Card, Star, Clock, Globe
Default: Truck
Badge 2 iconImage
Badge 4 textText
Default: Free returns
SubtitleText
LinkLink
Badge 3
IconChoice: None, Shield, Lock, Truck, Return, Leaf, Gift, Support, Check, Medal, Card, Star, Clock, Globe
Default: Return
Badge 3 iconImage
Badge 4 textText
SubtitleText
LinkLink
Badge 4
IconChoice: None, Shield, Lock, Truck, Return, Leaf, Gift, Support, Check, Medal, Card, Star, Clock, Globe
Default: None
Badge 4 iconImage
Badge 4 textText
SubtitleText
LinkLink
Icons
Icon sizeSlider 0–48px
Default: 0px
0 = default.
Icon styleChoice: Plain, Circle, Rounded square
Default: Plain
Icon colorColorBuilt-in icons only.
Icon backgroundColorUsed by the Circle and Rounded square styles.
Text
Title sizeSlider 0–24px
Default: 0px
0 = default.
Title weightChoice: Default, Regular, Medium, Semibold, Bold
Default: Default
Text colorColor
Payment icons
Show payment iconsOn/off
Default: On
HeadingTexte.g. "Guaranteed safe and secure checkout".
Icon widthSlider 24–60px
Default: 36px
Monochrome iconsOn/off
Default: Off
Container
Background colorColorBlank = no background. Set it for a tinted panel.
Border colorColorBlank = no border. Also used for dividers and card borders.
Corner radiusSlider 0–30px
Default: 0px
0 = theme default.
Top spacingSlider 0–60px
Default: 12px
Bottom spacingSlider 0–60px
Default: 12px

Collapsible row

SettingTypeNotes
HeadingText
Default: Ingredients
Content sourceChoice: Rich text, Product metafield, Page, Shipping policy, Refund policy, Privacy policy, Terms of service
Default: Rich text
Store policies are edited in Settings > Policies.
ContentRich text
PagePage
Metafield namespaceText
Default: custom
Metafield keyTexte.g. "ingredients". Reads the product metafield namespace.key.
Hide this row when it has no contentOn/off
Default: On
Behavior
Open by defaultOn/off
Default: Off
Close other rows when this one opensOn/off
Default: Off
Applies among rows that all have this turned on.
Animate openingOn/off
Default: On
Icon and indicator
Heading iconChoice: None, Shipping (truck), Returns, Warranty / secure, Eco / natural, FAQ / help, Package, Gift, Sizing, Support, Time
Default: None
Custom icon imageImageReplaces the icon above.
Icon sizeSlider 0–40px
Default: 0px
0 = default.
Icon colorColor
Open/close indicatorChoice: Plus / minus, Chevron, Caret, None
Default: Plus / minus
Indicator positionChoice: Right, Left
Default: Right
Style
Row styleChoice: Divider lines, Cards, Filled
Default: Divider lines
Heading sizeSlider 0–28px
Default: 0px
0 = default.
Heading weightChoice: Default, Regular, Medium, Semibold, Bold
Default: Default
Uppercase headingOn/off
Default: Off
Content text sizeSlider 0–22px
Default: 0px
0 = default.
Text colorColor
Border colorColor
Background colorColorUsed by Cards and Filled.
Corner radiusSlider 0–24px
Default: 0px
Cards and Filled. 0 = theme default.
Heading paddingSlider 0–32px
Default: 0px
0 = default.
Top spacingSlider 0–40px
Default: 0px
Bottom spacingSlider 0–40px
Default: 0px

Back-in-stock

SettingTypeNotes
Shown automatically when the selected variant is sold out. Submissions email the store (via the contact form) as a notify-me request.
PresentationChoice: Inline (plain), Inline (card), Button opens popup
Default: Inline (card)
Popup button labelText
Default: Notify me when available
Open popup automatically when a sold-out variant is selectedOn/off
Default: Off
HeadingText
Default: Notify me when available
Use [variant] to insert the selected variant name.
Replace [variant] with the selected variantOn/off
Default: Off
Button labelText
Default: Notify me
Fields
CollectChoice: Email only, Phone only (SMS), Email and phone, Shopper chooses email or phone
Default: Email only
Phone and text-message options need a connected back-in-stock app (Theme settings > Back in stock > App). In Theme mode only email is collected.
Ask for nameOn/off
Default: Off
Email placeholderText
Default: you@example.com
Phone placeholderText
Default: +1 555 000 0000
Name placeholderText
Default: Your name
Consent and privacy
Marketing consent checkboxChoice: Hidden, Shown, optional, Shown, required to submit
Default: Hidden
Restock alerts are transactional; this checkbox is for additional marketing consent.
Consent labelText
Default: Yes, email me news and offers too.
Privacy noteText
Privacy policy linkLink
When to show
Show the form whenChoice: Variant is sold out, Sold out or low stock, Always
Default: Variant is sold out
Low stock thresholdSlider 1–50
Default: 5
Hide on variants that continue selling when out of stockOn/off
Default: On
Messages
Helper textTextShown under the fields. Supports [variant].
Success messageTextLeave blank for the theme default.
Error messageTextLeave blank for the theme default.
Layout
Desktop layoutChoice: Field and button on one row, Stacked
Default: Field and button on one row
Mobile layoutChoice: Field and button on one row, Stacked
Default: Stacked
Full-width buttonOn/off
Default: Off
Button iconChoice: None, Bell, Envelope
Default: None
Appearance
Heading sizeSlider 0–30px
Default: 0px
0 = default.
Heading weightChoice: Default, Regular, Medium, Semibold, Bold
Default: Default
AlignmentChoice: Left, Center
Default: Left
Text colorColor
Accent colorColor
Background colorColor
Border colorColor
Corner radiusSlider 0–30px
Default: 0px
0 = theme default.
Inner paddingSlider 0–40px
Default: 14px
Top spacingSlider 0–60px
Default: 12px
Bottom spacingSlider 0–60px
Default: 12px

Discount text

SettingTypeNotes
Reads a product tag shaped CODE_DISCOUNT_amount (e.g. SUMMER_DISCOUNT_20%) and shows the code and amount. No app required.
Lead-in textText
Default: Save
Connector textTextBetween the amount and the code. Default: "with code".
Make code click-to-copyOn/off
Default: On
Accent colorColor
AlignmentChoice: Left, Center, Right
Default: Left
Font sizeSlider 0–28px
Default: 0px
0 = default.
Font weightChoice: Default, Regular, Medium, Semibold, Bold
Default: Default
Style
PresentationChoice: Plain text, Pill badge, Tinted banner, Dashed ticket
Default: Plain text
Background colorColor
Default: #fbeaea
Icon
IconChoice: None, Tag, Percent, Spark, Gift, Emoji (custom)
Default: Tag
EmojiText
Default: 🏷️
Icon positionChoice: Before text, After text
Default: Before text

Variant description

SettingTypeNotes
Shows a per-variant description from a variant metafield and updates as the shopper switches variants.
HeadingText
Metafield namespaceText
Default: custom
Metafield keyText
Default: variant_description

SKU

SettingTypeNotes
LabelText
Default: SKU:
Text styleChoice: Body, Subtitle, Uppercase
Default: Body
Hide label (show value only)On/off
Default: Off
Click to copy SKUOn/off
Default: Off
Monospace valueOn/off
Default: Off
UppercaseOn/off
Default: Off
WeightChoice: Default, Regular, Medium, Semibold, Bold
Default: Default
Text colorColor
AlignmentChoice: Left, Center, Right
Default: Left
Top spacingSlider 0–32px
Default: 4px
Bottom spacingSlider 0–32px
Default: 4px
Show even when the SKU is emptyOn/off
Default: Off

Custom Liquid

SettingTypeNotes
Custom LiquidLiquidAdd app snippets or other Liquid code to create advanced customizations.

Text

SettingTypeNotes
TextRich text (one line)
Default: Add a short line of text.
Text styleChoice: Body, Subtitle, Uppercase
Default: Body
AlignmentChoice: Left, Center, Right
Default: Left
Font sizeSlider 0–32px
Default: 0px
0 = style default.
Font weightChoice: Default, Regular, Medium, Semibold, Bold
Default: Default
Text colorColor
Icon
Icon (emoji)TextOptional, shown before the text.
Icon sizeSlider 12–40px
Default: 18px
Callout
Callout styleChoice: None (plain), Tinted box, Bordered, Left accent bar
Default: None (plain)
Background colorColor
Default: #f4f4f4
Accent / border colorColor
Default: #1a1a1a
Corner radiusSlider 0–24px
Default: 8px
Inner paddingSlider 4–32px
Default: 12px
Spacing
Top spacingSlider 0–40px
Default: 6px
Bottom spacingSlider 0–40px
Default: 6px

Complementary products

SettingTypeNotes
Shows products that pair well with this one. Choose them per product in the Shopify Search and Discovery app. The block stays hidden when a product has none.
HeadingText
Default: Pairs well with
Maximum productsSlider 1–6
Default: 3
Product reviews
SettingTypeNotes
Turn on reviews in Theme settings > Reviews. Using another reviews app? Add its block here (Add block > Apps) and turn My patterns reviews off.
HeadingText
Default: Reviews
Color schemeColor scheme
Heading sizeSlider 18–60px
Default: 30px
Heading alignmentChoice: Left, Center, Right
Default: Left
Heading alignment (mobile)Choice: Same as desktop, Left, Center, Right
Default: Same as desktop
Reviews added by hand
Reviews sourceText
Default: custom.customer_reviews
A product list metafield (namespace.key) of review entries, so each product shows its own. A metaobject type or "type: handle, handle" also works. A connected reviews app replaces this list.
Field keysTextOnly if your definition uses other field keys: author=your_key, rating=your_key. Fields read: author, rating (1–5), title, body, date, verified, image.
Summary
Show rating breakdownOn/off
Default: On
Star colorColor
Default: #f5a623
Star sizeSlider 12–26px
Default: 16px
Review list
Columns (desktop)Choice: 1 column, 2 columns
Default: 1 column
Show reviewer initialsOn/off
Default: On
Show review datesOn/off
Default: On
Reviews per pageSlider 5–50
Default: 10
Used when a reviews app supplies the list.
Default sortChoice: Newest, Highest rated, Lowest rated, Most helpful
Default: Newest
Show rating / photo filtersOn/off
Default: On
Appears only when a connected reviews app supports filtering.
Write a review
Show "Write a review" buttonOn/off
Default: On
Appears only when a connected reviews app accepts submissions.
Button labelText
Default: Write a review
Spacing
Top paddingSlider 0–120px
Default: 40px
Bottom paddingSlider 0–120px
Default: 40px
Top padding (mobile)Slider 0–120px
Default: 32px
Bottom padding (mobile)Slider 0–120px
Default: 32px
Design
Heading weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase headingOn/off
Default: Off
Heading size (mobile)Slider 14–44px
Default: 24px
Heading colorColor
Section divider
Top dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Bottom dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Divider colorColorUsually the color of the adjacent section/background.
Divider heightSlider 8–160px
Default: 40px
Width
Section widthChoice: Standard, Wide, Full width
Default: Standard
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Also accepts: app blocks.

Product specifications
SettingTypeNotes
Hidden automatically when a product has no values. Rows with an empty value are skipped.
Content fromChoice: Rows (blocks + metafields), Specification groups (metaobjects), Comparison with other products
Default: Rows (blocks + metafields)
Rows: each Row block reads a metafield key such as custom.width, or connect its Value to a metafield. Groups: connect below to a product metafield listing "specification_group" entries (title + one "Label: Value" per line). Comparison: Row keys are read for every product.
Specification groups sourceText
Default: custom.spec_groups
Used with "Specification groups". A product list metafield (namespace.key), a metaobject type, or "type: handle, handle".
Field keysTextOnly if your definition uses other field keys: title=your_key, rows=your_key.
Compare withProductsUsed with "Comparison". Connect to a product metafield (list of products) for per-product comparisons.
Heading
HeadingRich text (one line)
Default: Craftsmanship & specifications
SubheadingText
Default: Materials, dimensions & care
Heading sizeSlider 20–72px
Default: 40px
Heading alignmentChoice: Left, Center
Default: Left
Layout
LayoutChoice: Columns, Table, Cards, Accordion
Default: Columns
Columns on desktopSlider 1–4
Default: 4
Number the groups (01 / 02 …)On/off
Default: On
Open groupsChoice: First, All, None
Default: First
Value styleChoice: Large, heading font, Regular
Default: Large, heading font
Uppercase labelsOn/off
Default: On
Divider linesOn/off
Default: On
Comparison
Show product imagesOn/off
Default: On
Highlight this product's columnOn/off
Default: On
Section
Color schemeColor scheme
WidthChoice: Standard, Wide, Full width
Default: Standard
Top paddingSlider 0–120px
Default: 72px
Bottom paddingSlider 0–120px
Default: 72px
Top padding (mobile)Slider 0–120px
Default: 48px
Bottom padding (mobile)Slider 0–120px
Default: 48px
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Blocks

Group

SettingTypeNotes
TitleText
Default: Materials
Rows after this block belong to this group until the next Group.

Row

SettingTypeNotes
LabelText
Default: Material
Metafield keyTextnamespace.key, e.g. custom.material. Built-ins: product.vendor, product.type, product.category, variant.sku, variant.barcode, variant.weight.
ValueRich text (one line)Used when the key is empty or has no value. Connect a dynamic source to read any metafield.
Products by metafield
SettingTypeNotes
HeadingRich text (one line)
Default: Metafield products
Heading font sizeSlider 15–60px
Default: 27px
Heading alignmentChoice: Left, Center, Right
Default: Left
Heading alignment (mobile)Choice: Same as desktop, Left, Center, Right
Default: Same as desktop
DescriptionRich text
Description styleChoice: Body, Subtitle, Uppercase
Default: Body
Maximum products to showSlider 2–24
Default: 8
Number of columns on desktopSlider 2–6
Default: 4
Slider Product viewOn/off
Default: On
On: horizontal slider. Off: static grid.
Show Slider CounterOn/off
Default: Off
Auto-rotate sliderOn/off
Default: Off
Auto-rotate speedSlider 2–10s
Default: 4s
Color schemeColor scheme
Product card
Image ratioChoice: Adapt to image, Portrait, Square
Default: Adapt to image
Image shapeChoice: Default, Arch, Blob, Round, Diamond, Parallelogram, Chevron left, Chevron right
Default: Default
Standard-styled cards have no borders when an image shape is active.
Show second image on hoverOn/off
Default: Off
Show vendorOn/off
Default: Off
Show rating on cardsOn/off
Default: Off
Shows stars when a product has a reviews rating metafield.
Enable quick add buttonOn/off
Default: On
Quick add button styleChoice: Outline button, Solid button
Default: Outline button
Mobile Layout
Number of columns on mobileChoice: 1 column, 2 columns
Default: 2 columns
Enable swipe on mobileOn/off
Default: On
Slider view only. Off shows a stacked grid on mobile.
Section padding
Top paddingSlider 0–100px
Default: 48px
Bottom paddingSlider 0–100px
Default: 48px
Top padding (mobile)Slider 0–100px
Default: 36px
Bottom padding (mobile)Slider 0–100px
Default: 36px
Button
Button labelTextOptional link below the rail (e.g. to a full collection).
Button linkLink
Design
Heading weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase headingOn/off
Default: Off
Heading size (mobile)Slider 14–44px
Default: 22px
Heading colorColor
Section divider
Top dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Bottom dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Divider colorColorUsually the color of the adjacent section/background.
Divider heightSlider 8–160px
Default: 40px
Width
Section widthChoice: Standard, Wide, Full width
Default: Standard
Metafield source
Reads a list of products from a product metafield. Keep these matching your metafield definition.
Metafield namespaceText
Default: custom
Only change this if your product metafield uses a namespace other than custom.
Metafield keyText
Default: metafield_products
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).
Quick view
SettingTypeNotes
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Pages and templates

404
SettingTypeNotes
Color schemeColor scheme
HeadingText
Default: 404
MessageTextLeave blank for the translated default.
Button labelTextLeave blank for the translated default.
Button styleChoice: Primary, Secondary
Default: Primary
Secondary button labelText
Secondary button linkLink
Secondary button styleChoice: Primary, Secondary
Default: Secondary
Show search barOn/off
Default: On
Live suggestions while typingOn/off
Default: On
Quick links headingText
Default: Helpful links
Add Quick link blocks to show pills.
Image
Image or illustrationImage
LayoutChoice: Image above text, Image beside text
Default: Image above text
Image widthSlider 120–700px
Default: 360px
Title style
Title sizeSlider 40–160px
Default: 96px
Title size (mobile)Slider 32–120px
Default: 64px
Title weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Bold
Uppercase titleOn/off
Default: Off
Title colorColor
Product recovery
Show a product gridOn/off
Default: On
HeadingTextLeave blank for the translated default.
CollectionCollection
Products to showSlider 2–12
Default: 4
Columns on desktopSlider 2–5
Default: 4
Show quick addOn/off
Default: Off
Section padding
Top paddingSlider 0–160px
Default: 64px
Bottom paddingSlider 0–160px
Default: 64px
Padding top (mobile)Slider 0–120px
Default: 40px
Padding bottom (mobile)Slider 0–120px
Default: 40px
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Blocks

Quick link

SettingTypeNotes
LabelText
Default: New arrivals
LinkLink
Article
SettingTypeNotes
Color schemeColor scheme
Header
Header alignmentChoice: Left, Center, Right
Default: Center
Header alignment (mobile)Choice: Same as desktop, Left, Center, Right
Default: Same as desktop
Show breadcrumbsOn/off
Default: On
Show "Back to blog" linkOn/off
Default: On
Show dateOn/off
Default: On
Show authorOn/off
Default: On
Show reading timeOn/off
Default: On
Show comment countOn/off
Default: On
Title sizeSlider 24–96px
Default: 48px
Title size (mobile)Slider 18–64px
Default: 32px
Title weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase titleOn/off
Default: Off
Title letter spacingSlider 0–4px
Default: 0px
Title colorColor
Featured image
Hero layoutChoice: Title, then image, Image, then title, Title over image, Image beside title
Default: Title, then image
Show featured imageOn/off
Default: On
Full-width featured imageOn/off
Default: Off
Image shapeChoice: Original, Wide (16:9), Landscape (3:2), Classic (4:3)
Default: Original
Content
Content widthSlider 560–1000px
Default: 760px
Text sizeSlider 0–24px
Default: 0px
0 = default.
Line heightSlider 0–2.4
Default: 0
0 = default.
Link colorColor
Drop cap on the first paragraphOn/off
Default: Off
Table of contentsChoice: Off, Above the content, Sticky sidebar (desktop)
Default: Off
Built from the article's H2 headings; shown when there are 2 or more.
Reading progress barOn/off
Default: Off
Show tagsOn/off
Default: On
Show share buttonOn/off
Default: On
Share styleChoice: Share button, Network icons
Default: Share button
Show previous / next articleOn/off
Default: On
Show author bioOn/off
Default: On
Article metafield custom.author → Author metaobject.
Comments
Show commentsOn/off
Default: On
Also requires comments enabled in the blog's settings.
Related posts
Show related postsOn/off
Default: On
Number of postsSlider 2–4
Default: 3
Image ratioChoice: Landscape (3:2), Square (1:1), Portrait (3:4)
Default: Landscape (3:2)
Section padding
Top paddingSlider 0–100px
Default: 40px
Bottom paddingSlider 0–100px
Default: 48px
Padding top (mobile)Slider 0–100px
Default: 28px
Padding bottom (mobile)Slider 0–100px
Default: 32px
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Also accepts: app blocks.

Blog posts
SettingTypeNotes
Color schemeColor scheme
Header
Header alignmentChoice: Left, Center, Right
Default: Center
Header alignment (mobile)Choice: Same as desktop, Left, Center, Right
Default: Same as desktop
Intro textRich text
Show tag filter barOn/off
Default: On
Tags on mobileChoice: Wrap onto lines, Scroll sideways, Dropdown
Default: Scroll sideways
Show RSS feed linkOn/off
Default: Off
Title sizeSlider 20–90px
Default: 44px
Title size (mobile)Slider 16–60px
Default: 30px
Title weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase titleOn/off
Default: Off
Title letter spacingSlider 0–4px
Default: 0px
Title colorColor
Featured post
Highlight newest postOn/off
Default: On
Large hero card on page 1 (hidden when a tag is selected).
Featured articleArticleLeave empty to feature the newest post.
Featured styleChoice: Image left, Image right, Text over image
Default: Image left
Article grid
LayoutChoice: Grid, List (image beside text), Magazine (lead story + grid)
Default: Grid
Posts per pageSlider 6–24
Default: 12
Columns on desktopSlider 2–4
Default: 3
Columns on mobileChoice: 1, 2
Default: 1
Image ratioChoice: Landscape (3:2), Square (1:1), Portrait (3:4), Natural
Default: Landscape (3:2)
Column gapSlider 0–60px
Default: 16px
Row gapSlider 0–80px
Default: 40px
Article cards
Card styleChoice: Plain, Bordered, Text over image
Default: Plain
Zoom image on hoverOn/off
Default: On
Show dateOn/off
Default: On
Show reading timeOn/off
Default: Off
Show tag on cardsOn/off
Default: On
Show author on cardsOn/off
Default: On
Show excerpt on cardsOn/off
Default: On
Excerpt length (words)Slider 8–60
Default: 22
Show "Read more"On/off
Default: On
PaginationChoice: Numbered pages, Load more button, Infinite scroll
Default: Numbered pages
Section padding
Top paddingSlider 0–100px
Default: 48px
Bottom paddingSlider 0–100px
Default: 48px
Padding top (mobile)Slider 0–100px
Default: 32px
Padding bottom (mobile)Slider 0–100px
Default: 32px
Section widthChoice: Standard, Wide, Full width
Default: Standard
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Also accepts: app blocks.

Cart
SettingTypeNotes
Color schemeColor scheme
Layout
LayoutChoice: Items + order summary (2 columns), Stacked (1 column)
Default: Items + order summary (2 columns)
Sticky order summaryOn/off
Default: On
Keeps the summary in view while scrolling (2-column layout, desktop).
Show "Continue shopping" linkOn/off
Default: On
Order summary styleChoice: Bordered card, Plain, Tinted panel
Default: Bordered card
Order summary backgroundColor
Sticky checkout bar on mobileOn/off
Default: Off
Keeps the subtotal and checkout button in view on phones.
Line items
Image sizeSlider 60–160px
Default: 90px
Show original price next to each item priceOn/off
Default: Off
Show "You save" per itemOn/off
Default: Off
Remove buttonChoice: Text link, Trash icon
Default: Text link
Discounts and shipping
Show discount code fieldOn/off
Default: Off
Show shipping estimatorOn/off
Default: Off
Uses your Shopify shipping rates. The first estimate can take a few seconds.
Checkout
Checkout button labelTextLeave blank for the theme default.
Show express checkout buttonsOn/off
Default: On
Shop Pay, PayPal, Apple Pay and others, when enabled in Payments.
Require terms agreementOn/off
Default: Off
Terms labelRich text (one line)Leave blank for the default. Link your terms page here.
Empty cart
Empty cart headingTextLeave blank for the theme default.
Suggested collectionCollectionShows 4 products when the cart is empty.
Title
Header alignmentChoice: Left, Center, Right
Default: Left
Title sizeSlider 18–80px
Default: 40px
Title size (mobile)Slider 16–60px
Default: 28px
Title weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase titleOn/off
Default: Off
Title letter spacingSlider 0–4px
Default: 0px
Title colorColor
Trust and payment
Show trust blockOn/off
Default: On
Secure checkout textText
Default: Secure checkout — encrypted & protected
Show accepted payment iconsOn/off
Default: On
Recommendations
Show "You might also like"On/off
Default: On
HeadingText
Default: You might also like
Number of productsSlider 2–6
Default: 4
Section padding
Top paddingSlider 0–100px
Default: 48px
Bottom paddingSlider 0–100px
Default: 48px
Padding top (mobile)Slider 0–100px
Default: 32px
Padding bottom (mobile)Slider 0–100px
Default: 32px
Section widthChoice: Standard, Wide, Full width
Default: Standard
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Also accepts: app blocks.

Blocks

Trust item

SettingTypeNotes
Icon (emoji)Text
Default: 🚚
TextText
Default: Free returns within 30 days
Collection navigation
SettingTypeNotes
ShowChoice: Sub-collections from a menu, Collection metafield (custom.subcollections), Collections picked below
Default: Sub-collections from a menu
Hidden on collections with nothing to show.
MenuMenuThe current collection is looked up in this menu; its sub-items are shown, or its siblings if it has none.
CollectionsCollections
HeadingText
StyleChoice: Pills, Round images, Image cards, Text links
Default: Pills
Image sizeSlider 48–200px
Default: 88px
Show product countOn/off
Default: Off
For metafield and picked collections.
AlignmentChoice: Left, Center
Default: Left
Swipe on mobileOn/off
Default: On
Color schemeColor scheme
Top paddingSlider 0–80px
Default: 16px
Bottom paddingSlider 0–80px
Default: 16px
List collections
SettingTypeNotes
Color schemeColor scheme
Header
Header alignmentChoice: Left, Center, Right
Default: Left
HeadingRich text (one line)
Default: Collections
Heading font sizeSlider 15–100px
Default: 40px
Heading font size (mobile)Slider 14–64px
Default: 28px
Heading weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase headingOn/off
Default: Off
Heading letter spacingSlider 0–4px
Default: 0px
Heading colorColor
DescriptionRich text (one line)
Default: Browse every collection in the store.
Description styleChoice: Subtitle, Uppercase
Default: Subtitle
Collections to show
ShowChoice: All collections, Selected collections
Default: All collections
CollectionsCollectionsShown in this order. Used when "Selected collections" is chosen.
Hide empty collectionsOn/off
Default: Off
Exclude collectionsTextComma-separated handles, e.g. frontpage, all
Collections per pageSlider 12–50
Default: 48
All collections mode. Sorting applies within each page.
Layout
LayoutChoice: Grid of tiles, A–Z index
Default: Grid of tiles
The A–Z index groups collections by first letter with a jump bar — ideal for brands.
A–Z index styleChoice: Names only, Names with thumbnails
Default: Names only
Gap (desktop)Slider 0–60px
Default: 16px
Gap (mobile)Slider 0–32px
Default: 16px
Cards
Card styleChoice: Text below image, Text over image
Default: Text below image
Show product countOn/off
Default: On
Image overlaySlider 0–90%
Default: 30%
Overlay text colorColor
Default: #ffffff
Overlay text positionChoice: Top, Middle, Bottom
Default: Bottom
Zoom image on hoverOn/off
Default: Off
Image corner radiusSlider 0–40px
Default: 0px
0 = theme default.
Show description excerptOn/off
Default: Off
Below-image style only.
Call to actionTexte.g. "Shop now". Leave blank to hide.
Sort collections byChoice: Alphabetically, A-Z, Alphabetically, Z-A, Date, new to old, Date, old to new, Product count, high to low, Product count, low to high
Default: Alphabetically, A-Z
Image ratioChoice: Adapt to image, Portrait, Square, Landscape, Circle
Default: Portrait
Add images by editing your collections.
Number of columns on desktopSlider 1–5
Default: 3
Mobile Layout
Number of columns on mobileChoice: 1 column, 2 columns
Default: 2 columns
Section padding
Top paddingSlider 0–100px
Default: 48px
Bottom paddingSlider 0–100px
Default: 48px
Padding top (mobile)Slider 0–100px
Default: 32px
Padding bottom (mobile)Slider 0–100px
Default: 32px
Section widthChoice: Standard, Wide, Full width
Default: Standard
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).
Page
SettingTypeNotes
Color schemeColor scheme
Header
Show page titleOn/off
Default: On
Show breadcrumbsOn/off
Default: On
Above the title. With a banner, use "Show breadcrumbs in banner" below.
Header alignmentChoice: Left, Center, Right
Default: Center
SubtitleRich text (one line)Per page: a page metafield custom.subtitle overrides this.
Subtitle sizeSlider 0–28px
Default: 0px
0 = default.
Subtitle colorColor
Under the title showChoice: Nothing, Published date, Reading time, Date and reading time
Default: Nothing
Divider under the headerOn/off
Default: Off
Title sizeSlider 20–90px
Default: 44px
Title size (mobile)Slider 16–60px
Default: 30px
Title weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase titleOn/off
Default: Off
Title letter spacingSlider 0–4px
Default: 0px
Title colorColor
Banner image
Give a single page its own banner with a page metafield custom.banner_image (type: file / image). It shows on that page even when the banner below is off.
Use a banner image behind the titleOn/off
Default: Off
Banner imageImageSet a focal point on the image to control cropping.
Mobile banner imageImageOptional. Used below 750px.
Banner heightSlider 160–640px
Default: 320px
Text positionChoice: Top, Middle, Bottom
Default: Middle
Banner overlaySlider 0–90%
Default: 35%
Overlay colorColor
Default: #000000
Banner text colorColor
Default: #ffffff
Show breadcrumbs in bannerOn/off
Default: Off
Content
Constrain content width (recommended for reading)On/off
Default: On
Content widthSlider 560–1100px
Default: 820px
Text sizeSlider 0–22px
Default: 0px
0 = default.
Line heightSlider 0–2.4
Default: 0
0 = default.
Link colorColor
Image corner radiusSlider 0–30px
Default: 0px
Table of contents
Table of contentsChoice: Off, Above the content, Sticky sidebar (desktop)
Default: Off
Built from the page's headings. Shown only when there are 2 or more. The sidebar sits above the content on mobile.
TitleText
Default: On this page
IncludeChoice: Main headings (H2), Headings and subheadings (H2 + H3)
Default: Main headings (H2)
Section padding
Top paddingSlider 0–120px
Default: 40px
Bottom paddingSlider 0–120px
Default: 56px
Padding top (mobile)Slider 0–120px
Default: 28px
Padding bottom (mobile)Slider 0–120px
Default: 40px
Section widthChoice: Standard, Wide, Full width
Default: Standard
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Also accepts: app blocks.

Password
SettingTypeNotes
Color schemeColor scheme
HeadingRich text (one line)
Default: Opening soon
TextRich text
Logo widthSlider 60–400px
Default: 150px
Uses the logo from Theme settings.
Title style
Heading sizeSlider 18–80px
Default: 40px
Heading size (mobile)Slider 16–60px
Default: 30px
Heading weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase headingOn/off
Default: Off
Layout and background
LayoutChoice: Centered, Split (image beside content), Full-screen background
Default: Centered
Background imageImage
Mobile background imageImageOptional. Used below 750px.
Image overlaySlider 0–90%
Default: 40%
Text color over imageColor
Default: #ffffff
Content cardChoice: None, Solid panel, Frosted glass
Default: None
Keeps text readable over busy images.
Launch countdown
Launch dateTextYYYY-MM-DD HH:MM, e.g. 2026-11-01 09:00. Leave blank to hide. Hides itself at zero.
Timezone offsetText
Default: +00:00
e.g. +05:30 for India.
Countdown labelText
Default: Launching in
Notify me signup
Show email signupOn/off
Default: On
When off, the password form is shown open.
Signup headingText
Default: Be the first to know when we launch.
Signup button labelText
Default: Notify me
Success messageTextLeave blank for the theme default.
Consent noteRich text (one line)e.g. "We'll only email you about our launch." with a privacy link.
Social
Show social iconsOn/off
Default: On
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).
Product grid
SettingTypeNotes
Color schemeColor scheme
Show collection descriptionOn/off
Default: On
Long descriptions can sit below the grid and be trimmed with Read more.
Description positionChoice: Above the grid, Above the grid, page 1 only, Below the grid, Below the grid, page 1 only
Default: Above the grid
"Page 1 only" avoids repeating long text on every paginated page (better for SEO).
Trim description to linesSlider 0–12
Default: 0
0 = show in full. Longer text gets a Read more toggle.
Collection header / banner
Use collection image as bannerOn/off
Default: Off
Shows the collection featured image behind the title.
Fallback banner imageImageUsed for collections without their own image. Set a focal point to control cropping.
Banner heightSlider 160–640px
Default: 320px
Banner text alignChoice: Left, Center, Right
Default: Center
Banner overlaySlider 0–90%
Default: 35%
Banner text colorColor
Title sizeSlider 18–80px
Default: 40px
Title size (mobile)Slider 16–60px
Default: 28px
Title weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase titleOn/off
Default: Off
Title letter spacingSlider 0–4px
Default: 0px
Title colorColor
Breadcrumbs are controlled in Theme settings → Breadcrumbs.
Filtering and sorting
Enable filteringOn/off
Default: On
Add filters in Search & Discovery, or Settings.
Filter layout (desktop)Choice: Sidebar, Horizontal bar, Drawer
Default: Sidebar
Applies only when filtering is enabled.
Filter layout (mobile)Choice: Screen bottom bar, Drawer
Default: Screen bottom bar
Sticky sidebar filtersOn/off
Default: On
Keeps the sidebar in view while scrolling (Sidebar layout only).
Enable quick addOn/off
Default: On
Products per pageSlider 8–48
Default: 16
Columns on desktopSlider 2–6
Default: 4
Columns on mobileChoice: 1, 2
Default: 2
Grid
Column gap (desktop)Slider 0–48px
Default: 16px
Row gap (desktop)Slider 0–64px
Default: 16px
Gap (mobile)Slider 0–32px
Default: 16px
Shopper view switcherChoice: Off, Column choices, Column choices + list view
Default: Off
Lets shoppers pick 2/3/4 columns on desktop or 1/2 on mobile. Their choice is remembered.
Product cards on this page
Image ratioChoice: Use theme setting, Square, Portrait, Match image
Default: Use theme setting
Second image on hoverChoice: Use theme setting, On, Off
Default: Use theme setting
Star ratingChoice: Use theme setting, Show, Hide
Default: Use theme setting
Quick add buttonChoice: Outline, Solid, Icon only
Default: Outline
Pagination styleChoice: Page numbers, Load more button, Infinite scroll
Default: Page numbers
Show "Showing X of Y" progressOn/off
Default: On
Load more and infinite scroll.
Section padding
Top paddingSlider 0–100px
Default: 48px
Space above the title (below the breadcrumbs).
Bottom paddingSlider 0–100px
Default: 48px
Padding top (mobile)Slider 0–100px
Default: 32px
Padding bottom (mobile)Slider 0–100px
Default: 32px
Section widthChoice: Standard, Wide, Full width
Default: Standard
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Also accepts: app blocks.

Blocks

In-grid promo

SettingTypeNotes
Inserts a promo tile into the product grid after the chosen product position.
Insert after product #Slider 1–48
Default: 4
Desktop column spanSlider 1–3
Default: 2
Desktop heightChoice: One row, Two rows
Default: One row
Width on mobileChoice: 1 column, 2 columns
Default: 2 columns
Show on the first page onlyOn/off
Default: Off
ImageImage
HeadingText
Default: Sale
TextText
Button labelText
LinkLink
Image overlaySlider 0–90%
Default: 25%
Text colorColor

Cart and pop-ups

Cart drawer
SettingTypeNotes
Cart behavior (line prices, note, gift wrap, upsells, free-shipping bar, savings) is set in Theme settings → Cart, shared with the cart page. These controls style the drawer itself.
Drawer
WidthSlider 320–560px
Default: 420px
Slide fromChoice: Right, Left
Default: Right
Panel corner radiusSlider 0–32px
Default: 0px
Rounds the inner edge of the drawer.
Full width on mobileOn/off
Default: Off
Overlay colorColor
Default: #000000
Overlay opacitySlider 0–90%
Default: 40%
Open animationChoice: Slide, Fade
Default: Slide
Animation speedSlider 100–600ms
Default: 250ms
Header
Show item count in titleOn/off
Default: On
Header divider lineOn/off
Default: On
Footer
Show "Continue shopping" linkOn/off
Default: Off
Express checkout labelTextShown above the dynamic checkout buttons. Leave blank to hide.
Show payment iconsOn/off
Default: On
Renders the payment methods enabled on your store.
Show secure-checkout noteOn/off
Default: Off
Secure-checkout textText
Default: Secure checkout
Empty state
Show products when cart is emptyOn/off
Default: Off
Empty-state headingText
Default: Popular right now
Empty-state collectionCollectionUsed when "Show products when cart is empty" is on.
Advanced
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).
Cart recommendations
SettingTypeNotes
These style the upsell cards shown in the cart drawer. The heading, product count, and curated-vs-automatic source are set in Theme settings → Cart.
Add button styleChoice: Outline, Solid
Default: Outline
Add button labelTextLeave blank for the default "Add to cart".
Show priceOn/off
Default: On
Show compare-at (sale) priceOn/off
Default: On
Show vendorOn/off
Default: Off
Show rating starsOn/off
Default: Off
Image shapeChoice: Square, Rounded, Circle
Default: Rounded
Image sizeSlider 48–96px
Default: 60px
Newsletter popup
SettingTypeNotes
Enable popupOn/off
Default: On
Turn the popup off without deleting it. It still previews here in the editor.
Delay before showingSlider 0–30s
Default: 5s
Days before showing againSlider 0–30d
Default: 7d
When to show
Open afterChoice: A delay (seconds above), Scrolling part of the page, Exit intent (desktop), Visiting a number of pages
Default: A delay (seconds above)
Exit intent opens when the pointer leaves toward the browser bar. Touch devices fall back to the delay.
Scroll depthSlider 10–90%
Default: 40%
Pages visitedSlider 2–10
Default: 2
Show onChoice: All pages, Homepage only, All pages except cart
Default: All pages
DevicesChoice: Desktop and mobile, Desktop only, Mobile only
Default: Desktop and mobile
Hide from logged-in customers who already subscribeOn/off
Default: On
Shoppers who sign up through this popup never see it again on that browser.
Desktop imageImage
Mobile imageImage
Image height (desktop · Top layout)Slider 120–600px
Default: 240px
Image height (mobile)Slider 120–500px
Default: 180px
Popup width (desktop)Slider 360–900px
Default: 720px
Spacing between blocksSlider 0–40px
Default: 16px
LayoutChoice: Image beside content, Image above content, Background
Default: Image beside content
Backdrop opacitySlider 0–90%
Default: 60%
Content alignmentChoice: Left, Center, Right
Default: Center
Corner radiusSlider 0–40px
Default: 12px
Mobile styleChoice: Centered, Bottom sheet
Default: Bottom sheet
Bottom sheet slides up from the bottom of the screen — easier to reach on mobile.
Colors
Background colorColor
Default: #ffffff
Text colorColor
Default: #1a1a1a
Close and animation
Close buttonChoice: Inside the popup, Solid circle, Screen corner
Default: Inside the popup
Backdrop blurSlider 0–12px
Default: 0px
Entrance animationChoice: Zoom in, Fade, Slide up
Default: Zoom in
Teaser tab
Show a teaser tab after the popup is closedOn/off
Default: Off
A small floating button that re-opens the popup. Hidden once the shopper subscribes.
Teaser textText
Default: Get 10% off
Teaser positionChoice: Bottom left, Bottom right
Default: Bottom left
Teaser backgroundColor
Teaser text colorColor
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Blocks

Heading

SettingTypeNotes
HeadingRich text (one line)
Default: Join the list
Font sizeSlider 16–64px
Default: 32px
Heading weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase headingOn/off
Default: Off
Heading letter spacingSlider 0–4px
Default: 0px
Heading size (mobile)Slider 14–64px
Default: 28px
Heading colorColor

Caption

SettingTypeNotes
CaptionText
Default: 10% off your first order
Text styleChoice: Subtitle, Uppercase (letter spacing)
Default: Uppercase (letter spacing)
Font sizeSlider 12–40px
Default: 16px

Text

SettingTypeNotes
TextRich text

Email input

SettingTypeNotes
PlaceholderTextLeave blank for the theme default.
Button labelTextLeave blank for "Subscribe".
LayoutChoice: Field and button on one row, Stacked
Default: Field and button on one row
Full-width buttonOn/off
Default: Off
Consent noteRich text (one line)e.g. "By signing up you agree to receive marketing emails." and a link to your privacy policy.
"No thanks" linkTextCloses the popup. Leave blank to hide.
After signing up
Success messageTextLeave blank for the theme default.
Discount code to revealTextShown with a copy button after a successful signup. Create the code in Discounts.
Error messageTextLeave blank for the theme default.
Sale popup
SettingTypeNotes
Enable popupOn/off
Default: On
Turn the popup off without deleting it. It still previews here in the editor.
Delay before showingSlider 0–30s
Default: 3s
Days before showing againSlider 0–30d
Default: 7d
Schedule
The popup only shows between these times. Leave the end blank to end it when the timer block's countdown reaches zero. With neither set, it shows until you turn it off.
StartTextYYYY-MM-DD HH:MM, e.g. 2026-11-27 09:00. Blank = now.
EndTextYYYY-MM-DD HH:MM, e.g. 2026-11-30 23:59.
Timezone offsetText
Default: +00:00
e.g. +05:30 for India, -05:00 for New York.
When to show
Open afterChoice: A delay (seconds above), Scrolling part of the page, Exit intent (desktop), Visiting a number of pages
Default: A delay (seconds above)
Exit intent falls back to the delay on touch devices.
Scroll depthSlider 10–90%
Default: 40%
Pages visitedSlider 2–10
Default: 2
Show onChoice: All pages, Homepage only, All pages except cart
Default: All pages
DevicesChoice: Desktop and mobile, Desktop only, Mobile only
Default: Desktop and mobile
VisitorsChoice: Everyone, New visitors only, Returning visitors only
Default: Everyone
Based on this browser's first visit; a visit counts as returning after 30 minutes.
Desktop imageImage
Mobile imageImage
Image height (desktop · Top layout)Slider 120–600px
Default: 240px
Image height (mobile)Slider 120–500px
Default: 180px
Popup width (desktop)Slider 360–900px
Default: 720px
Spacing between blocksSlider 0–40px
Default: 16px
LayoutChoice: Image beside content, Image above content, Background
Default: Image beside content
Backdrop opacitySlider 0–90%
Default: 60%
Content alignmentChoice: Left, Center, Right
Default: Center
Corner radiusSlider 0–40px
Default: 12px
Mobile styleChoice: Centered, Bottom sheet
Default: Bottom sheet
Bottom sheet slides up from the bottom of the screen — easier to reach on mobile.
Colors
Background colorColor
Default: #ffffff
Text colorColor
Default: #1a1a1a
Screen-reader labelText
Default: Sale
Announced when the popup opens.
Close and animation
Close buttonChoice: Inside the popup, Solid circle, Screen corner
Default: Inside the popup
Backdrop blurSlider 0–12px
Default: 0px
Entrance animationChoice: Zoom in, Fade, Slide up
Default: Zoom in
Teaser tab
Show a teaser tab after the popup is closedOn/off
Default: Off
Re-opens the popup. Hidden automatically once the sale ends.
Teaser textText
Default: 20% OFF
Teaser positionChoice: Bottom left, Bottom right
Default: Bottom left
Teaser backgroundColor
Teaser text colorColor
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Blocks

Heading

SettingTypeNotes
HeadingRich text (one line)
Default: Get 20% off
Font sizeSlider 16–64px
Default: 32px
Heading weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase headingOn/off
Default: Off
Heading letter spacingSlider 0–4px
Default: 0px
Heading size (mobile)Slider 14–64px
Default: 28px
Heading colorColor

Caption

SettingTypeNotes
CaptionText
Default: Today only
Text styleChoice: Subtitle, Uppercase (letter spacing)
Default: Uppercase (letter spacing)
Font sizeSlider 12–40px
Default: 16px

Text

SettingTypeNotes
TextRich text

Countdown

SettingTypeNotes
Hide when expiredOn/off
Default: Off
End date (YYYY-MM-DD)TextYYYY-MM-DD. Required — with no date the timer is hidden (it never shows a fake countdown). Also ends the popup unless a schedule end is set.
End time (HH:MM:SS)Text
Default: 23:59:59
Timezone offsetText
Default: +00:00
SizeChoice: Small, Medium, Large
Default: Small

Copy discount code

SettingTypeNotes
CodeText
Default: SAVE20
Show the code with a copy buttonOn/off
Default: On
Copy button labelTextLeave blank for the theme default.
"Copied" labelTextLeave blank for the theme default.
Show "Apply and shop" buttonOn/off
Default: Off
Applies the code to the cart automatically, then opens the page below.
Apply button labelText
Default: Apply & shop
Go to after applyingLinkDefaults to all products.

Collections

SettingTypeNotes
HeadingTexte.g. "Shop the sale".
CollectionsCollections
Image shapeChoice: Square, Round
Default: Square

Products

SettingTypeNotes
ProductsProducts
LayoutChoice: Product cards, Compact list
Default: Product cards
ColumnsSlider 2–4
Default: 3

Button

SettingTypeNotes
LabelText
Default: Shop now
LinkLinkLeave blank to make the button close the popup.
StyleChoice: Solid, Outline
Default: Solid
Full widthOn/off
Default: Off
Close the popup when clickedOn/off
Default: Off

Content sections

Alternating rows
SettingTypeNotes
Color schemeColor scheme
HeadingRich text (one line)
Heading sizeSlider 15–80px
Default: 36px
Heading alignmentChoice: Left, Center, Right
Default: Center
Heading alignment (mobile)Choice: Same as desktop, Left, Center, Right
Default: Same as desktop
Alternate image sidesOn/off
Default: On
Image ratio (w/h)Slider 0.6–1.6
Default: 1.2
Image column widthSlider 30–70%
Default: 50%
Desktop only. 50 = equal columns.
Row vertical alignmentChoice: Top, Middle, Bottom
Default: Middle
How the text lines up against the image (desktop).
Image position (mobile)Choice: Above text, Below text
Default: Above text
Text alignmentChoice: Left, Center, Right
Default: Left
Text alignment (mobile)Choice: Same as desktop, Left, Center, Right
Default: Same as desktop
BackgroundColor
Padding
TopSlider 0–120px
Default: 48px
BottomSlider 0–120px
Default: 48px
Padding top (mobile)Slider 0–120px
Default: 48px
Padding bottom (mobile)Slider 0–120px
Default: 48px
Design
Heading colorColor
Heading weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase headingOn/off
Default: Off
Heading letter spacingSlider 0–4px
Default: 0px
Heading size (mobile)Slider 14–60px
Default: 28px
Body text colorColor
Hide on mobileOn/off
Default: Off
Hide on desktopOn/off
Default: Off
Section divider
Top dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Bottom dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Divider colorColorUsually the color of the adjacent section/background.
Divider heightSlider 8–160px
Default: 40px
Divider height (mobile)Slider 8–160px
Default: 24px
Width
Section widthChoice: Standard, Wide, Full width
Default: Standard
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Also accepts: theme blocks, app blocks.

Blocks

Row

SettingTypeNotes
ImageImage
CaptionText
HeadingText
Default: Row heading
Heading sizeSlider 0–60px
Default: 0px
0 = theme default.
Heading size (mobile)Slider 0–48px
Default: 0px
0 = same as desktop.
TextRich text
Body text sizeSlider 0–32px
Default: 0px
0 = theme default.
Body text size (mobile)Slider 0–28px
Default: 0px
0 = same as desktop.
Collapsible headingText
Collapsible contentRich text
Button labelText
Button linkLink
Link styleChoice: Solid button, Outline button, Text link
Default: Outline button
Apps
SettingTypeNotes
Add app blocks from any installed app. Each app controls its own content.
Match the theme's page widthOn/off
Default: On
WidthChoice: Standard, Wide
Default: Standard
Color schemeColor scheme
Spacing
Top paddingSlider 0–120px
Default: 36px
Bottom paddingSlider 0–120px
Default: 36px
Top padding (mobile)Slider 0–120px
Default: 28px
Bottom padding (mobile)Slider 0–120px
Default: 28px
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Also accepts: app blocks.

Before/after slider
SettingTypeNotes
Color schemeColor scheme
HeadingRich text (one line)
Default: Before & after
Heading sizeSlider 15–80px
Default: 36px
Heading alignmentChoice: Left, Center, Right
Default: Center
Heading alignment (mobile)Choice: Same as desktop, Left, Center, Right
Default: Same as desktop
Before imageImage
After imageImage
Before labelText
Default: Before
After labelText
Default: After
Label styleChoice: Solid, Pill, Outline, Minimal (text only)
Default: Solid
Label positionChoice: Bottom, Top
Default: Bottom
Start positionSlider 0–100%
Default: 50%
Image ratioChoice: 21:9 (wide), 16:9 (landscape), 3:2, 4:3, 1:1 (square), 3:4 (portrait)
Default: 16:9 (landscape)
Image ratio (mobile)Choice: Same as desktop, 16:9 (landscape), 4:3, 1:1 (square), 3:4 (portrait)
Default: Same as desktop
Full widthOn/off
Default: Off
Slider positionChoice: Slider left, text right, Slider right, text left
Default: Slider left, text right
Applies when the section has content blocks (a text column is shown beside the slider).
Slider
Drag directionChoice: Horizontal (left / right), Vertical (up / down)
Default: Horizontal (left / right)
Handle styleChoice: Round knob, Bar, Line only
Default: Round knob
Handle sizeSlider 28–72px
Default: 44px
Divider thicknessSlider 1–8px
Default: 3px
Handle and divider colorColor
Default: #ffffff
Animate on scrollOn/off
Default: On
The divider sweeps once when the section scrolls into view (respects reduced-motion).
Hint textText
Default: Drag to compare
Small prompt over the image that fades on first interaction. Leave blank to hide.
Padding
Top paddingSlider 0–120px
Default: 48px
Bottom paddingSlider 0–120px
Default: 48px
Padding top (mobile)Slider 0–120px
Default: 48px
Padding bottom (mobile)Slider 0–120px
Default: 48px
Design
Heading colorColor
Heading weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase headingOn/off
Default: Off
Heading size (mobile)Slider 14–60px
Default: 28px
Body text colorColor
Hide on mobileOn/off
Default: Off
Hide on desktopOn/off
Default: Off
Section divider
Top dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Bottom dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Divider colorColorUsually the color of the adjacent section/background.
Divider heightSlider 8–160px
Default: 40px
Width
Section widthChoice: Standard, Wide, Full width
Default: Standard
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Also accepts: theme blocks, app blocks.

Blocks

Caption

SettingTypeNotes
CaptionText
Default: Before & after
StyleChoice: Subtitle, Uppercase
Default: Uppercase

Text

SettingTypeNotes
TextRich text

Button

SettingTypeNotes
Button labelText
Default: Shop now
Button linkLink
Button styleChoice: Primary, Secondary
Default: Primary
Blog posts
SettingTypeNotes
Color schemeColor scheme
HeadingRich text (one line)
Default: Blog posts
Heading sizeSlider 15–80px
Default: 36px
Heading alignmentChoice: Left, Center
Default: Center
BlogBlog
Posts to showSlider 2–6
Default: 3
Columns on desktopSlider 1–5
Default: 3
Columns on mobileChoice: 1 column, 2 columns
Default: 1 column
Show featured imageOn/off
Default: On
Show dateOn/off
Default: On
Show authorOn/off
Default: Off
Show excerptOn/off
Default: Off
Show 'View all'On/off
Default: On
Padding
TopSlider 0–120px
Default: 48px
BottomSlider 0–120px
Default: 48px
Padding top (mobile)Slider 0–120px
Default: 48px
Padding bottom (mobile)Slider 0–120px
Default: 48px
Design
Heading colorColor
Heading weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase headingOn/off
Default: Off
Heading letter spacingSlider 0–4px
Default: 0px
Heading size (mobile)Slider 14–60px
Default: 28px
Body text colorColor
Hide on mobileOn/off
Default: Off
Hide on desktopOn/off
Default: Off
Section divider
Top dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Bottom dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Divider colorColorUsually the color of the adjacent section/background.
Divider heightSlider 8–160px
Default: 40px
Divider height (mobile)Slider 8–160px
Default: 24px
Width
Section widthChoice: Standard, Wide, Full width
Default: Standard
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Also accepts: theme blocks, app blocks.

Collapsible content
SettingTypeNotes
Color schemeColor scheme
CaptionText
HeadingRich text (one line)
Default: Frequently asked questions
Reusable FAQ: entries of a metaobject type (fields question + answer) or a metafield. They render after any rows, so you can mix both.
Data sourceText
Default: faq_item
Type it: a metaobject type (all entries), "type: handle, handle" (chosen entries, in order), or a list metafield as namespace.key. No need for the connect button. Blank = off.
Field keysTextOnly if your definition uses other field keys: question=your_key, answer=your_key. Fields read: question, answer.
Heading sizeSlider 15–80px
Default: 32px
Heading alignmentChoice: Left, Center, Right
Default: Left
Heading alignment (mobile)Choice: Same as desktop, Left, Center, Right
Default: Same as desktop
Toggle iconChoice: Plus / minus, Chevron, Caret (triangle)
Default: Plus / minus
Answer text sizeSlider 0–24px
Default: 0px
0 = theme default.
Answer text size (mobile)Slider 0–22px
Default: 0px
0 = same as desktop.
Open first item by defaultOn/off
Default: On
Side image (optional)Image
Image position (desktop)Choice: Left, Right
Default: Left
Link labelText
LinkLink
BackgroundColor
Padding
TopSlider 0–120px
Default: 48px
BottomSlider 0–120px
Default: 48px
Padding top (mobile)Slider 0–120px
Default: 48px
Padding bottom (mobile)Slider 0–120px
Default: 48px
Design
Heading colorColor
Heading weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase headingOn/off
Default: Off
Heading letter spacingSlider 0–4px
Default: 0px
Heading size (mobile)Slider 14–60px
Default: 28px
Body text colorColor
Hide on mobileOn/off
Default: Off
Hide on desktopOn/off
Default: Off
Section divider
Top dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Bottom dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Divider colorColorUsually the color of the adjacent section/background.
Divider heightSlider 8–160px
Default: 40px
Divider height (mobile)Slider 8–160px
Default: 24px
Width
Section widthChoice: Standard, Wide, Full width
Default: Standard
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Also accepts: theme blocks, app blocks.

Blocks

Row

SettingTypeNotes
HeadingText
Default: Question
ContentRich text
PagePageOptional. Pulls the row content from a page instead.
Collection tiles
SettingTypeNotes
LayoutChoice: Grid (ratio tiles), Mosaic (fixed-height bento), Ribbon (shaped category row), Carousel (slider + arrows), Editorial (image + text), Overlay banners, Masonry (variable height), Split (2 large tiles)
Default: Grid (ratio tiles)
Color schemeColor scheme
HeadingRich text (one line)
Default: Collections
Heading sizeSlider 15–80px
Default: 36px
Heading alignmentChoice: Left, Center
Default: Left
Heading colorColor
Grid layout
Image ratioChoice: Portrait, Square, Landscape
Default: Square
Columns (desktop)Slider 2–6
Default: 4
Columns (mobile)Choice: 1, 2
Default: 2
Swipe on mobileOn/off
Default: Off
Show 'View all' buttonOn/off
Default: Off
Mosaic layout
Row height (desktop)Slider 120–400px
Default: 220px
Row height (mobile)Slider 80–300px
Default: 160px
GapSlider 0–32px
Default: 12px
Ribbon layout
Menu (optional source)MenuIf set, ribbon items come from this menu's links. Otherwise the tile blocks below are used.
Item alignmentChoice: Left, Center
Default: Center
Image shapeChoice: Circle, Rounded, Square
Default: Circle
Media backgroundChoice: None, Surface
Default: None
Items per row (desktop)Slider 3–10
Default: 6
Items per row (mobile)Slider 2–5
Default: 3
Item size (desktop)Slider 60–240px
Default: 140px
Item size (mobile)Slider 48–160px
Default: 96px
Carousel layout
Image ratioChoice: Portrait, Square, Landscape
Default: Square
Cards per view (desktop)Slider 2–6
Default: 4
Cards per view (mobile)Slider 1–3
Default: 2
Editorial layout
Image positionChoice: Left, Right, Alternate
Default: Alternate
Image widthSlider 30–70%
Default: 50%
Image ratioChoice: Natural (varies), Wide 16:9, Landscape 3:2, Landscape 4:3, Square 1:1, Portrait 3:4
Default: Landscape 3:2
Forces every image to the same shape so rows stay symmetrical.
Overlay layout
Banner heightSlider 200–700px
Default: 360px
Overlay darknessSlider 0–80%
Default: 35%
Text positionChoice: Left, Center, Right
Default: Center
Masonry layout
Columns (desktop)Slider 2–5
Default: 3
Columns (mobile)Slider 1–3
Default: 2
GapSlider 0–32px
Default: 12px
Image ratioChoice: Natural (true masonry), Landscape 4:3, Square 1:1, Portrait 3:4, Tall 2:3
Default: Natural (true masonry)
Natural keeps true masonry (varied heights). Pick a ratio to make every tile the same shape.
Split layout
Tile heightSlider 200–600px
Default: 340px
GapSlider 0–32px
Default: 16px
Tile border (mosaic and ribbon)
Corner radiusSlider 0–40px
Default: 8px
Border thicknessSlider 0–8px
Default: 0px
Design
Heading weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase headingOn/off
Default: Off
Heading letter spacingSlider 0–4px
Default: 0px
Heading size (mobile)Slider 14–60px
Default: 28px
Body text colorColor
Zoom image on hoverOn/off
Default: Off
Hide on mobileOn/off
Default: Off
Hide on desktopOn/off
Default: Off
Section padding
Padding topSlider 0–100px
Default: 48px
Padding bottomSlider 0–100px
Default: 48px
Padding top (mobile)Slider 0–120px
Default: 48px
Padding bottom (mobile)Slider 0–120px
Default: 48px
Section divider
Top dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Bottom dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Divider colorColorUsually the color of the adjacent section/background.
Divider heightSlider 8–160px
Default: 40px
Divider height (mobile)Slider 8–160px
Default: 24px
Width
Section widthChoice: Standard, Wide, Full width
Default: Standard
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Blocks

Collection tile

SettingTypeNotes
CollectionCollection
Image (overrides collection image)Image
Label (overrides collection title)Text
Description (editorial / overlay / split)Rich text
Button label (editorial / overlay / split)Text
Link (overrides collection URL)Link
Label size (mosaic)Slider 14–48px
Default: 22px
Desktop span (mosaic)Slider 1–4
Default: 1
Mobile span (mosaic)Choice: 1 column, 2 columns
Default: 1 column
Contact form
SettingTypeNotes
Color schemeColor scheme
HeadingRich text (one line)
Default: Contact us
Intro textRich text
Heading sizeSlider 15–80px
Default: 36px
Heading alignmentChoice: Left, Center
Default: Center
Form widthSlider 400–1000px
Default: 640px
Applies to the single-column layout only.
Layout
LayoutChoice: Form only, Form + contact info
Default: Form only
Info panel positionChoice: Left of form, Right of form
Default: Right of form
Form fields
Show phone fieldOn/off
Default: On
Show subject fieldOn/off
Default: Off
Subject labelText
Default: Subject
Require message fieldOn/off
Default: On
Show consent checkboxOn/off
Default: Off
Consent textText
Default: I agree to be contacted regarding my enquiry.
Success messageText
Default: Thanks for reaching out. We will be in touch soon.
Contact info panel
Info headingText
Default: Get in touch
Info textRich text
Show social iconsOn/off
Default: On
Map displayChoice: None, Static image, Interactive embed
Default: Static image
Map / location imageImage
Map / location linkLink
Map embedText (multi-line)Paste the Google Maps "Embed a map" iframe code (or just its src URL).
Padding
TopSlider 0–120px
Default: 48px
BottomSlider 0–120px
Default: 48px
Padding top (mobile)Slider 0–120px
Default: 48px
Padding bottom (mobile)Slider 0–120px
Default: 48px
Design
Heading colorColor
Heading weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase headingOn/off
Default: Off
Heading letter spacingSlider 0–4px
Default: 0px
Heading size (mobile)Slider 14–60px
Default: 28px
Body text colorColor
Hide on mobileOn/off
Default: Off
Hide on desktopOn/off
Default: Off
Section divider
Top dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Bottom dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Divider colorColorUsually the color of the adjacent section/background.
Divider heightSlider 8–160px
Default: 40px
Width
Section widthChoice: Standard, Wide, Full width
Default: Standard
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Also accepts: theme blocks, app blocks.

Blocks

Info item

SettingTypeNotes
IconChoice: None, Emoji (custom), Location pin, Phone, Email, Clock, Chat
Default: Location pin
EmojiText
Default: 📍
Used when Icon is set to "Emoji".
LabelText
Default: Address
TextText
Default: 123 Market St, Suite 100
Link (optional)Link

Business hours

SettingTypeNotes
LabelText
Default: Opening hours
HoursRich text

Text / note

SettingTypeNotes
TextRich text
Custom Liquid
SettingTypeNotes
Color schemeColor scheme
Custom LiquidLiquidAdd app snippets or custom code.
Full widthOn/off
Default: Off
Padding
TopSlider 0–120px
Default: 24px
BottomSlider 0–120px
Default: 24px
Padding top (mobile)Slider 0–120px
Default: 24px
Padding bottom (mobile)Slider 0–120px
Default: 24px
Section divider
Top dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Bottom dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Divider colorColorUsually the color of the adjacent section/background.
Divider heightSlider 8–160px
Default: 40px
Divider height (mobile)Slider 8–160px
Default: 24px
Width
Section widthChoice: Standard, Wide, Full width
Default: Standard
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).
Custom section
SettingTypeNotes
Add Group blocks to make columns, then fill them with any block.
BlocksChoice: Stacked, Side by side
Default: Stacked
Gap between blocksSlider 0–80px
Default: 24px
Color schemeColor scheme
Background imageImage
Background overlaySlider 0–90%
Default: 30%
WidthChoice: Standard, Wide, Full width
Default: Standard
Spacing
Top paddingSlider 0–160px
Default: 64px
Bottom paddingSlider 0–160px
Default: 64px
Top padding (mobile)Slider 0–120px
Default: 40px
Bottom padding (mobile)Slider 0–120px
Default: 40px
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Also accepts: theme blocks, app blocks.

Discount ribbon
SettingTypeNotes
Color schemeColor scheme
HeadingRich text (one line)
Heading sizeSlider 15–70px
Default: 30px
Heading size (mobile)Slider 14–50px
Default: 24px
Heading weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Intro textRich text
Heading alignmentChoice: Left, Center, Right
Default: Center
Heading alignment (mobile)Choice: Same as desktop, Left, Center, Right
Default: Same as desktop
Layout
Columns on desktopSlider 1–5
Default: 3
Columns on mobileChoice: 1 column, 2 columns
Default: 1 column
Gap between tilesSlider 0–40px
Default: 16px
Image ratioChoice: Adapt to image, Wide (2.2:1), Landscape (3:2), Square (1:1), Portrait (3:4)
Default: Landscape (3:2)
Corner radiusSlider 0–40px
Default: 12px
Zoom image on hoverOn/off
Default: On
Padding
TopSlider 0–100px
Default: 24px
BottomSlider 0–100px
Default: 24px
Padding top (mobile)Slider 0–120px
Default: 24px
Padding bottom (mobile)Slider 0–120px
Default: 24px
Design
Heading colorColor
Hide on mobileOn/off
Default: Off
Hide on desktopOn/off
Default: Off
Section divider
Top dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Bottom dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Divider colorColorUsually the color of the adjacent section/background.
Divider heightSlider 8–160px
Default: 40px
Divider height (mobile)Slider 8–160px
Default: 24px
Width
Section widthChoice: Standard, Wide, Full width
Default: Standard
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Also accepts: theme blocks, app blocks.

Blocks

Promo image

SettingTypeNotes
ImageImage
LinkLink
Overlay content
HeadingText
TextText
Discount codeTextShows a click-to-copy code chip.
Button labelText
Button linkLink
Button styleChoice: Primary, Secondary
Default: Primary
Overlay style
Text colorColor
Default: #ffffff
Image dimSlider 0–90%
Default: 30%
Content positionChoice: Top, Middle, Bottom
Default: Middle
Content alignmentChoice: Left, Center, Right
Default: Center
Feature columns
SettingTypeNotes
Color schemeColor scheme
HeadingRich text (one line)
Heading sizeSlider 15–80px
Default: 32px
Heading alignmentChoice: Left, Center, Right
Default: Center
Heading alignment (mobile)Choice: Same as desktop, Left, Center, Right
Default: Same as desktop
Columns (desktop)Slider 1–5
Default: 3
Text alignmentChoice: Left, Center, Right
Default: Center
Text alignment (mobile)Choice: Same as desktop, Left, Center, Right
Default: Same as desktop
Icon sizeSlider 24–96px
Default: 48px
Icon size (mobile)Slider 0–96px
Default: 0px
0 = same as desktop.
Column card
Show columns as cardsOn/off
Default: Off
Card backgroundColor
Default: #ffffff
Card borderOn/off
Default: Off
Card corner radiusSlider 0–40px
Default: 12px
Card paddingSlider 8–48px
Default: 24px
Icon badge
Show a shape behind the iconOn/off
Default: Off
Badge shapeChoice: Circle, Rounded, Square
Default: Circle
Badge colorColor
Default: #f3f3f3
Columns on mobileChoice: 1 column, 2 columns
Default: 1 column
Enable swipe on mobileOn/off
Default: Off
BackgroundColor
Button labelText
Button linkLink
Design
Heading colorColor
Heading weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase headingOn/off
Default: Off
Heading size (mobile)Slider 14–60px
Default: 24px
Body text colorColor
Hide on mobileOn/off
Default: Off
Hide on desktopOn/off
Default: Off
Padding
TopSlider 0–120px
Default: 48px
BottomSlider 0–120px
Default: 48px
Padding top (mobile)Slider 0–120px
Default: 48px
Padding bottom (mobile)Slider 0–120px
Default: 48px
Section divider
Top dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Bottom dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Divider colorColorUsually the color of the adjacent section/background.
Divider heightSlider 8–160px
Default: 40px
Width
Section widthChoice: Standard, Wide, Full width
Default: Standard
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Also accepts: theme blocks, app blocks.

Blocks

Column

SettingTypeNotes
Icon imageImage
Or paste SVG iconHTMLUsed if no image is set.
HeadingText
Default: Free delivery
Heading sizeSlider 0–48px
Default: 0px
0 = theme default.
Heading size (mobile)Slider 0–40px
Default: 0px
0 = same as desktop.
TextRich text
Body text sizeSlider 0–28px
Default: 0px
0 = theme default.
Body text size (mobile)Slider 0–24px
Default: 0px
0 = same as desktop.
Link labelText
LinkLink
Featured collection
SettingTypeNotes
Color schemeColor scheme
CollectionCollection
Products to showSlider 2–12
Default: 4
Columns on desktopSlider 2–5
Default: 4
Columns on mobileChoice: 1, 2
Default: 2
Heading
HeadingRich text (one line)
Default: Featured products
Heading sizeSlider 15–80px
Default: 40px
Heading alignmentChoice: Left, Center, Right
Default: Center
Heading alignment (mobile)Choice: Same as desktop, Left, Center, Right
Default: Same as desktop
Heading colorColorLeave blank to use the color scheme. Auto-switches to white when a background image is set.
Background (banner mode)
Background imageImageOptional. When set, the section becomes a banner with the products over the image.
Image overlay opacitySlider 0–90%
Default: 40%
Full widthOn/off
Default: Off
Product cards
Show vendorOn/off
Default: Off
Enable quick add to cartOn/off
Default: On
Quick add button styleChoice: Outline, Solid
Default: Solid
Show 'View all' buttonOn/off
Default: On
'View all' button labelText
Default: View all
Design
Heading weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase headingOn/off
Default: Off
Heading letter spacingSlider 0–4px
Default: 0px
Heading size (mobile)Slider 14–60px
Default: 28px
Body text colorColor
Hide on mobileOn/off
Default: Off
Hide on desktopOn/off
Default: Off
Section padding
Padding topSlider 0–120px
Default: 56px
Padding bottomSlider 0–120px
Default: 56px
Padding top (mobile)Slider 0–120px
Default: 56px
Padding bottom (mobile)Slider 0–120px
Default: 56px
Section divider
Top dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Bottom dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Divider colorColorUsually the color of the adjacent section/background.
Divider heightSlider 8–160px
Default: 40px
Divider height (mobile)Slider 8–160px
Default: 24px
Width
Section widthChoice: Standard, Wide, Full width
Default: Standard
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Also accepts: theme blocks, app blocks.

Featured product
SettingTypeNotes
Color schemeColor scheme
ProductProduct
Media positionChoice: Left, Right
Default: Left
Prioritize image loadingOn/off
Default: Off
Turn on when this section is near the top of the page (improves LCP).
Padding
Top paddingSlider 0–120px
Default: 48px
Bottom paddingSlider 0–120px
Default: 48px
Padding top (mobile)Slider 0–120px
Default: 48px
Padding bottom (mobile)Slider 0–120px
Default: 48px
Design
Hide on mobileOn/off
Default: Off
Hide on desktopOn/off
Default: Off
Section divider
Top dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Bottom dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Divider colorColorUsually the color of the adjacent section/background.
Divider heightSlider 8–160px
Default: 40px
Divider height (mobile)Slider 8–160px
Default: 24px
Width
Section widthChoice: Standard, Wide, Full width
Default: Standard
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Also accepts: app blocks.

Blocks

Title

SettingTypeNotes
Font sizeSlider 20–64px
Default: 32px

Vendor

No settings.

Price

No settings.

Rating

No settings.

Variant picker

SettingTypeNotes
Picker styleChoice: Color swatches, Image swatches, Buttons (pills), Dropdown
Default: Color swatches
Swatch sizeSlider 30–80px
Default: 44px

Quantity selector

No settings.

Buy buttons

SettingTypeNotes
Show dynamic checkout buttonsOn/off
Default: On

Description

No settings.

Text

SettingTypeNotes
TextRich text (one line)
Default: Text block

Custom Liquid

SettingTypeNotes
Custom LiquidLiquid
Image banner
SettingTypeNotes
Color schemeColor scheme
ImageImage
Mobile imageImageOptional. Shown on small screens instead of the main image.
Desktop heightSlider 200–800px
Default: 480px
Mobile heightSlider 200–600px
Default: 360px
Image overlay opacitySlider 0–90%
Default: 20%
Full widthOn/off
Default: On
Content
HeadingText
Default: Welcome
Heading HTML tagChoice: H1, H2, H3
Default: H1
Use H1 for a page's main hero. If the page has another H1 (or two banners), set this to H2/H3 for SEO and accessibility.
Heading sizeSlider 0–100px
Default: 0px
0 = theme default.
Heading size (mobile)Slider 0–72px
Default: 0px
0 = same as desktop.
SubheadingText
Default: Shop the new collection
Subheading sizeSlider 0–48px
Default: 0px
0 = theme default.
Subheading size (mobile)Slider 0–40px
Default: 0px
0 = same as desktop.
Text colorColor
Default: #ffffff
Text box
Show a panel behind the textOn/off
Default: Off
Improves legibility over busy images, especially with left/right alignment.
Panel colorColor
Default: #000000
Panel opacitySlider 0–100%
Default: 60%
Content positionChoice: Left, Center, Right
Default: Center
Text alignmentChoice: Left, Center, Right
Default: Center
Text alignment (mobile)Choice: Same as desktop, Left, Center, Right
Default: Same as desktop
Content vertical positionChoice: Top, Middle, Bottom
Default: Middle
Content widthSlider 0–900px
Default: 0px
Maximum width of the text block. Set to 0 for the default.
Buttons
First button labelText
Default: Shop now
First button linkLink
First button styleChoice: Solid, Outline
Default: Solid
Second button labelText
Second button linkLink
Second button styleChoice: Solid, Outline
Default: Outline
Design
Hide on mobileOn/off
Default: Off
Hide on desktopOn/off
Default: Off
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Also accepts: theme blocks, app blocks.

Image with text
SettingTypeNotes
Color schemeColor scheme
ImageImage
Second imageImageOptional. Overlaps the first image at the bottom corner.
Image positionChoice: Left, Right
Default: Left
Image ratio (w/h)Slider 0.6–1.6
Default: 1
Vertical alignmentChoice: Top, Middle, Bottom
Default: Middle
Text alignmentChoice: Left, Center
Default: Left
BackgroundColor
Text box
Show a panel behind the textOn/off
Default: Off
Improves legibility, especially over a colored section background.
Panel colorColor
Default: #000000
Panel opacitySlider 0–100%
Default: 60%
Padding
TopSlider 0–120px
Default: 48px
BottomSlider 0–120px
Default: 48px
Padding top (mobile)Slider 0–120px
Default: 48px
Padding bottom (mobile)Slider 0–120px
Default: 48px
Design
Hide on mobileOn/off
Default: Off
Hide on desktopOn/off
Default: Off
Section divider
Top dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Bottom dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Divider colorColorUsually the color of the adjacent section/background.
Divider heightSlider 8–160px
Default: 40px
Divider height (mobile)Slider 8–160px
Default: 24px
Width
Section widthChoice: Standard, Wide, Full width
Default: Standard
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Also accepts: theme blocks, app blocks.

Blocks

Caption

SettingTypeNotes
CaptionText
Default: Our story
Text styleChoice: Subtitle, Uppercase (letter spacing)
Default: Uppercase (letter spacing)

Collapsible tab

SettingTypeNotes
HeadingText
Default: Collapsible row
ContentRich text

Heading

SettingTypeNotes
HeadingRich text (one line)
Default: Image with text
Font sizeSlider 18–72px
Default: 36px
Heading weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase headingOn/off
Default: Off
Heading letter spacingSlider 0–4px
Default: 0px
Heading size (mobile)Slider 14–80px
Default: 36px
Heading colorColor

Text

SettingTypeNotes
TextRich text
Body text sizeSlider 0–32px
Default: 0px
0 = theme default.
Body text size (mobile)Slider 0–28px
Default: 0px
0 = same as desktop.

Button

SettingTypeNotes
LabelText
Default: Learn more
LinkLink
StyleChoice: Solid, Outline
Default: Solid
Logo list
SettingTypeNotes
Color schemeColor scheme
HeadingRich text (one line)
Default: As seen in
Heading sizeSlider 15–80px
Default: 28px
Heading alignmentChoice: Left, Center, Right
Default: Center
Heading alignment (mobile)Choice: Same as desktop, Left, Center, Right
Default: Same as desktop
Intro textRich text
Layout
LayoutChoice: Grid, Carousel (auto-scroll)
Default: Grid
Scroll durationSlider 10–90s
Default: 30s
Lower is faster.
Card styleChoice: None, Bordered, Filled
Default: None
Uniform logo heightSlider 0–120px
Default: 0px
0 = use each logo's own size.
Columns on desktopSlider 2–8
Default: 5
Columns on mobileChoice: 2 columns, 3 columns
Default: 2 columns
Grayscale logosOn/off
Default: On
Logo opacity (idle)Slider 40–100%
Default: 70%
Logos fade to full opacity on hover.
Enable swipe on mobileOn/off
Default: Off
Background colorColor
Padding
Top paddingSlider 0–100px
Default: 40px
Bottom paddingSlider 0–100px
Default: 40px
Padding top (mobile)Slider 0–120px
Default: 40px
Padding bottom (mobile)Slider 0–120px
Default: 40px
Design
Heading colorColor
Heading weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase headingOn/off
Default: Off
Heading letter spacingSlider 0–4px
Default: 0px
Heading size (mobile)Slider 14–60px
Default: 28px
Body text colorColor
Hide on mobileOn/off
Default: Off
Hide on desktopOn/off
Default: Off
Section divider
Top dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Bottom dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Divider colorColorUsually the color of the adjacent section/background.
Divider heightSlider 8–160px
Default: 40px
Width
Section widthChoice: Standard, Wide, Full width
Default: Standard
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Also accepts: theme blocks, app blocks.

Blocks

Logo

SettingTypeNotes
Logo imageImage
Max widthSlider 40–240px
Default: 120px
LinkLink
Open link in new tabOn/off
Default: Off
Label (optional)TextShown under the logo; also used as the link's accessible name.
Lookbook
SettingTypeNotes
Color schemeColor scheme
HeadingText
Default: Shop the look
Intro textRich text
Heading sizeSlider 15–80px
Default: 36px
Heading alignmentChoice: Left, Center, Right
Default: Center
Heading alignment (mobile)Choice: Same as desktop, Left, Center, Right
Default: Same as desktop
Data sourceText
Default: story
Type it: a metaobject type (all entries), "type: handle, handle" (chosen entries, in order), or a list metafield as namespace.key. No need for the connect button. Blank = off.
Field keysTextOnly if your definition uses other field keys: image=your_key, heading=your_key. Fields read: image, heading, body, products.
Row layout
Image ratioChoice: Natural, Square (1:1), Portrait (3:4), Landscape (4:3), Wide (16:9)
Default: Natural
Image : text widthChoice: 50 / 50, Image major (60 / 40), Text major (40 / 60)
Default: 50 / 50
First image sideChoice: Left, Right
Default: Left
Vertical alignmentChoice: Center, Top
Default: Center
Row gapSlider 16–96px
Default: 48px
Story text
Story text alignmentChoice: Left, Center, Right
Default: Left
Story text alignment (mobile)Choice: Same as desktop, Left, Center, Right
Default: Same as desktop
Story heading sizeSlider 16–48px
Default: 24px
Body text sizeSlider 0–24px
Default: 0px
0 = theme default.
Max text widthSlider 0–700px
Default: 0px
0 = no limit.
Show text on a panelOn/off
Default: Off
Shop this look
Products labelText
Default: Shop this look
Products layoutChoice: Grid, Carousel on mobile
Default: Grid
Zoom image on hoverOn/off
Default: Off
Spacing
Top paddingSlider 0–120px
Default: 40px
Bottom paddingSlider 0–120px
Default: 40px
Top padding (mobile)Slider 0–120px
Default: 32px
Bottom padding (mobile)Slider 0–120px
Default: 32px
Design
Heading weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase headingOn/off
Default: Off
Heading letter spacingSlider 0–4px
Default: 0px
Heading size (mobile)Slider 14–60px
Default: 26px
Heading colorColor
Body text colorColor
Hide on mobileOn/off
Default: Off
Hide on desktopOn/off
Default: Off
Section divider
Top dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Bottom dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Divider colorColorUsually the color of the adjacent section/background.
Divider heightSlider 8–160px
Default: 40px
Width
Section widthChoice: Standard, Wide, Full width
Default: Standard
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Also accepts: theme blocks, app blocks.

Mosaic grid
SettingTypeNotes
Color schemeColor scheme
HeadingRich text (one line)
Default: Multimedia collage
Heading sizeSlider 15–80px
Default: 36px
Heading alignmentChoice: Left, Center, Right
Default: Center
Heading alignment (mobile)Choice: Same as desktop, Left, Center, Right
Default: Same as desktop
Large tile position (desktop)Choice: Left, Right
Default: Left
Mobile layoutChoice: Collage, Column
Default: Column
Tile styleChoice: None, Boxed
Default: Boxed
Padding
Top paddingSlider 0–100px
Default: 36px
Bottom paddingSlider 0–100px
Default: 36px
Padding top (mobile)Slider 0–120px
Default: 36px
Padding bottom (mobile)Slider 0–120px
Default: 36px
Design
Heading colorColor
Heading weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase headingOn/off
Default: Off
Heading letter spacingSlider 0–4px
Default: 0px
Heading size (mobile)Slider 14–60px
Default: 28px
Body text colorColor
Hide on mobileOn/off
Default: Off
Hide on desktopOn/off
Default: Off
Section divider
Top dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Bottom dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Divider colorColorUsually the color of the adjacent section/background.
Divider heightSlider 8–160px
Default: 40px
Divider height (mobile)Slider 8–160px
Default: 24px
Width
Section widthChoice: Standard, Wide, Full width
Default: Standard
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Also accepts: theme blocks, app blocks.

Blocks

Image

SettingTypeNotes
ImageImage
LinkLinkWhere the image click goes (collection, product, page, or any URL).

Product

SettingTypeNotes
ProductProduct

Collection

SettingTypeNotes
CollectionCollection

Video

SettingTypeNotes
Cover imageImage
Video URLVideo link
Default: https://www.youtube.com/watch?v=UELVSZC06BE
Video alt textText
Default: Describe the video
Newsletter
SettingTypeNotes
Color schemeColor scheme
Content widthSlider 400–900px
Default: 600px
Content alignmentChoice: Left, Center, Right
Default: Center
Content alignment (mobile)Choice: Same as desktop, Left, Center, Right
Default: Same as desktop
BackgroundColor
Padding
TopSlider 0–120px
Default: 56px
BottomSlider 0–120px
Default: 56px
Padding top (mobile)Slider 0–120px
Default: 56px
Padding bottom (mobile)Slider 0–120px
Default: 56px
Design
Hide on mobileOn/off
Default: Off
Hide on desktopOn/off
Default: Off
Section divider
Top dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Bottom dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Divider colorColorUsually the color of the adjacent section/background.
Divider heightSlider 8–160px
Default: 40px
Divider height (mobile)Slider 8–160px
Default: 24px
Width
Section widthChoice: Standard, Wide, Full width
Default: Standard
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Also accepts: theme blocks, app blocks.

Blocks

Heading

SettingTypeNotes
HeadingRich text (one line)
Default: Subscribe to our newsletter
Font sizeSlider 18–64px
Default: 32px
Heading weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase headingOn/off
Default: Off
Heading letter spacingSlider 0–4px
Default: 0px
Heading size (mobile)Slider 14–80px
Default: 32px
Heading colorColor

Text

SettingTypeNotes
TextRich text
Text sizeSlider 0–28px
Default: 0px
0 = theme default.
Text size (mobile)Slider 0–24px
Default: 0px
0 = same as desktop.

Email form

SettingTypeNotes
Show consent checkboxOn/off
Default: Off
Consent textText
Default: I agree to receive marketing emails.
Require consent to subscribeOn/off
Default: On
Page
SettingTypeNotes
Color schemeColor scheme
PagePage
Heading sizeSlider 15–80px
Default: 36px
Content alignmentChoice: Left, Center
Default: Left
Padding
Top paddingSlider 0–120px
Default: 48px
Bottom paddingSlider 0–120px
Default: 48px
Padding top (mobile)Slider 0–120px
Default: 48px
Padding bottom (mobile)Slider 0–120px
Default: 48px
Section divider
Top dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Bottom dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Divider colorColorUsually the color of the adjacent section/background.
Divider heightSlider 8–160px
Default: 40px
Divider height (mobile)Slider 8–160px
Default: 24px
Width
Section widthChoice: Standard, Wide, Full width
Default: Standard
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).
Product hotspots
SettingTypeNotes
Color schemeColor scheme
HeadingRich text (one line)
Default: Shop the look
Heading sizeSlider 15–80px
Default: 36px
Heading alignmentChoice: Left, Center, Right
Default: Center
Heading alignment (mobile)Choice: Same as desktop, Left, Center, Right
Default: Same as desktop
ImageImage
Mobile imageImageOptional. Shown on small screens instead of the main image.
Image heightSlider 300–900px
Default: 600px
Corner radiusSlider 0–40px
Default: 8px
Full widthOn/off
Default: Off
Enable quick addOn/off
Default: On
Quick add styleChoice: Outline, Solid
Default: Solid
Padding
TopSlider 0–100px
Default: 48px
BottomSlider 0–100px
Default: 48px
Padding top (mobile)Slider 0–120px
Default: 48px
Padding bottom (mobile)Slider 0–120px
Default: 48px
Design
Heading colorColor
Heading weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase headingOn/off
Default: Off
Heading letter spacingSlider 0–4px
Default: 0px
Heading size (mobile)Slider 14–60px
Default: 28px
Body text colorColor
Hide on mobileOn/off
Default: Off
Hide on desktopOn/off
Default: Off
Section divider
Top dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Bottom dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Divider colorColorUsually the color of the adjacent section/background.
Divider heightSlider 8–160px
Default: 40px
Divider height (mobile)Slider 8–160px
Default: 24px
Width
Section widthChoice: Standard, Wide, Full width
Default: Standard
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Also accepts: theme blocks, app blocks.

Blocks

Hotspot

SettingTypeNotes
ProductProduct
Text (optional)Rich text
Card widthSlider 160–320px
Default: 220px
Desktop position
HorizontalSlider 0–100%
Default: 50%
VerticalSlider 0–100%
Default: 50%
Mobile position
HorizontalSlider 0–100%
Default: 50%
VerticalSlider 0–100%
Default: 50%
Promotion banner
SettingTypeNotes
Color schemeColor scheme
Data source (first active shows)Text
Default: promotion
Type it: a metaobject type (all entries), "type: handle, handle" (chosen entries, in order), or a list metafield as namespace.key. No need for the connect button. Blank = off.
Field keysTextOnly if your definition uses other field keys: message=your_key, link=your_key. Fields read: message, link, link_label, image, start_date, end_date.
Layout
Display styleChoice: Text strip, Background image, Side-by-side
Default: Text strip
Content alignmentChoice: Left, Center, Right
Default: Center
Content alignment (mobile)Choice: Same as desktop, Left, Center, Right
Default: Same as desktop
Max content widthSlider 0–900px
Default: 0px
0 = full width.
Min heightSlider 120–640px
Default: 300px
Background image style only.
Countdown
Show countdown to end dateOn/off
Default: Off
Uses the promotion's end date. Hidden if the promo has no end date.
Countdown labelText
Default: Ends in
Message and button
Message sizeSlider 13–60px
Default: 18px
Message size (mobile)Slider 12–40px
Default: 16px
Message weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase messageOn/off
Default: Off
Message letter spacingSlider 0–4px
Default: 0px
Button styleChoice: Primary, Secondary, Text link
Default: Primary
Overlay
Overlay colorColor
Default: #000000
Overlay opacitySlider 0–90%
Default: 35%
Text colorColorOverrides the color scheme over a background image.
Behavior
Let shoppers dismissOn/off
Default: Off
Adds a close button; the dismissal is remembered on the shopper's device.
Spacing
Top paddingSlider 0–120px
Default: 24px
Bottom paddingSlider 0–120px
Default: 24px
Top padding (mobile)Slider 0–120px
Default: 20px
Bottom padding (mobile)Slider 0–120px
Default: 20px
Design
Hide on mobileOn/off
Default: Off
Hide on desktopOn/off
Default: Off
Section divider
Top dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Bottom dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Divider colorColorUsually the color of the adjacent section/background.
Divider heightSlider 8–160px
Default: 40px
Width
Section widthChoice: Standard, Wide, Full width
Default: Standard
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).
Quick order list
SettingTypeNotes
Color schemeColor scheme
HeadingRich text (one line)
Default: Quick order
Heading sizeSlider 15–80px
Default: 32px
Heading alignmentChoice: Left, Center, Right
Default: Left
Heading alignment (mobile)Choice: Same as desktop, Left, Center, Right
Default: Same as desktop
ProductProduct
Columns
Show imageOn/off
Default: On
Show priceOn/off
Default: On
Show availabilityOn/off
Default: On
Show inventory countOn/off
Default: Off
Displays remaining stock next to "In stock" when tracked.
Show SKUOn/off
Default: Off
Show line totalOn/off
Default: On
Sticky totals barOn/off
Default: On
Keeps the total and Add to cart button visible while scrolling a long list.
Padding
Top paddingSlider 0–120px
Default: 48px
Bottom paddingSlider 0–120px
Default: 48px
Padding top (mobile)Slider 0–120px
Default: 48px
Padding bottom (mobile)Slider 0–120px
Default: 48px
Design
Heading colorColor
Heading weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase headingOn/off
Default: Off
Heading letter spacingSlider 0–4px
Default: 0px
Heading size (mobile)Slider 14–60px
Default: 28px
Body text colorColor
Hide on mobileOn/off
Default: Off
Hide on desktopOn/off
Default: Off
Section divider
Top dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Bottom dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Divider colorColorUsually the color of the adjacent section/background.
Divider heightSlider 8–160px
Default: 40px
Divider height (mobile)Slider 8–160px
Default: 24px
Width
Section widthChoice: Standard, Wide, Full width
Default: Standard
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).
Recently viewed
SettingTypeNotes
Color schemeColor scheme
HeadingRich text (one line)
Default: Recently viewed
Heading sizeSlider 15–80px
Default: 28px
Heading alignmentChoice: Left, Center, Right
Default: Left
Heading alignment (mobile)Choice: Same as desktop, Left, Center, Right
Default: Same as desktop
Image ratioChoice: Portrait, Square, Landscape
Default: Square
Image shapeChoice: Default, Arch, Blob, Round, Diamond, Parallelogram, Chevron left, Chevron right
Default: Default
Standard-styled cards have no borders when an image shape is active.
Show second image on hoverOn/off
Default: Off
Show vendorOn/off
Default: Off
Show ratingOn/off
Default: Off
Shows product stars when a reviews app provides a rating metafield.
Enable quick add to cartOn/off
Default: Off
Single-variant products add straight to cart; products with options link to the product page.
Quick add button styleChoice: Outline button, Solid button
Default: Outline button
LayoutChoice: Carousel, Grid
Default: Grid
Max productsSlider 2–20
Default: 8
Columns per view (desktop)Slider 2–6
Default: 5
Columns on mobileSlider 1–3
Default: 2
Enable swipe on mobileOn/off
Default: On
Carousel layout only. Off shows a stacked grid on mobile.
Padding
TopSlider 0–100px
Default: 48px
BottomSlider 0–100px
Default: 48px
Padding top (mobile)Slider 0–120px
Default: 48px
Padding bottom (mobile)Slider 0–120px
Default: 48px
Design
Heading colorColor
Heading weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase headingOn/off
Default: Off
Heading letter spacingSlider 0–4px
Default: 0px
Heading size (mobile)Slider 14–60px
Default: 28px
Body text colorColor
Hide on mobileOn/off
Default: Off
Hide on desktopOn/off
Default: Off
Section divider
Top dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Bottom dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Divider colorColorUsually the color of the adjacent section/background.
Divider heightSlider 8–160px
Default: 40px
Divider height (mobile)Slider 8–160px
Default: 24px
Width
Section widthChoice: Standard, Wide, Full width
Default: Standard
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).
Rich text
SettingTypeNotes
Color schemeColor scheme
AlignmentChoice: Left, Center, Right
Default: Center
Alignment (mobile)Choice: Same as desktop, Left, Center, Right
Default: Same as desktop
Content widthSlider 400–1200px
Default: 720px
BackgroundColor
Text colorColor
Full widthOn/off
Default: Off
Padding
TopSlider 0–160px
Default: 72px
BottomSlider 0–160px
Default: 72px
Padding top (mobile)Slider 0–120px
Default: 72px
Padding bottom (mobile)Slider 0–120px
Default: 72px
Design
Hide on mobileOn/off
Default: Off
Hide on desktopOn/off
Default: Off
Section divider
Top dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Bottom dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Divider colorColorUsually the color of the adjacent section/background.
Divider heightSlider 8–160px
Default: 40px
Divider height (mobile)Slider 8–160px
Default: 24px
Width
Section widthChoice: Standard, Wide, Full width
Default: Standard
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Also accepts: theme blocks, app blocks.

Blocks

Caption

SettingTypeNotes
CaptionText
Default: Master Theme

Heading

SettingTypeNotes
HeadingRich text (one line)
Default: Elegance
Font sizeSlider 20–100px
Default: 56px
Heading weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase headingOn/off
Default: Off
Heading letter spacingSlider 0–4px
Default: 0px
Heading size (mobile)Slider 14–80px
Default: 56px
Heading colorColor

Text

SettingTypeNotes
TextRich text
Body text sizeSlider 0–32px
Default: 0px
0 = theme default.
Body text size (mobile)Slider 0–28px
Default: 0px
0 = same as desktop.

Button

SettingTypeNotes
LabelText
Default: Button label
LinkLink
StyleChoice: Solid, Outline
Default: Outline
Sale timer
SettingTypeNotes
Color schemeColor scheme
Deadline
End date (YYYY-MM-DD)TextLeave blank for a rolling 24-hour timer.
End time (HH:MM:SS)Text
Default: 23:59:59
Timezone offsetText
Default: +00:00
e.g. +05:30, -08:00
Hide section after it expiresOn/off
Default: Off
Layout
LayoutChoice: Side by side, Stacked
Default: Side by side
Content alignmentChoice: Left, Center, Right
Default: Left
Content alignment (mobile)Choice: Same as desktop, Left, Center, Right
Default: Same as desktop
Timer sizeChoice: Small, Medium, Large
Default: Medium
Padding
TopSlider 0–100px
Default: 48px
BottomSlider 0–100px
Default: 48px
Padding top (mobile)Slider 0–120px
Default: 48px
Padding bottom (mobile)Slider 0–120px
Default: 48px
Design
Hide on mobileOn/off
Default: Off
Hide on desktopOn/off
Default: Off
Section divider
Top dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Bottom dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Divider colorColorUsually the color of the adjacent section/background.
Divider heightSlider 8–160px
Default: 40px
Divider height (mobile)Slider 8–160px
Default: 24px
Width
Section widthChoice: Standard, Wide, Full width
Default: Standard
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Also accepts: theme blocks, app blocks.

Blocks

Heading

SettingTypeNotes
HeadingRich text (one line)
Default: Sale ends soon
Font sizeSlider 16–64px
Default: 32px
Heading weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase headingOn/off
Default: Off
Heading letter spacingSlider 0–4px
Default: 0px
Heading size (mobile)Slider 14–80px
Default: 32px
Heading colorColor

Caption

SettingTypeNotes
CaptionText
Default: Limited time only
Text styleChoice: Subtitle, Uppercase (letter spacing)
Default: Uppercase (letter spacing)
Font sizeSlider 12–40px
Default: 16px

Text

SettingTypeNotes
TextRich text

Copy discount code

SettingTypeNotes
Discount codeText
Default: SAVE20

Button

SettingTypeNotes
LabelText
Default: Shop the sale
LinkLink
StyleChoice: Solid, Outline
Default: Solid
Shop by brand
SettingTypeNotes
Color schemeColor scheme
HeadingText
Default: Shop by brand
Intro textRich text
Heading sizeSlider 15–80px
Default: 36px
Heading alignmentChoice: Left, Center, Right
Default: Center
Heading alignment (mobile)Choice: Same as desktop, Left, Center, Right
Default: Same as desktop
Data sourceText
Default: brand
Type it: a metaobject type (all entries), "type: handle, handle" (chosen entries, in order), or a list metafield as namespace.key. No need for the connect button. Blank = off.
Field keysTextOnly if your definition uses other field keys: name=your_key, logo=your_key. Fields read: name, logo, description, url.
Layout
LayoutChoice: Grid (cards), Carousel (auto-scroll strip), Logo wall (borderless)
Default: Grid (cards)
Card styleChoice: Bordered, Plain, Filled
Default: Bordered
Applies to Grid and Logo wall layouts.
Columns (desktop)Slider 2–6
Default: 4
Columns (mobile)Slider 1–3
Default: 2
Scroll durationSlider 10–90s
Default: 30s
Lower is faster.
Logos
Logo heightSlider 32–140px
Default: 64px
Grayscale logos (color on hover)On/off
Default: Off
Show brand name under logoOn/off
Default: Off
Show brand descriptionOn/off
Default: Off
Button
Button labelTextLeave blank to hide.
Button linkLink
Spacing
Top paddingSlider 0–120px
Default: 40px
Bottom paddingSlider 0–120px
Default: 40px
Top padding (mobile)Slider 0–120px
Default: 32px
Bottom padding (mobile)Slider 0–120px
Default: 32px
Design
Heading colorColor
Heading weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase headingOn/off
Default: Off
Heading letter spacingSlider 0–4px
Default: 0px
Heading size (mobile)Slider 14–60px
Default: 26px
Body text colorColor
Hide on mobileOn/off
Default: Off
Hide on desktopOn/off
Default: Off
Section divider
Top dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Bottom dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Divider colorColorUsually the color of the adjacent section/background.
Divider heightSlider 8–160px
Default: 40px
Width
Section widthChoice: Standard, Wide, Full width
Default: Standard
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Also accepts: theme blocks, app blocks.

Slideshow
SettingTypeNotes
Color schemeColor scheme
HeightChoice: Medium, Large, Full screen
Default: Large
Mobile heightChoice: Medium, Large
Default: Large
Auto-rotate slidesOn/off
Default: On
Change everySlider 3–12s
Default: 6s
Carousel description (a11y)Text
Default: Slideshow about our store
Controls
TransitionChoice: Slide, Fade, Fade through black, Fade through white, Zoom, Zoom in, Zoom out, Slide up, Slide down, Wipe
Default: Slide
Show arrowsOn/off
Default: On
Arrow button colorColor
Active dot colorColor
Design
Hide on mobileOn/off
Default: Off
Hide on desktopOn/off
Default: Off
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Also accepts: theme blocks, app blocks.

Blocks

Slide

SettingTypeNotes
ImageImage
Mobile imageImageOptional. Shown on small screens.
CaptionText
HeadingRich text (one line)
Default: Slide heading
SubheadingRich text (one line)
Subheading sizeSlider 0–48px
Default: 0px
0 = theme default.
Subheading size (mobile)Slider 0–40px
Default: 0px
0 = same as desktop.
Heading sizeSlider 20–100px
Default: 52px
Heading weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase headingOn/off
Default: Off
Heading letter spacingSlider 0–4px
Default: 0px
Heading size (mobile)Slider 14–80px
Default: 52px
Heading colorColor
TextRich text
Body text sizeSlider 0–32px
Default: 0px
0 = theme default.
Body text size (mobile)Slider 0–28px
Default: 0px
0 = same as desktop.
Button labelText
Default: Shop now
Button linkLink
Button styleChoice: Solid, Outline
Default: Solid
Content positionChoice: Left, Center, Right
Default: Center
Content positionChoice: Top, Middle, Bottom
Default: Middle
Text colorColor
Default: #ffffff
Image overlaySlider 0–80%
Default: 20%
Text box
Show a panel behind the textOn/off
Default: Off
Improves legibility over busy images, especially with left/right alignment.
Panel colorColor
Default: #000000
Panel opacitySlider 0–100%
Default: 60%
Store locator
SettingTypeNotes
Color schemeColor scheme
HeadingText
Default: Find a store
Intro textRich text
Heading sizeSlider 15–80px
Default: 36px
Heading alignmentChoice: Left, Center, Right
Default: Center
Heading alignment (mobile)Choice: Same as desktop, Left, Center, Right
Default: Same as desktop
Data sourceText
Default: location
Type it: a metaobject type (all entries), "type: handle, handle" (chosen entries, in order), or a list metafield as namespace.key. No need for the connect button. Blank = off.
Field keysTextOnly if your definition uses other field keys: name=your_key, address=your_key. Fields read: name, address, hours, phone, email, directions_url, image, map_embed_url.
Cards
Columns (desktop)Slider 1–4
Default: 3
Card layoutChoice: Stacked (image top), Horizontal (image left)
Default: Stacked (image top)
Card styleChoice: Bordered, Plain, Filled
Default: Bordered
Show location imagesOn/off
Default: On
Image ratioChoice: Natural, Square (1:1), Landscape (4:3), Portrait (3:4)
Default: Natural
Show contact iconsOn/off
Default: On
Directions button labelText
Default: Get directions
Show map embed (per-location map_embed_url)On/off
Default: Off
Search
Enable search / filterOn/off
Default: On
Search placeholderText
Default: Search by city or postcode
Show result countOn/off
Default: On
Result count textText
Default: Showing [shown] of [total]
Use [shown] and [total] as placeholders.
No-results textText
Default: No locations match your search.
Spacing
Top paddingSlider 0–120px
Default: 40px
Bottom paddingSlider 0–120px
Default: 40px
Top padding (mobile)Slider 0–120px
Default: 32px
Bottom padding (mobile)Slider 0–120px
Default: 32px
Design
Heading weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase headingOn/off
Default: Off
Heading letter spacingSlider 0–4px
Default: 0px
Heading size (mobile)Slider 14–60px
Default: 26px
Heading colorColor
Body text colorColor
Hide on mobileOn/off
Default: Off
Hide on desktopOn/off
Default: Off
Section divider
Top dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Bottom dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Divider colorColorUsually the color of the adjacent section/background.
Divider heightSlider 8–160px
Default: 40px
Width
Section widthChoice: Standard, Wide, Full width
Default: Standard
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Also accepts: theme blocks, app blocks.

Testimonials
SettingTypeNotes
Color schemeColor scheme
Reusable testimonials: entries of a metaobject type (fields quote, author, caption, avatar, rating) or a metafield, set in Data source below. They render after any blocks, so you can mix both.
Data sourceText
Default: testimonial
Type it: a metaobject type (all entries), "type: handle, handle" (chosen entries, in order), or a list metafield as namespace.key. No need for the connect button. Blank = off.
Field keysTextOnly if your definition uses other field keys: quote=your_key, author=your_key. Fields read: quote, author, caption, avatar, rating.
HeadingRich text (one line)
Default: What customers say
Heading sizeSlider 15–80px
Default: 36px
Heading alignmentChoice: Left, Center, Right
Default: Center
Heading alignment (mobile)Choice: Same as desktop, Left, Center, Right
Default: Same as desktop
Columns (desktop)Slider 1–4
Default: 3
Columns (mobile)Choice: 1, 2
Default: 1
Card styleChoice: Bordered card, Plain
Default: Bordered card
Avatar positionChoice: Top, With name
Default: With name
Avatar size (top)Slider 40–120px
Default: 72px
Image shapeChoice: Circle, Rounded, Square
Default: Circle
Image corner radiusSlider 0–40px
Default: 8px
Image border thicknessSlider 0–8px
Default: 0px
Text alignmentChoice: Left, Center, Right
Default: Left
Text alignment (mobile)Choice: Same as desktop, Left, Center, Right
Default: Same as desktop
Swipe on mobileOn/off
Default: Off
Show testimonials as a horizontal swipe row on phones instead of a stacked grid.
Quote text sizeSlider 0–32px
Default: 0px
0 = theme default.
Quote text size (mobile)Slider 0–28px
Default: 0px
0 = same as desktop.
Padding
TopSlider 0–100px
Default: 48px
BottomSlider 0–100px
Default: 48px
Padding top (mobile)Slider 0–120px
Default: 48px
Padding bottom (mobile)Slider 0–120px
Default: 48px
Design
Heading colorColor
Heading weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase headingOn/off
Default: Off
Heading letter spacingSlider 0–4px
Default: 0px
Heading size (mobile)Slider 14–60px
Default: 28px
Body text colorColor
Hide on mobileOn/off
Default: Off
Hide on desktopOn/off
Default: Off
Section divider
Top dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Bottom dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Divider colorColorUsually the color of the adjacent section/background.
Divider heightSlider 8–160px
Default: 40px
Divider height (mobile)Slider 8–160px
Default: 24px
Width
Section widthChoice: Standard, Wide, Full width
Default: Standard
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Also accepts: theme blocks, app blocks.

Blocks

Review

SettingTypeNotes
AvatarImage
NameText
Default: Happy customer
CaptionText
Default: Verified buyer
StarsSlider 0–5
Default: 5
ReviewRich text
Trust badges
SettingTypeNotes
Color schemeColor scheme
HeadingText
Heading sizeSlider 15–60px
Default: 28px
Heading size (mobile)Slider 14–48px
Default: 24px
Heading weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
AlignmentChoice: Left, Center, Right
Default: Center
Alignment (mobile)Choice: Same as desktop, Left, Center, Right
Default: Same as desktop
Layout
Columns on desktopSlider 2–5
Default: 4
Columns on mobileChoice: 1 column, 2 columns
Default: 2 columns
Badge layoutChoice: Icon above text, Icon beside text
Default: Icon above text
Card styleChoice: None, Boxed
Default: None
Show dividers between badgesOn/off
Default: Off
Ignored when card style is Boxed.
Icon
Icon sizeSlider 20–72px
Default: 32px
Icon colorColor
Icon backgroundChoice: None, Circle, Rounded, Square
Default: None
Icon background colorColor
Default: #f3f3f3
Top paddingSlider 0–100px
Default: 24px
Bottom paddingSlider 0–100px
Default: 24px
Padding top (mobile)Slider 0–120px
Default: 24px
Padding bottom (mobile)Slider 0–120px
Default: 24px
Design
Heading colorColor
Body text colorColor
Hide on mobileOn/off
Default: Off
Hide on desktopOn/off
Default: Off
Section divider
Top dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Bottom dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Divider colorColorUsually the color of the adjacent section/background.
Divider heightSlider 8–160px
Default: 40px
Divider height (mobile)Slider 8–160px
Default: 24px
Width
Section widthChoice: Standard, Wide, Full width
Default: Standard

Also accepts: theme blocks, app blocks.

Blocks

Badge

SettingTypeNotes
Built-in iconChoice: Shield (secure), Truck (shipping), Refund / returns, Guarantee badge, Lock (privacy), Leaf (eco), Support, Gift
Default: Shield (secure)
Used when no icon image is set.
Icon image (optional)Image
TitleText
Default: Secure checkout
SubtitleText
Default: Encrypted & protected
Link (optional)LinkMakes the whole badge clickable — e.g. link to your shipping or returns policy.
Video
SettingTypeNotes
Color schemeColor scheme
HeadingRich text (one line)
Heading sizeSlider 15–80px
Default: 32px
Heading alignmentChoice: Left, Center, Right
Default: Center
Heading alignment (mobile)Choice: Same as desktop, Left, Center, Right
Default: Same as desktop
Video (hosted)Video
Or video URL (YouTube/Vimeo)Video link
Default: https://www.youtube.com/watch?v=UELVSZC06BE
Cover imageImageShown until played (better performance).
Prioritize cover image loadingOn/off
Default: Off
Turn on only when this video is near the top of the page (improves LCP).
Aspect ratioChoice: 21:9 (cinematic), 16:9 (widescreen), 3:2, 4:3, 1:1 (square), 4:5 (portrait)
Default: 16:9 (widescreen)
Aspect ratio (mobile)Choice: Same as desktop, 16:9 (widescreen), 4:3, 1:1 (square), 4:5 (portrait), 2:3 (tall)
Default: Same as desktop
LoopOn/off
Default: Off
Full widthOn/off
Default: Off
Overlay colorColor
Default: #000000
Overlay opacitySlider 0–90%
Default: 0%
Overlay content positionChoice: Top, Middle, Bottom
Default: Middle
Overlay text alignmentChoice: Left, Center, Right
Default: Center
Hide overlay text when the video playsOn/off
Default: Off
Padding
TopSlider 0–120px
Default: 48px
BottomSlider 0–120px
Default: 48px
Padding top (mobile)Slider 0–120px
Default: 48px
Padding bottom (mobile)Slider 0–120px
Default: 48px
Design
Heading colorColor
Heading weightChoice: Theme default, Regular, Medium, Semibold, Bold
Default: Theme default
Uppercase headingOn/off
Default: Off
Heading letter spacingSlider 0–4px
Default: 0px
Heading size (mobile)Slider 14–60px
Default: 28px
Body text colorColor
Hide on mobileOn/off
Default: Off
Hide on desktopOn/off
Default: Off
Section divider
Top dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Bottom dividerChoice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle
Default: None
Divider colorColorUsually the color of the adjacent section/background.
Divider heightSlider 8–160px
Default: 40px
Divider height (mobile)Slider 8–160px
Default: 24px
Width
Section widthChoice: Standard, Wide, Full width
Default: Standard
Custom CSSText (multi-line)Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }).

Also accepts: theme blocks, app blocks.

Blocks

Text

SettingTypeNotes
TextRich text (one line)
Default: Tell your story
Font sizeSlider 16–80px
Default: 40px

Button

SettingTypeNotes
Button labelText
Default: Shop now
Button linkLink
Button styleChoice: Solid, Outline
Default: Solid

Theme blocks

These blocks can be added to any section that accepts theme blocks.

Button
SettingTypeNotes
LabelText
Default: Shop now
LinkLink
Open in a new tabOn/off
Default: Off
StyleChoice: Filled, Outline, Text link
Default: Filled
AlignmentChoice: Left, Center, Right
Default: Left
Full widthOn/off
Default: Off
Spacing
Space aboveSlider 0–80px
Default: 0px
Space belowSlider 0–80px
Default: 0px
Countdown
SettingTypeNotes
Counts down to a real date and disappears when it ends. Leave the date empty to hide it.
LabelText
Default: Offer ends in
End dateTextYYYY-MM-DD, e.g. 2026-12-31
End timeText
Default: 23:59:59
Time zone offsetText
Default: +00:00
e.g. +05:30 for India, -05:00 for New York.
SizeChoice: Small, Medium, Large
Default: Medium
AlignmentChoice: Left, Center, Right
Default: Left
Spacing
Space aboveSlider 0–80px
Default: 0px
Space belowSlider 0–80px
Default: 0px
Divider
SettingTypeNotes
ThicknessSlider 1–8px
Default: 1px
WidthSlider 10–100%
Default: 100%
OpacitySlider 5–100%
Default: 20%
Spacing
Space aboveSlider 0–80px
Default: 0px
Space belowSlider 0–80px
Default: 0px
Group
SettingTypeNotes
DirectionChoice: Stacked, Side by side
Default: Stacked
Equal width columnsOn/off
Default: On
Stack on mobileOn/off
Default: On
Align itemsChoice: Start, Center, End, Stretch
Default: Stretch
DistributeChoice: Start, Center, End, Space between
Default: Start
GapSlider 0–80px
Default: 16px
Box
Color schemeColor scheme
PaddingSlider 0–80px
Default: 0px
Corner radiusSlider 0–40px
Default: 0px
Max widthSlider 0–1600px
Default: 0px
0 = full width of the section.
Spacing
Space aboveSlider 0–80px
Default: 0px
Space belowSlider 0–80px
Default: 0px
Heading
SettingTypeNotes
TextRich text (one line)
Default: Heading
HTML tagChoice: H1, H2, H3, Paragraph
Default: H2
Use one H1 per page.
SizeSlider 14–120px
Default: 40px
Size on mobileSlider 12–80px
Default: 28px
WeightChoice: Theme default, Light, Regular, Medium, Semibold, Bold
Default: Theme default
AlignmentChoice: Left, Center, Right
Default: Left
UppercaseOn/off
Default: Off
Letter spacingSlider 0–6px
Default: 0px
ColorColor
Spacing
Space aboveSlider 0–80px
Default: 0px
Space belowSlider 0–80px
Default: 0px
Image
SettingTypeNotes
ImageImage
Alt textTextDescribe the image for screen readers. Leave empty if it's decorative.
LinkLink
ShapeChoice: Original, Square, Portrait, Landscape, Wide
Default: Original
FitChoice: Fill the shape, Show the whole image
Default: Fill the shape
WidthSlider 20–100%
Default: 100%
AlignmentChoice: Left, Center, Right
Default: Left
Corner radiusSlider 0–40px
Default: 0px
Spacing
Space aboveSlider 0–80px
Default: 0px
Space belowSlider 0–80px
Default: 0px
Spacer
SettingTypeNotes
HeightSlider 0–200px
Default: 40px
Height on mobileSlider 0–160px
Default: 24px
Text
SettingTypeNotes
TextRich text
SizeSlider 0–32px
Default: 0px
0 = theme default.
AlignmentChoice: Left, Center, Right
Default: Left
Max line lengthSlider 0–120ch
Default: 0ch
0 = no limit. About 65 reads best.
ColorColor
Spacing
Space aboveSlider 0–80px
Default: 0px
Space belowSlider 0–80px
Default: 0px