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
- In your Shopify admin, go to Online Store → Themes.
- 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.
- 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.
- 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
| Setting | Type | Notes |
|---|
| Enable age verification | On/off Default: Off | |
| Heading | Text Default: Are you 18 or older? | |
| Message | Rich text | |
| Confirm button label | Text Default: I am of age | |
| Decline button label | Text Default: Leave | |
| Decline redirect URL | Link | Where to send visitors who decline. Leave blank to show a message instead. |
| Image / logo | Image | |
Animations
| Setting | Type | Notes |
|---|
| Transition duration | Slider 0–600ms Default: 200ms | |
| Reveal sections on scroll | On/off Default: On | |
| Shine effect on hover | On/off Default: Off | |
| Hover effect for cards and media | Choice: None, Raise, 3D tilt Default: None | |
Back in stock
| Setting | Type | Notes |
|---|
| Controls the "Notify me when available" product block. |
| Requests handled by | Choice: 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
| Setting | Type | Notes |
|---|
| Show sale and sold-out badges | On/off Default: On | |
| Position | Choice: Top left, Top right, Bottom left, Bottom right Default: Top left | |
| Shape | Choice: Rounded, Square, Pill, Ribbon Default: Rounded | |
| Corner radius | Slider 0–40px Default: 4px | |
| Ribbon width | Slider 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 position | Choice: 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 background | Color Default: #6a3fb5 | |
| Custom badge text | Color 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 text | Text Default: Price drop | |
| Show on product page | On/off Default: On | |
| Price drop badge background | Color Default: #e23d3d | |
| Price drop badge text | Color 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 cards | On/off Default: Off | |
| Discount code text | Text Default: [amount] off | |
| Discount code badge background | Color Default: #6a3fb5 | |
| Discount code badge text | Color 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 cards | On/off Default: Off | |
| Automatic discount text | Text Default: [amount] off | |
| Automatic discount badge background | Color Default: #1c7c54 | |
| Automatic discount badge text | Color 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 priority | Choice: 1 (highest), 2, 3 Default: 1 (highest) | |
| Discount code priority | Choice: 1 (highest), 2, 3 Default: 2 | |
| Automatic discount priority | Choice: 1 (highest), 2, 3 Default: 3 | |
| Sold-out badge |
|---|
| Sold-out badge background | Color Default: #666666 | |
| Sold-out badge text | Color Default: #ffffff | |
Blog cards
| Setting | Type | Notes |
|---|
| Text alignment | Choice: Left, Center, Right Default: Left | |
| Corner radius | Slider 0–40px Default: 8px | |
| Border thickness | Slider 0–12px Default: 0px | |
| Border opacity | Slider 0–100% Default: 10% | |
Brand story
| Setting | Type | Notes |
|---|
| Shown in the footer via a Brand information block. |
| Headline | Rich text (one line) | |
| Description | Rich text | |
| Image | Image | |
| Image width | Slider 50–550px Default: 100px | |
Breadcrumbs
| Setting | Type | Notes |
|---|
| Show breadcrumbs | On/off Default: On | |
| Breadcrumb source | Choice: 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 menu | Menu | Used 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 style | Choice: Slash (/), Chevron (›), Dot (•) Default: Slash (/) | |
| Vertical padding | Slider 0–40px Default: 12px | |
Bundles and related (metafields)
| Setting | Type | Notes |
|---|
| Bundles read from the product metafield custom.bundle_products (list of products). Related items read from custom.related_products, with an automatic collection-based fallback. |
| Bundle metafield namespace | Text Default: custom | |
| Bundle metafield key | Text Default: bundle_products | |
| Related metafield namespace | Text Default: custom | |
| Related metafield key | Text Default: related_picks | |
Buttons
| Setting | Type | Notes |
|---|
| Border thickness | Slider 0–12px Default: 1px | |
| Border opacity | Slider 0–100% Default: 100% | |
| Corner radius | Slider 0–40px Default: 0px | |
| Shadow opacity | Slider 0–100% Default: 0% | |
| Shadow horizontal offset | Slider -12–12px Default: 0px | |
| Shadow vertical offset | Slider -12–12px Default: 4px | |
| Shadow blur | Slider 0–20px Default: 5px | |
| Show back-to-top button | On/off Default: On | |
Cart
| Setting | Type | Notes |
|---|
| Cart type | Choice: Drawer, Page Default: Drawer | |
| Show vendor | On/off Default: Off | |
| Show item price | On/off Default: On | |
| Show price-drop savings | On/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 label | Text Default: Price drop | |
| Enable cart note | On/off Default: Off | |
| Free-shipping message | Text | Shown in the cart. Leave blank to hide. |
| Free-shipping progress bar |
|---|
| Show free-shipping progress bar | On/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 unlocked | Text Default: You've unlocked free shipping! | |
| Cart upsell (drawer) |
|---|
| Show "You might also like" in the cart drawer | On/off Default: Off | |
| Cart upsell heading | Text Default: You might also like | |
| Number of products | Slider 1–4 Default: 3 | |
| Prefer curated products from a product metafield | On/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 namespace | Text Default: custom | |
| Curated upsell metafield key | Text Default: cart_upsells | |
| Cart reward bar |
|---|
| Show spend-more reward bar | On/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 product | Product | Create a product (e.g. "Gift wrapping") and select it here to offer gift wrapping in the cart. |
| Show floating cart button | On/off Default: Off | A cart button that stays visible while scrolling. |
Collection cards
| Setting | Type | Notes |
|---|
| Text alignment | Choice: Left, Center, Right Default: Center | |
| Corner radius | Slider 0–40px Default: 8px | |
| Border thickness | Slider 0–12px Default: 0px | |
| Border opacity | Slider 0–100% Default: 10% | |
Colors
| Setting | Type | Notes |
|---|
| color_schemes | Color schemes | |
| Default page color scheme | Color scheme | |
Currency format
| Setting | Type | Notes |
|---|
| To change currency codes, go to your Markets settings. |
| Show currency codes | On/off Default: On | |
Dropdowns and pop-ups
| Setting | Type | Notes |
|---|
| Border thickness | Slider 0–24px Default: 1px | |
| Border opacity | Slider 0–100% Default: 10% | |
| Corner radius | Slider 0–40px Default: 0px | |
| Shadow opacity | Slider 0–100% Default: 0% | |
| Shadow horizontal offset | Slider -12–12px Default: 0px | |
| Shadow vertical offset | Slider -12–12px Default: 4px | |
| Shadow blur | Slider 0–20px Default: 5px | |
Google
| Setting | Type | Notes |
|---|
| Verification and tags |
|---|
| Search Console verification code | Text | The content value from the google-site-verification meta tag. |
| Merchant Center verification code | Text | |
Inputs
| Setting | Type | Notes |
|---|
| Border thickness | Slider 0–12px Default: 1px | |
| Border opacity | Slider 0–100% Default: 55% | |
| Corner radius | Slider 0–40px Default: 0px | |
| Shadow opacity | Slider 0–100% Default: 0% | |
| Shadow horizontal offset | Slider -12–12px Default: 0px | |
| Shadow vertical offset | Slider -12–12px Default: 4px | |
| Shadow blur | Slider 0–20px Default: 5px | |
Layout
| Setting | Type | Notes |
|---|
| Max page width | Slider 1000–1600px Default: 1280px | |
| Space between sections | Slider 0–100px Default: 48px | |
| Corner radius | Slider 0–24px Default: 0px | |
| Text direction | Choice: 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). |
Logo
| Setting | Type | Notes |
|---|
| Logo image | Image | |
| Logo width | Slider 50–300px Default: 150px | |
| Favicon | Image | Will be scaled to 32 x 32px. |
Media
| Setting | Type | Notes |
|---|
| Border thickness | Slider 0–24px Default: 0px | |
| Border opacity | Slider 0–100% Default: 5% | |
| Corner radius | Slider 0–40px Default: 0px | |
| Shadow opacity | Slider 0–100% Default: 0% | |
| Shadow horizontal offset | Slider -12–12px Default: 0px | |
| Shadow vertical offset | Slider -12–12px Default: 4px | |
| Shadow blur | Slider 0–20px Default: 5px | |
Option buttons
| Setting | Type | Notes |
|---|
| Border thickness | Slider 0–12px Default: 1px | |
| Border opacity | Slider 0–100% Default: 55% | |
| Corner radius | Slider 0–40px Default: 0px | |
| Shadow opacity | Slider 0–100% Default: 0% | |
| Shadow horizontal offset | Slider -12–12px Default: 0px | |
| Shadow vertical offset | Slider -12–12px Default: 4px | |
| Shadow blur | Slider 0–20px Default: 5px | |
Product cards
| Setting | Type | Notes |
|---|
| Image ratio | Choice: Adapt to image, Square (1:1), Portrait (3:4) Default: Square (1:1) | |
| Show vendor | On/off Default: Off | |
| Show second image on hover | On/off Default: On | |
| Style |
|---|
| Card style | Choice: Standard, Boxed Default: Standard | |
| Text alignment | Choice: 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 rating | On/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 size | Slider 10–24px Default: 14px | |
| Star color | Color Default: #f5a623 | |
| Show review count | On/off Default: On | |
| Variant swatches |
|---|
| Show variant swatches | On/off Default: On | Shows color/image swatches on cards (uses each product's option swatches). Hover previews the image; click opens that variant. |
| Swatch display | Choice: 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 shape | Choice: Circle, Square Default: Circle | |
| Swatch size | Slider 14–40px Default: 20px | |
| Swatch border | On/off Default: On | |
| Max swatches per card | Slider 2–8 Default: 5 | |
| Show volume-pricing note | On/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 offset | Slider -12–12px Default: 4px | |
| Shadow blur | Slider 0–30px Default: 10px | |
| Enable quick view | On/off Default: On | |
Reviews
| Setting | Type | Notes |
|---|
| 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 reviews | On/off Default: Off | |
Search behavior
| Setting | Type | Notes |
|---|
| Enable predictive search | On/off Default: On | |
| Show product vendor | On/off Default: Off | |
| Show product price | On/off Default: On | |
Side panels
| Setting | Type | Notes |
|---|
| Border thickness | Slider 0–24px Default: 0px | |
| Border opacity | Slider 0–100% Default: 10% | |
| Shadow opacity | Slider 0–100% Default: 0% | |
| Shadow horizontal offset | Slider -12–12px Default: 0px | |
| Shadow vertical offset | Slider -12–12px Default: 4px | |
| Shadow blur | Slider 0–20px Default: 5px | |
Social media
| Setting | Type | Notes |
|---|
| Social accounts |
|---|
| Facebook | Link | |
| Instagram | Link | |
| TikTok | Link | |
| YouTube | Link | |
| X (Twitter) | Link | |
| Pinterest | Link | |
Surfaces
| Setting | Type | Notes |
|---|
| Border thickness | Slider 0–24px Default: 0px | |
| Border opacity | Slider 0–100% Default: 10% | |
| Corner radius | Slider 0–40px Default: 0px | |
| Shadow opacity | Slider 0–100% Default: 0% | |
| Shadow horizontal offset | Slider -12–12px Default: 0px | |
| Shadow vertical offset | Slider -12–12px Default: 4px | |
| Shadow blur | Slider 0–20px Default: 5px | |
Typography
| Setting | Type | Notes |
|---|
| Heading font | Font | |
| Body font | Font | |
| Body font scale | Slider 90–130% Default: 100% | |
Announcement bar
| Setting | Type | Notes |
|---|
| Background color | Color Default: #1a1a1a | |
| Slider arrow color | Color Default: #ffffff | |
| Show separator line | On/off Default: On | |
| Full-width text | On/off Default: Off | Off keeps text within the page width. |
| Vertical padding | Slider 4–24px Default: 8px | |
| Typography |
|---|
| Font size | Slider 11–20px Default: 14px | |
| Font weight | Choice: Regular, Medium, Semibold, Bold Default: Regular | |
| Uppercase | On/off Default: Off | |
| Letter spacing | Slider 0–4px Default: 0px | |
| Behavior |
|---|
| Transition | Choice: Instant, Fade Default: Instant | |
| Show slide dots | On/off Default: Off | |
| Let shoppers dismiss | On/off Default: Off | Adds a close button; remembered on the shopper's device. |
| Social media icons |
|---|
| Show icons on desktop | On/off Default: Off | |
| Announcements |
|---|
| Auto-rotate announcements | On/off Default: On | |
| Change every | Slider 3–12s Default: 5s | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Blocks
Announcement
| Setting | Type | Notes |
|---|
| Content for center |
|---|
| Icon (emoji) | Text | Optional; shown before the center message. |
| Text for center | Text Default: Free shipping over $100 | |
| URL for center | Link | |
| Center text color | Color Default: #ffffff | |
| Content for left side |
|---|
| Text for left side | Text | |
| URL for left side | Link | |
| Left text color | Color Default: #ffffff | |
| Content for right side |
|---|
| Text for right side | Text | |
| URL for right side | Link | |
| Right text color | Color Default: #ffffff | |
Scrolling announcement
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Lead text (repeats) | Rich text (one line) | |
| Font size | Slider 12–48px Default: 18px | |
| Direction | Choice: Right to left, Left to right Default: Right to left | |
| Speed | Slider 1–55 Default: 30 | |
| Bar height | Slider 30–120px Default: 48px | |
| Border thickness | Slider 0–6px Default: 0px | |
| Separator between items | Choice: None, Dot (•), Line (|), Dash (—), Star (✦) Default: None | |
| Padding |
|---|
| Top | Slider 0–60px Default: 0px | |
| Bottom | Slider 0–60px Default: 0px | |
| Padding top (mobile) | Slider 0–120px Default: 0px | |
| Padding bottom (mobile) | Slider 0–120px Default: 0px | |
| Design |
|---|
| Hide on mobile | On/off Default: Off | |
| Hide on desktop | On/off Default: Off | |
| Section divider |
|---|
| Top divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Bottom divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Divider color | Color | Usually the color of the adjacent section/background. |
| Divider height | Slider 8–160px Default: 40px | |
| Divider height (mobile) | Slider 8–160px Default: 24px | |
| Width |
|---|
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Blocks
Item
| Setting | Type | Notes |
|---|
| Text | Rich text (one line) Default: Free shipping over $50 | |
| Icon (optional) | Image | |
| Link | Link | |
| Text color | Color | |
Product page
Bundle products
| Setting | Type | Notes |
|---|
| Shows products from a product metafield (list of products) as a buyable bundle. Set the bundle products per product under Settings > Custom data > Products. |
| Heading | Rich text (one line) Default: Frequently bought together | |
| Heading font size | Slider 15–60px Default: 27px | |
| Heading alignment | Choice: Left, Center, Right Default: Left | |
| Heading alignment (mobile) | Choice: Same as desktop, Left, Center, Right Default: Same as desktop | |
| Description | Rich text | |
| In-box heading | Text Default: Complete the set | Shown inside the bundle box (e.g. "Complete the set"). Leave blank for the theme default. |
| Layout | Choice: 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 items | On/off Default: On | Checklist layout: start extras checked (on) or unchecked / opt-in (off). |
| "This item" label | Text Default: This item | Small eyebrow on the current product's card (e.g. "This item"). Leave blank to hide. |
| Bundle price / button position | Choice: Below the products, Right of the products Default: Below the products | |
| Color scheme | Color scheme | |
| Product cards |
|---|
| Image ratio | Choice: Adapt to image, Portrait, Square Default: Square | |
| Show second image on hover | On/off Default: Off | |
| Show vendor | On/off Default: Off | |
| Show variant swatches | On/off Default: Off | Lets shoppers pick each product's variant right in the bundle. |
| Card width | Slider 90–360px Default: 150px | |
| Show border around images | On/off Default: Off | |
| Image corner radius | Slider 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 discount | Slider 0–90% Default: 0% | |
| Box |
|---|
| Maximum width | Slider 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 padding | Slider 0–60px Default: 24px | |
| Border thickness | Slider 0–12px Default: 1px | |
| Border radius | Slider 0–40px Default: 12px | |
| Section padding |
|---|
| Top padding | Slider 0–100px Default: 48px | |
| Bottom padding | Slider 0–100px Default: 48px | |
| Top padding (mobile) | Slider 0–100px Default: 36px | |
| Bottom padding (mobile) | Slider 0–100px Default: 36px | |
| Design |
|---|
| Heading weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase heading | On/off Default: Off | |
| Heading size (mobile) | Slider 14–44px Default: 22px | |
| Heading color | Color | |
| Section divider |
|---|
| Top divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Bottom divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Divider color | Color | Usually the color of the adjacent section/background. |
| Divider height | Slider 8–160px Default: 40px | |
| Metafield source |
|---|
| Metafield namespace | Text Default: custom | |
| Metafield key | Text Default: bundle_products | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Also accepts: theme blocks, app blocks.
How to use
| Setting | Type | Notes |
|---|
| Steps metafield | Text 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 none | On/off Default: On | Turn off to hide the section on products without the metafield. |
| Caption | Text Default: Ritual | |
| Heading | Rich text (one line) Default: How to use | |
| Heading size | Slider 20–64px Default: 36px | |
| Heading alignment | Choice: Left, Center Default: Left | |
| Layout | Choice: Steps in a row, Vertical timeline Default: Steps in a row | |
| Steps per row | Slider 2–5 Default: 4 | |
| Color scheme | Color scheme | |
| Top padding | Slider 0–120px Default: 72px | |
| Bottom padding | Slider 0–120px Default: 72px | |
Also accepts: theme blocks, app blocks.
Blocks
Step
| Setting | Type | Notes |
|---|
| Title | Text Default: Step | |
| Text | Rich text | |
| Image | Image | |
Key ingredients
| Setting | Type | Notes |
|---|
| Reads each product's own metafields and hides on products without them. |
| Caption | Text Default: What's inside | |
| Heading | Rich text (one line) Default: Key ingredients | |
| Heading size | Slider 20–64px Default: 36px | |
| Data |
|---|
| Key ingredients metafield | Text Default: custom.key_ingredients | Multi-line text, one per line: "Name: what it does". |
| Key ingredients source | Text 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 keys | Text | Only if your definition uses other field keys: name=your_key, benefit=your_key. |
| Full ingredient list metafield | Text Default: custom.ingredients | |
| Full list label | Text Default: Full ingredient list | |
| Full list | Choice: Collapsed, Always shown Default: Collapsed | |
| Image |
|---|
| Image | Image | |
| Image metafield | Text Default: custom.ingredients_image | A file metafield; overrides the image above on products that have it. |
| Image position | Choice: Left, Right Default: Left | |
| Style |
|---|
| Number the ingredients | On/off Default: On | |
| Color scheme | Color scheme | |
| Top padding | Slider 0–120px Default: 72px | |
| Bottom padding | Slider 0–120px Default: 72px | |
Product information
| Setting | Type | Notes |
|---|
| Enable sticky column on desktop | On/off Default: On | |
| Which column stays fixed | Choice: 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 scheme | Color scheme | |
| Enable section view | On/off Default: Off | Places the product in a coloured, rounded panel. |
| Sectioned view section color | Color Default: #f5f5f5 | |
| Sectioned view background radius | Slider 0–40px Default: 10px | |
| Show breadcrumbs | On/off Default: On | |
| Limit text to a readable width | On/off Default: Off | Caps the description/text width so long copy stays legible. |
| Media |
|---|
| Desktop media width | Slider 40–65% Default: 55% | |
| Constrain media to screen height | On/off Default: Off | |
| Media fit | Choice: 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 layout | Choice: 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 pattern | Choice: One large, then pairs, Pairs, Alternating large and pairs Default: One large, then pairs | |
| Filmstrip image height | Slider 360–800px Default: 600px | |
| Gap between images | Slider 0–32px Default: 8px | |
| Desktop media position | Choice: Left, Right Default: Left | Position is automatically optimized for mobile. |
| Image zoom | Choice: Hover to zoom, Click to open lightbox, None Default: Click to open lightbox | Lightbox opens the image full-screen on click. |
| Mobile layout | Choice: Thumbnails, Dots Default: Thumbnails | |
| Dots color | Color Default: #000000 | |
| Enable video looping | On/off Default: Off | |
| Group gallery by variant | On/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 arrows | On/off Default: On | |
| Show image counter | On/off Default: Off | |
| Thumbnail size | Slider 48–110px Default: 72px | |
| Media corner radius | Slider 0–32px Default: 12px | |
| Section padding |
|---|
| Top padding | Slider 0–100px Default: 36px | |
| Bottom padding | Slider 0–100px Default: 36px | |
| Padding top (mobile) | Slider 0–100px Default: 24px | |
| Padding bottom (mobile) | Slider 0–100px Default: 24px | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Also accepts: app blocks.
Blocks
Vendor
| Setting | Type | Notes |
|---|
| Link to vendor's products | On/off Default: Off | Links the vendor name to a page of all products from that vendor. |
| Desktop size | Choice: Small, Medium, Large Default: Small | |
| Mobile size | Choice: Small, Medium, Large Default: Small | |
| Weight | Choice: Default, Regular, Medium, Semibold, Bold Default: Default | |
| Uppercase | On/off Default: Off | |
| Letter spacing | Slider 0–4px Default: 0px | |
| Text color | Color | |
| Alignment | Choice: Left, Center, Right Default: Left | |
| Prefix | Text | e.g. "By" or "Brand:" before the name. |
| Brand logo (optional) |
|---|
| Logo metafield | Text | A product metafield holding an image (namespace.key), e.g. custom.brand_logo. Shows the logo instead of the name. |
| Logo height | Slider 16–60px Default: 28px | |
| Spacing |
|---|
| Top spacing | Slider 0–32px Default: 0px | |
| Bottom spacing | Slider 0–32px Default: 4px | |
| Show on desktop | On/off Default: On | |
| Show on mobile | On/off Default: On | |
Title
| Setting | Type | Notes |
|---|
| Desktop heading size | Choice: Small, Medium, Large Default: Medium | |
| Mobile heading size | Choice: Small, Medium, Large Default: Small | |
| Exact size — desktop | Slider 0–64px Default: 0px | 0 = use the preset above. |
| Exact size — mobile | Slider 0–48px Default: 0px | 0 = use the preset above. |
| Weight | Choice: Theme default, Light, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase | On/off Default: Off | |
| Letter spacing | Slider -2–6px Default: 0px | |
| Line height | Slider 0–2 Default: 0 | 0 = theme default. |
| Color | Color | |
| Alignment | Choice: Left, Center, Right Default: Left | |
| Top spacing | Slider 0–32px Default: 0px | |
| Bottom spacing | Slider 0–32px Default: 0px | |
Price
| Setting | Type | Notes |
|---|
| Price size — desktop | Slider 0–48px Default: 0px | 0 = theme default. |
| Price size — mobile | Slider 0–40px Default: 0px | 0 = theme default. |
| Price weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Price color | Color | |
| Sale price color | Color | |
| Compare-at color | Color | |
| Compare-at size | Slider 0–30px Default: 0px | 0 = theme default. |
| Layout |
|---|
| Layout | Choice: Inline, Stacked (compare-at below) Default: Inline | |
| Alignment | Choice: Left, Center, Right Default: Left | |
| Savings |
|---|
| Show savings | Choice: Don't show, Amount (Save $20), Percent (Save 20%), Amount + percent Default: Don't show | |
| Savings label | Text Default: Save | |
| Price range |
|---|
| Show "From" price when variants differ | On/off Default: Off | Shows the lowest variant price until a variant is chosen. |
| "From" label | Text Default: From | |
| Note |
|---|
| Tax / shipping note | Rich text (one line) | e.g. Tax included. Shipping calculated at checkout. |
Description
| Setting | Type | Notes |
|---|
| Presentation | Choice: Plain text, With heading, Collapsible row Default: Plain text | |
| Heading | Text Default: Description | |
| Open by default | On/off Default: On | |
| Heading size | Slider 0–36px Default: 0px | 0 = default. |
| Heading weight | Choice: Default, Regular, Medium, Semibold, Bold Default: Default | |
| Content |
|---|
| Source | Choice: Product description, Metafield, Metafield, else description Default: Product description | |
| Metafield key | Text 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 descriptions | On/off Default: Off | Truncates the description and adds a "Read more" toggle. |
| Collapse on | Choice: All screens, Mobile only, Desktop only Default: All screens | |
| Collapse by | Choice: Height, Number of lines Default: Height | |
| Collapsed height | Slider 80–500px Default: 200px | |
| Collapsed lines | Slider 2–20 Default: 6 | |
| "Read more" label | Text | Leave blank for the theme default. |
| "Read less" label | Text | Leave blank for the theme default. |
| Toggle style | Choice: Text link, Underlined link, Link with chevron, Outline button Default: Text link | |
| Fade out collapsed text | On/off Default: On | |
| Typography |
|---|
| Text size | Slider 0–24px Default: 0px | 0 = default. |
| Line height | Slider 0–2.4 Default: 0 | 0 = default. |
| Text color | Color | |
| Alignment | Choice: Left, Center, Justified Default: Left | |
| Maximum line length | Choice: Full width, Narrow (~60 characters), Medium (~70 characters), Wide (~80 characters) Default: Full width | |
| Formatting |
|---|
| Bullet style | Choice: Default, Checkmark, Dash, Accent dot Default: Default | |
| Link and bullet color | Color | |
| Image corner radius | Slider 0–30px Default: 0px | |
| Container |
|---|
| Style | Choice: None, Tinted panel, Bordered card Default: None | |
| Background | Color | |
| Border color | Color | |
| Padding | Slider 0–48px Default: 0px | 0 = default. |
| Corner radius | Slider 0–30px Default: 0px | 0 = theme default. |
| Top spacing | Slider 0–60px Default: 0px | |
| Bottom spacing | Slider 0–60px Default: 0px | |
Rating (reviews metafield)
| Setting | Type | Notes |
|---|
| 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 source | Choice: Shopify rating metafield (default), Third-party review app Default: Shopify rating metafield (default) | |
| Review app badge code | Liquid | Paste 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 style | Choice: Solid, Outline empty stars, Rounded Default: Solid | |
| Star size | Slider 10–40px Default: 18px | |
| Gap between stars | Slider 0–10px Default: 2px | |
| Star color | Color | Leave empty to use the theme's accent color. |
| Empty star color | Color | Leave empty for a light tint of the text color. |
| Text |
|---|
| Average rating number | Choice: Hidden, Before stars, After stars Default: Hidden | |
| Show review count | On/off Default: On | |
| Count format | Choice: (24), 24 reviews, 24 ratings Default: (24) | |
| Custom count label | Text | Overrides the format above. [count] = number of reviews, e.g. "[count] happy customers". |
| Text color | Color | |
| Text size | Slider 0–20px Default: 0px | 0 = default. |
| Link and empty state |
|---|
| Link to the reviews section | On/off Default: On | |
| Reviews section anchor | Text Default: #reviews | The Product reviews section uses #reviews. For a review app, use its widget's anchor. |
| Products with no reviews | Choice: Hide the rating, Show empty stars, Show text only Default: Hide the rating | |
| No-reviews text | Text | Leave blank for "No reviews yet". |
| Layout |
|---|
| Alignment | Choice: Left, Center, Right Default: Left | |
| Top spacing | Slider 0–40px Default: 0px | |
| Bottom spacing | Slider 0–40px Default: 8px | |
Inventory / shipping text
| Setting | Type | Notes |
|---|
| Shipping / delivery text |
|---|
| Shipping text | Choice: 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 threshold | Slider 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 low | On/off Default: On | Off shows a generic "Low stock" message instead of the number. |
| Indicator | Choice: Dot, Stock bar, Icon, None Default: Dot | |
| In-stock color | Color | |
| Low-stock color | Color | |
| Sold-out color | Color | |
| Wording |
|---|
| In stock text | Text | |
| Low stock text | Text | |
| Exact quantity text | Text | Use [n] for the number, e.g. "Only [n] left". |
| Sold out text | Text | |
| Backorder / pre-order text | Text Default: Available on backorder | Shown when stock is 0 but the product still sells (continue selling). |
| Dispatch cutoff |
|---|
| Show order-by countdown | On/off Default: Off | |
| Cutoff hour (24h, store time) | Slider 0–23h Default: 15h | |
| Cutoff text | Text Default: Order within [timer] for same-day dispatch | Use [timer] where the countdown should appear. |
| Appearance |
|---|
| Font size | Slider 0–22px Default: 0px | 0 = default. |
| Font weight | Choice: Default, Regular, Medium, Semibold, Bold Default: Default | |
| Text color | Color | |
| Alignment | Choice: Left, Center, Right Default: Left | |
| Top spacing | Slider 0–32px Default: 0px | |
| Bottom spacing | Slider 0–32px Default: 0px | |
Variant picker
| Setting | Type | Notes |
|---|
| 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 style | Choice: Color swatches, Image swatches, Buttons (pills), Dropdown Default: Color swatches | |
| Swatch size | Slider 30–80px Default: 44px | |
| Auto-detect swatch options | On/off Default: On | Options whose values have Shopify swatches (colour/image) render as swatches; the rest use the style above. |
| Per-option style | Text (multi-line) | One per line: Option name : style. Styles: color, image, button, dropdown. e.g. Color : color |
| Availability |
|---|
| Unavailable values | Choice: Dim, Strike through, Hide, No change Default: Dim | How to show option values that can't be combined with the current selection. |
| Appearance |
|---|
| Swatch shape | Choice: Square, Rounded, Circle Default: Rounded | |
| Selected style | Choice: Ring, Solid border, Checkmark Default: Ring | |
| Swatch border color | Color | |
| Space between values | Slider 2–20px Default: 8px | |
| Scroll values on mobile | On/off Default: Off | Keeps long size runs on one line. |
| Labels |
|---|
| Show selected value in label | On/off Default: On | |
| Label size | Slider 0–22px Default: 0px | 0 = default. |
| Label weight | Choice: Default, Regular, Medium, Semibold, Bold Default: Default | |
| Uppercase labels | On/off Default: Off | |
Quantity selector
| Setting | Type | Notes |
|---|
| Add this to position the quantity stepper on its own. Without it, the stepper stays inside the Buy buttons block. |
| Layout |
|---|
| Desktop layout | Choice: 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 layout | Choice: Own row (stacked), Inline with Add to cart Default: Own row (stacked) | |
| Alignment | Choice: Left, Center, Right Default: Left | Stacked layout only. |
| Label |
|---|
| Label position | Choice: Above, Beside the stepper, Hidden Default: Above | Automatically hidden in the inline layout. |
| Label text | Text | Blank uses the theme translation. |
| Uppercase label | On/off Default: Off | |
| Stepper |
|---|
| Style | Choice: Buttons (− 1 +), Plain input, Dropdown Default: Buttons (− 1 +) | |
| Height | Slider 0–64px Default: 0px | 0 = default. Match your Add to cart button height. |
| Width | Slider 0–220px Default: 0px | 0 = automatic. |
| Corner radius | Slider 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 override | Slider 0–20 Default: 0 | 0 = use Shopify's rule. |
| Maximum override | Slider 0–100 Default: 0 | 0 = use Shopify's rule. |
Buy buttons
| Setting | Type | Notes |
|---|
| Add to cart button |
|---|
| Add to cart label | Text | Blank uses the theme translation. |
| Sold out label | Text | |
| Pre-order label | Text | |
| Show bag icon | On/off Default: Off | |
| Button style | Choice: Solid, Outline Default: Solid | |
| Full width | On/off Default: On | |
| Button height | Slider 0–72px Default: 0px | 0 = theme default. |
| Corner radius | Slider 0–40px Default: 8px | |
| Button background | Color | |
| Button text color | Color | |
| Space between buttons | Slider 0–24px Default: 10px | |
| Checkout buttons |
|---|
| Show dynamic checkout button | On/off Default: On | |
| Checkout button position | Choice: Below Add to cart, Above Add to cart Default: Below Add to cart | |
| Show Shop Pay Installments banner | On/off Default: On | |
| Pre-order |
|---|
| Show pre-order note | On/off Default: On | |
| Pre-order note | Text | Blank uses the theme translation. |
| Subscriptions |
|---|
| Purchase options heading | Text | Blank uses the theme translation. |
| Purchase options layout | Choice: Radio list, Bordered cards Default: Radio list | |
| Other |
|---|
| Show gift-card recipient form | On/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 mobile | On/off Default: On | |
| Enable sticky add to cart on desktop | On/off Default: Off | |
| Sticky add to cart button width | Slider 30–100% Default: 50% | |
Share
| Setting | Type | Notes |
|---|
| Display | Choice: 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 label | Text Default: Share | |
| Use the device share sheet on mobile | On/off Default: On | Phones that support it get the share sheet instead of the icons. |
| Leading label | Text | e.g. "Share:" before the icons. |
| Networks |
|---|
| Facebook | On/off Default: On | |
| X (Twitter) | On/off Default: On | |
| Pinterest | On/off Default: On | Includes the product image. |
| WhatsApp | On/off Default: On | |
| Telegram | On/off Default: Off | |
| Email | On/off Default: On | |
| Copy link | On/off Default: On | |
| Shared link |
|---|
| Include the selected variant | On/off Default: On | |
| Add UTM tags | On/off Default: Off | Adds utm_source=<network>&utm_medium=share so shares appear in analytics. |
| Share text | Text Default: Check out [product] | [product] = product title. |
| "Link copied" message | Text | Leave blank for the theme default. |
| Icons |
|---|
| Icon style | Choice: Plain, Outlined circle, Filled circle, Rounded square Default: Plain | |
| Colors | Choice: Monochrome, Brand colors Default: Monochrome | |
| Icon size | Slider 14–36px Default: 18px | |
| Icon and text color | Color | Monochrome only. |
| Show network name on hover | On/off Default: On | |
| Layout |
|---|
| Alignment | Choice: Left, Center, Right Default: Left | |
| Gap between icons | Slider 0–30px Default: 10px | |
| Divider above | On/off Default: Off | |
| Top spacing | Slider 0–60px Default: 16px | |
| Bottom spacing | Slider 0–60px Default: 0px | |
Store pickup
| Setting | Type | Notes |
|---|
| Shows local pickup availability for the selected variant. Set up locations in Settings → Locations. |
| Status line |
|---|
| Available text | Text | Use [location] for the store name. Blank uses the theme translation. |
| Unavailable text | Text | Use [location] for the store name. |
| Indicator | Choice: Dot, Map pin, Store, None Default: Dot | |
| Available color | Color | |
| Unavailable color | Color | |
| Show address | On/off Default: Off | |
| Show "Get directions" link | On/off Default: Off | Opens Google Maps directions to the store. |
| Directions link text | Text Default: Get directions | |
| Hide block when pickup is unavailable everywhere | On/off Default: Off | |
| Availability modal |
|---|
| Modal heading | Text | Blank uses the product title. |
| List available stores first | On/off Default: On | |
| Enable store search | On/off Default: Off | Shown when you have more than two locations. |
| Search placeholder | Text Default: Search stores | |
| No-results text | Text Default: No stores match your search. | |
| Appearance |
|---|
| Font size | Slider 0–22px Default: 0px | 0 = default. |
| Font weight | Choice: Default, Regular, Medium, Semibold, Bold Default: Default | |
| Text color | Color | |
| Alignment | Choice: Left, Center, Right Default: Left | |
| Top spacing | Slider 0–32px Default: 0px | |
| Bottom spacing | Slider 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" note | On/off Default: Off | |
| Note text | Text Default: Reserve online & pay when you pick up | |
| "Check availability" button |
|---|
| Button text | Text Default: Check availability at other stores | |
| Style | Choice: Text link, Outline, Solid Default: Text link | |
| Size | Choice: Small, Medium, Large Default: Medium | |
| Full width | On/off Default: Off | |
| Show location icon | On/off Default: Off | |
| Accent color | Color | Border + text (Outline/Text link), or background (Solid). Blank = theme color. |
| Text color (Solid / Outline hover) | Color | Blank = theme default. |
Size chart
| Setting | Type | Notes |
|---|
| Button label | Text 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 metafield | Text Default: custom.size_guide | namespace.key of a product metafield that references a size guide entry. |
| Default size guide entry | Text | Type 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 key | Text | e.g. custom.size_chart_image (a File metafield) |
| Table metafield key | Text | e.g. custom.size_chart_table (a JSON metafield) |
| Legacy (same for all products) |
|---|
| Page | Page | |
| Image | Image | |
| Button appearance |
|---|
| Style | Choice: Text link, Outline, Solid Default: Outline | |
| Size | Choice: Small, Medium, Large Default: Medium | |
| Full width | On/off Default: Off | |
| Show ruler icon | On/off Default: On | |
| Accent color | Color | Border + text (Outline/Text link), or background (Solid). Blank = theme color. |
| Text color (Solid / Outline hover) | Color | Blank = theme default. |
| Popup |
|---|
| Open as | Choice: Centered popup, Side drawer Default: Centered popup | |
| Bottom sheet on mobile | On/off Default: Off | |
| Width | Choice: Small, Medium, Wide Default: Wide | |
| Corner radius | Slider 0–30px Default: 0px | 0 = theme default. |
| Chart heading size | Slider 0–36px Default: 0px | 0 = default. |
| Placement |
|---|
| Size option name | Text 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 label | On/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 option | On/off Default: Off | |
| Units |
|---|
| Show cm / in switch | On/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 in | Choice: Centimetres, Inches Default: Centimetres | |
| Show first in | Choice: Centimetres, Inches Default: Centimetres | |
| Table |
|---|
| Highlight the selected size | On/off Default: On | Matches the chosen option value against the first column. |
| Sticky header row and first column | On/off Default: On | |
| Striped rows | On/off Default: Off | |
| Row spacing | Choice: Comfortable, Compact Default: Comfortable | |
| Cell alignment | Choice: Left, Center Default: Left | |
| Table text size | Slider 0–20px Default: 0px | 0 = default. |
| Header background | Color | |
| Header text | Color | |
| Border color | Color | |
| Extra content |
|---|
| How to measure image | Image | |
| How to measure text | Rich text | Adding an image or text adds a "How to measure" tab. |
| Fit hint | Text | Shown under the button, e.g. "Runs small — we recommend sizing up". |
| Fit hint metafield key | Text | namespace.key of a text metafield. Overrides the fit hint per product. |
| Footer note | Rich text | e.g. "Still unsure? Contact us" with a link. |
| Top spacing | Slider 0–60px Default: 12px | |
| Bottom spacing | Slider 0–60px Default: 12px | |
Tab
| Setting | Type | Notes |
|---|
| Tab heading | Text Default: Tab | |
| Content | Choice: Rich text, Page, Product description, Product metafield Default: Rich text | |
| Content | Rich text | |
| Page | Page | If set, the page content is used instead of the text above. |
| Metafield key | Text | namespace.key of a rich text or multi-line text metafield, e.g. custom.materials. |
| Hide this tab when it has no content | On/off Default: On | |
| Icon | Choice: None, Shipping (truck), Returns, Warranty / secure, Eco / natural, FAQ / help, Package, Gift, Sizing, Support, Time Default: None | |
| Open this tab first | On/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. |
| Style | Choice: Underline, Pills, Boxed (segmented), Minimal text Default: Underline | |
| Alignment | Choice: Left, Center, Stretch to full width Default: Left | |
| On mobile | Choice: Wrap tabs onto lines, Scroll tabs sideways, Turn into an accordion Default: Wrap tabs onto lines | |
| Label size | Slider 0–24px Default: 0px | 0 = default. |
| Label weight | Choice: Default, Regular, Medium, Semibold, Bold Default: Default | |
| Uppercase labels | On/off Default: Off | |
| Inactive label opacity | Slider 20–100% Default: 60% | |
| Active label color | Color | |
| Indicator / active background | Color | Underline color, or the active pill/box background. |
| Divider line color | Color | |
| Panel background | Color | |
| Panel padding | Slider 0–40px Default: 0px | 0 = none. |
| Panel corner radius | Slider 0–30px Default: 0px | |
| Fade in when switching tabs | On/off Default: On | |
| Top spacing | Slider 0–60px Default: 16px | |
| Bottom spacing | Slider 0–60px Default: 16px | |
Content blocks
| Setting | Type | Notes |
|---|
| 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. |
| Heading | Text | |
| Heading size | Slider 0–40px Default: 0px | 0 = default. |
| Heading alignment | Choice: Left, Center, Right Default: Left | |
| Layout and behavior |
|---|
| Layout | Choice: Accordion, Bordered cards, Plain rows Default: Accordion | |
| Open behavior | Choice: All closed, Open first, Open all, One at a time Default: All closed | |
| Toggle icon | Choice: Plus / minus, Chevron, Caret, None Default: Plus / minus | |
| Title weight | Choice: Default, Regular, Medium, Semibold, Bold Default: Default | |
| Space between items | Slider 0–24px Default: 0px | |
| Divider / border color | Color | |
| Body text size | Slider 0–20px Default: 0px | 0 = default. |
| Hide row icons | On/off Default: Off | |
| Row icon size | Slider 16–48px Default: 24px | |
| Open the first one | On/off Default: Off | Legacy — use "Open behavior" above instead. |
| Per-product metafield |
|---|
| Metafield namespace | Text Default: custom | |
| Metafield key | Text 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 key | Text Default: heading | |
| Body field key (rich text) | Text Default: body | |
| Icon field key | Text Default: icon | |
| Link field key (URL) | Text Default: link | |
| Link label field key | Text Default: link_label | The link's text, e.g. "Support". Falls back to "Learn more". |
| Open link in new tab | On/off Default: Off | |
| Default list |
|---|
| Default entries | Text | Type 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
| Setting | Type | Notes |
|---|
| 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. |
| Heading | Text | |
| Columns | Choice: Auto-fit, 2 columns, 3 columns, 4 columns Default: Auto-fit | |
| Layout | Choice: Cards, Minimal (no border), Spec table, Chips, Icon list Default: Cards | |
| Mobile columns | Choice: Automatic, 1 column, 2 columns Default: Automatic | Applies to Cards and Minimal layouts. |
| Content order | Choice: 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" label | Text Default: Show all specs | |
| Row dividers | On/off Default: Off | For Spec table, Icon list and Minimal layouts. |
| Per-product metafield |
|---|
| Metafield namespace | Text Default: custom | |
| Metafield key | Text 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 key | Text Default: label | |
| Value field key | Text Default: value | |
| Icon field key | Text Default: icon | |
| Description field key | Text Default: description | Optional small line under the value. |
| Link field key | Text Default: link | Optional URL field — makes the whole tile clickable. |
| Open link in new tab | On/off Default: Off | |
| Default list |
|---|
| Default entries | Text | Type 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 size | Slider 0–64px Default: 0px | 0 = default. |
| Icon style | Choice: Plain, Circle badge, Rounded-square badge Default: Plain | |
| Icon color | Color | Applies to preset icons. |
| Icon badge background | Color | |
| Heading |
|---|
| Heading size | Slider 0–36px Default: 0px | 0 = default. |
| Heading weight | Choice: Default, Regular, Medium, Semibold, Bold Default: Default | |
| Heading alignment | Choice: Left, Center, Right Default: Left | |
| Heading color | Color | |
| Appearance |
|---|
| Content alignment | Choice: Left, Center Default: Left | |
| Show tile border | On/off Default: On | |
| Tile background | Color | |
| Border / divider color | Color | |
| Corner radius | Slider 0–30px Default: 0px | 0 = theme default. |
| Gap between items | Slider 0–40px Default: 0px | 0 = default. |
| Tile padding | Slider 0–40px Default: 0px | 0 = default. |
| Label color | Color | |
| Label size | Slider 0–24px Default: 0px | 0 = default. |
| Value color | Color | |
| Value size | Slider 0–32px Default: 0px | 0 = default. |
| Value weight | Choice: Default, Regular, Medium, Semibold, Bold Default: Default | |
| Top spacing | Slider 0–60px Default: 0px | |
| Bottom spacing | Slider 0–60px Default: 0px | |
Volume pricing
| Setting | Type | Notes |
|---|
| 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. |
| Heading | Text Default: Buy more, save more | |
| Heading size | Slider 0–32px Default: 0px | 0 = default. |
| Heading alignment | Choice: Left, Center, Right Default: Left | |
| Clicking a tier sets the quantity | On/off Default: On | |
| Layout |
|---|
| Layout | Choice: List, Table (with headers), Cards Default: List | |
| Qty column label | Text Default: Qty | |
| Save column label | Text Default: Save | |
| Price column label | Text Default: Price | |
| Tiers |
|---|
| Show quantity ranges | On/off Default: On | Shows 2–4, 5–9, 10+ instead of 2+, 5+, 10+. |
| Show the single-unit row | On/off Default: Off | Adds a 1+ row so the ladder starts at one. |
| Savings display | Choice: Percent off, Amount off per unit, Total saved, Don't show Default: Percent off | |
| Show total price per tier | On/off Default: Off | |
| "each" wording | Text | Blank uses the theme translation. |
| Highlight |
|---|
| Highlight tier number | Slider 0–8 Default: 0 | 0 = none. 1 = the first tier, 2 = the second, and so on. |
| Badge text | Text Default: Best value | |
| Appearance |
|---|
| Tier border color | Color | |
| Selected tier color | Color | |
| Corner radius | Slider 0–24px Default: 8px | |
| Space between tiers | Slider 0–20px Default: 8px | |
| Top spacing | Slider 0–32px Default: 0px | |
| Bottom spacing | Slider 0–32px Default: 0px | |
| Metafield fallback |
|---|
| Metafield namespace | Text Default: custom | |
| Metafield key | Text Default: quantity_breaks | JSON list of {"quantity":N,"discount":PERCENT}. Ignored when native volume pricing is configured. |
Variant specification
| Setting | Type | Notes |
|---|
| Heading | Text Default: Specifications | |
| Metafield namespace | Text 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 size | Slider 14–40px Default: 20px | |
| Heading alignment | Choice: Left, Center, Right Default: Left | |
| Layout |
|---|
| Layout | Choice: Rows (table), Grid (key–value cards), Inline (chips) Default: Rows (table) | |
| Row style | Choice: Divided, Striped, Borderless Default: Divided | Applies to the Rows layout. |
| Divider color | Color | |
| Density | Choice: Comfortable, Compact Default: Comfortable | |
| Labels and values |
|---|
| Label column width | Slider 20–60% Default: 35% | Rows layout. |
| Label weight | Choice: Regular, Medium, Semibold, Bold Default: Semibold | |
| Uppercase labels | On/off Default: Off | |
| Label color | Color | |
| Value alignment | Choice: Left, Right Default: Left | Rows layout. |
| Color swatch size | Slider 10–28px Default: 14px | |
| Collapsible |
|---|
| Show as collapsible section | On/off Default: Off | |
| Open by default | On/off Default: On | |
Trust badges
| Setting | Type | Notes |
|---|
| Layout | Choice: 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. |
| Alignment | Choice: Automatic, Left, Center Default: Automatic | Automatic: 1 column puts the icon beside the text; 2+ columns stack it above centered text. |
| Badge 1 |
|---|
| Icon | Choice: 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 icon | Image | |
| Badge 4 text | Text Default: Secure checkout | |
| Subtitle | Text | |
| Link | Link | |
| Badge 2 |
|---|
| Icon | Choice: None, Shield, Lock, Truck, Return, Leaf, Gift, Support, Check, Medal, Card, Star, Clock, Globe Default: Truck | |
| Badge 2 icon | Image | |
| Badge 4 text | Text Default: Free returns | |
| Subtitle | Text | |
| Link | Link | |
| Badge 3 |
|---|
| Icon | Choice: None, Shield, Lock, Truck, Return, Leaf, Gift, Support, Check, Medal, Card, Star, Clock, Globe Default: Return | |
| Badge 3 icon | Image | |
| Badge 4 text | Text | |
| Subtitle | Text | |
| Link | Link | |
| Badge 4 |
|---|
| Icon | Choice: None, Shield, Lock, Truck, Return, Leaf, Gift, Support, Check, Medal, Card, Star, Clock, Globe Default: None | |
| Badge 4 icon | Image | |
| Badge 4 text | Text | |
| Subtitle | Text | |
| Link | Link | |
| Icons |
|---|
| Icon size | Slider 0–48px Default: 0px | 0 = default. |
| Icon style | Choice: Plain, Circle, Rounded square Default: Plain | |
| Icon color | Color | Built-in icons only. |
| Icon background | Color | Used by the Circle and Rounded square styles. |
| Text |
|---|
| Title size | Slider 0–24px Default: 0px | 0 = default. |
| Title weight | Choice: Default, Regular, Medium, Semibold, Bold Default: Default | |
| Text color | Color | |
| Payment icons |
|---|
| Show payment icons | On/off Default: On | |
| Heading | Text | e.g. "Guaranteed safe and secure checkout". |
| Icon width | Slider 24–60px Default: 36px | |
| Monochrome icons | On/off Default: Off | |
| Container |
|---|
| Background color | Color | Blank = no background. Set it for a tinted panel. |
| Border color | Color | Blank = no border. Also used for dividers and card borders. |
| Corner radius | Slider 0–30px Default: 0px | 0 = theme default. |
| Top spacing | Slider 0–60px Default: 12px | |
| Bottom spacing | Slider 0–60px Default: 12px | |
Collapsible row
| Setting | Type | Notes |
|---|
| Heading | Text Default: Ingredients | |
| Content source | Choice: Rich text, Product metafield, Page, Shipping policy, Refund policy, Privacy policy, Terms of service Default: Rich text | Store policies are edited in Settings > Policies. |
| Content | Rich text | |
| Page | Page | |
| Metafield namespace | Text Default: custom | |
| Metafield key | Text | e.g. "ingredients". Reads the product metafield namespace.key. |
| Hide this row when it has no content | On/off Default: On | |
| Behavior |
|---|
| Open by default | On/off Default: Off | |
| Close other rows when this one opens | On/off Default: Off | Applies among rows that all have this turned on. |
| Animate opening | On/off Default: On | |
| Icon and indicator |
|---|
| Heading icon | Choice: None, Shipping (truck), Returns, Warranty / secure, Eco / natural, FAQ / help, Package, Gift, Sizing, Support, Time Default: None | |
| Custom icon image | Image | Replaces the icon above. |
| Icon size | Slider 0–40px Default: 0px | 0 = default. |
| Icon color | Color | |
| Open/close indicator | Choice: Plus / minus, Chevron, Caret, None Default: Plus / minus | |
| Indicator position | Choice: Right, Left Default: Right | |
| Style |
|---|
| Row style | Choice: Divider lines, Cards, Filled Default: Divider lines | |
| Heading size | Slider 0–28px Default: 0px | 0 = default. |
| Heading weight | Choice: Default, Regular, Medium, Semibold, Bold Default: Default | |
| Uppercase heading | On/off Default: Off | |
| Content text size | Slider 0–22px Default: 0px | 0 = default. |
| Text color | Color | |
| Border color | Color | |
| Background color | Color | Used by Cards and Filled. |
| Corner radius | Slider 0–24px Default: 0px | Cards and Filled. 0 = theme default. |
| Heading padding | Slider 0–32px Default: 0px | 0 = default. |
| Top spacing | Slider 0–40px Default: 0px | |
| Bottom spacing | Slider 0–40px Default: 0px | |
Back-in-stock
| Setting | Type | Notes |
|---|
| Shown automatically when the selected variant is sold out. Submissions email the store (via the contact form) as a notify-me request. |
| Presentation | Choice: Inline (plain), Inline (card), Button opens popup Default: Inline (card) | |
| Popup button label | Text Default: Notify me when available | |
| Open popup automatically when a sold-out variant is selected | On/off Default: Off | |
| Heading | Text Default: Notify me when available | Use [variant] to insert the selected variant name. |
| Replace [variant] with the selected variant | On/off Default: Off | |
| Button label | Text Default: Notify me | |
| Fields |
|---|
| Collect | Choice: 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 name | On/off Default: Off | |
| Email placeholder | Text Default: you@example.com | |
| Phone placeholder | Text Default: +1 555 000 0000 | |
| Name placeholder | Text Default: Your name | |
| Consent and privacy |
|---|
| Marketing consent checkbox | Choice: Hidden, Shown, optional, Shown, required to submit Default: Hidden | Restock alerts are transactional; this checkbox is for additional marketing consent. |
| Consent label | Text Default: Yes, email me news and offers too. | |
| Privacy note | Text | |
| Privacy policy link | Link | |
| When to show |
|---|
| Show the form when | Choice: Variant is sold out, Sold out or low stock, Always Default: Variant is sold out | |
| Low stock threshold | Slider 1–50 Default: 5 | |
| Hide on variants that continue selling when out of stock | On/off Default: On | |
| Messages |
|---|
| Helper text | Text | Shown under the fields. Supports [variant]. |
| Success message | Text | Leave blank for the theme default. |
| Error message | Text | Leave blank for the theme default. |
| Layout |
|---|
| Desktop layout | Choice: Field and button on one row, Stacked Default: Field and button on one row | |
| Mobile layout | Choice: Field and button on one row, Stacked Default: Stacked | |
| Full-width button | On/off Default: Off | |
| Button icon | Choice: None, Bell, Envelope Default: None | |
| Appearance |
|---|
| Heading size | Slider 0–30px Default: 0px | 0 = default. |
| Heading weight | Choice: Default, Regular, Medium, Semibold, Bold Default: Default | |
| Alignment | Choice: Left, Center Default: Left | |
| Text color | Color | |
| Accent color | Color | |
| Background color | Color | |
| Border color | Color | |
| Corner radius | Slider 0–30px Default: 0px | 0 = theme default. |
| Inner padding | Slider 0–40px Default: 14px | |
| Top spacing | Slider 0–60px Default: 12px | |
| Bottom spacing | Slider 0–60px Default: 12px | |
Discount text
| Setting | Type | Notes |
|---|
| Reads a product tag shaped CODE_DISCOUNT_amount (e.g. SUMMER_DISCOUNT_20%) and shows the code and amount. No app required. |
| Lead-in text | Text Default: Save | |
| Connector text | Text | Between the amount and the code. Default: "with code". |
| Make code click-to-copy | On/off Default: On | |
| Accent color | Color | |
| Alignment | Choice: Left, Center, Right Default: Left | |
| Font size | Slider 0–28px Default: 0px | 0 = default. |
| Font weight | Choice: Default, Regular, Medium, Semibold, Bold Default: Default | |
| Style |
|---|
| Presentation | Choice: Plain text, Pill badge, Tinted banner, Dashed ticket Default: Plain text | |
| Background color | Color Default: #fbeaea | |
| Icon |
|---|
| Icon | Choice: None, Tag, Percent, Spark, Gift, Emoji (custom) Default: Tag | |
| Emoji | Text Default: 🏷️ | |
| Icon position | Choice: Before text, After text Default: Before text | |
Variant description
| Setting | Type | Notes |
|---|
| Shows a per-variant description from a variant metafield and updates as the shopper switches variants. |
| Heading | Text | |
| Metafield namespace | Text Default: custom | |
| Metafield key | Text Default: variant_description | |
SKU
| Setting | Type | Notes |
|---|
| Label | Text Default: SKU: | |
| Text style | Choice: Body, Subtitle, Uppercase Default: Body | |
| Hide label (show value only) | On/off Default: Off | |
| Click to copy SKU | On/off Default: Off | |
| Monospace value | On/off Default: Off | |
| Uppercase | On/off Default: Off | |
| Weight | Choice: Default, Regular, Medium, Semibold, Bold Default: Default | |
| Text color | Color | |
| Alignment | Choice: Left, Center, Right Default: Left | |
| Top spacing | Slider 0–32px Default: 4px | |
| Bottom spacing | Slider 0–32px Default: 4px | |
| Show even when the SKU is empty | On/off Default: Off | |
Custom Liquid
| Setting | Type | Notes |
|---|
| Custom Liquid | Liquid | Add app snippets or other Liquid code to create advanced customizations. |
Text
| Setting | Type | Notes |
|---|
| Text | Rich text (one line) Default: Add a short line of text. | |
| Text style | Choice: Body, Subtitle, Uppercase Default: Body | |
| Alignment | Choice: Left, Center, Right Default: Left | |
| Font size | Slider 0–32px Default: 0px | 0 = style default. |
| Font weight | Choice: Default, Regular, Medium, Semibold, Bold Default: Default | |
| Text color | Color | |
| Icon |
|---|
| Icon (emoji) | Text | Optional, shown before the text. |
| Icon size | Slider 12–40px Default: 18px | |
| Callout |
|---|
| Callout style | Choice: None (plain), Tinted box, Bordered, Left accent bar Default: None (plain) | |
| Background color | Color Default: #f4f4f4 | |
| Accent / border color | Color Default: #1a1a1a | |
| Corner radius | Slider 0–24px Default: 8px | |
| Inner padding | Slider 4–32px Default: 12px | |
| Spacing |
|---|
| Top spacing | Slider 0–40px Default: 6px | |
| Bottom spacing | Slider 0–40px Default: 6px | |
Complementary products
| Setting | Type | Notes |
|---|
| 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. |
| Heading | Text Default: Pairs well with | |
| Maximum products | Slider 1–6 Default: 3 | |
Product reviews
| Setting | Type | Notes |
|---|
| Turn on reviews in Theme settings > Reviews. Using another reviews app? Add its block here (Add block > Apps) and turn My patterns reviews off. |
| Heading | Text Default: Reviews | |
| Color scheme | Color scheme | |
| Heading size | Slider 18–60px Default: 30px | |
| Heading alignment | Choice: Left, Center, Right Default: Left | |
| Heading alignment (mobile) | Choice: Same as desktop, Left, Center, Right Default: Same as desktop | |
| Reviews added by hand |
|---|
| Reviews source | Text 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 keys | Text | Only 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 breakdown | On/off Default: On | |
| Star color | Color Default: #f5a623 | |
| Star size | Slider 12–26px Default: 16px | |
| Review list |
|---|
| Columns (desktop) | Choice: 1 column, 2 columns Default: 1 column | |
| Show reviewer initials | On/off Default: On | |
| Show review dates | On/off Default: On | |
| Reviews per page | Slider 5–50 Default: 10 | Used when a reviews app supplies the list. |
| Default sort | Choice: Newest, Highest rated, Lowest rated, Most helpful Default: Newest | |
| Show rating / photo filters | On/off Default: On | Appears only when a connected reviews app supports filtering. |
| Write a review |
|---|
| Show "Write a review" button | On/off Default: On | Appears only when a connected reviews app accepts submissions. |
| Button label | Text Default: Write a review | |
| Spacing |
|---|
| Top padding | Slider 0–120px Default: 40px | |
| Bottom padding | Slider 0–120px Default: 40px | |
| Top padding (mobile) | Slider 0–120px Default: 32px | |
| Bottom padding (mobile) | Slider 0–120px Default: 32px | |
| Design |
|---|
| Heading weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase heading | On/off Default: Off | |
| Heading size (mobile) | Slider 14–44px Default: 24px | |
| Heading color | Color | |
| Section divider |
|---|
| Top divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Bottom divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Divider color | Color | Usually the color of the adjacent section/background. |
| Divider height | Slider 8–160px Default: 40px | |
| Width |
|---|
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Also accepts: app blocks.
Product specifications
| Setting | Type | Notes |
|---|
| Hidden automatically when a product has no values. Rows with an empty value are skipped. |
| Content from | Choice: 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 source | Text Default: custom.spec_groups | Used with "Specification groups". A product list metafield (namespace.key), a metaobject type, or "type: handle, handle". |
| Field keys | Text | Only if your definition uses other field keys: title=your_key, rows=your_key. |
| Compare with | Products | Used with "Comparison". Connect to a product metafield (list of products) for per-product comparisons. |
| Heading |
|---|
| Heading | Rich text (one line) Default: Craftsmanship & specifications | |
| Subheading | Text Default: Materials, dimensions & care | |
| Heading size | Slider 20–72px Default: 40px | |
| Heading alignment | Choice: Left, Center Default: Left | |
| Layout |
|---|
| Layout | Choice: Columns, Table, Cards, Accordion Default: Columns | |
| Columns on desktop | Slider 1–4 Default: 4 | |
| Number the groups (01 / 02 …) | On/off Default: On | |
| Open groups | Choice: First, All, None Default: First | |
| Value style | Choice: Large, heading font, Regular Default: Large, heading font | |
| Uppercase labels | On/off Default: On | |
| Divider lines | On/off Default: On | |
| Comparison |
|---|
| Show product images | On/off Default: On | |
| Highlight this product's column | On/off Default: On | |
| Section |
|---|
| Color scheme | Color scheme | |
| Width | Choice: Standard, Wide, Full width Default: Standard | |
| Top padding | Slider 0–120px Default: 72px | |
| Bottom padding | Slider 0–120px Default: 72px | |
| Top padding (mobile) | Slider 0–120px Default: 48px | |
| Bottom padding (mobile) | Slider 0–120px Default: 48px | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Blocks
Group
| Setting | Type | Notes |
|---|
| Title | Text Default: Materials | |
| Rows after this block belong to this group until the next Group. |
Row
| Setting | Type | Notes |
|---|
| Label | Text Default: Material | |
| Metafield key | Text | namespace.key, e.g. custom.material. Built-ins: product.vendor, product.type, product.category, variant.sku, variant.barcode, variant.weight. |
| Value | Rich text (one line) | Used when the key is empty or has no value. Connect a dynamic source to read any metafield. |
Products by metafield
| Setting | Type | Notes |
|---|
| Heading | Rich text (one line) Default: Metafield products | |
| Heading font size | Slider 15–60px Default: 27px | |
| Heading alignment | Choice: Left, Center, Right Default: Left | |
| Heading alignment (mobile) | Choice: Same as desktop, Left, Center, Right Default: Same as desktop | |
| Description | Rich text | |
| Description style | Choice: Body, Subtitle, Uppercase Default: Body | |
| Maximum products to show | Slider 2–24 Default: 8 | |
| Number of columns on desktop | Slider 2–6 Default: 4 | |
| Slider Product view | On/off Default: On | On: horizontal slider. Off: static grid. |
| Show Slider Counter | On/off Default: Off | |
| Auto-rotate slider | On/off Default: Off | |
| Auto-rotate speed | Slider 2–10s Default: 4s | |
| Color scheme | Color scheme | |
| Product card |
|---|
| Image ratio | Choice: Adapt to image, Portrait, Square Default: Adapt to image | |
| Image shape | Choice: 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 hover | On/off Default: Off | |
| Show vendor | On/off Default: Off | |
| Show rating on cards | On/off Default: Off | Shows stars when a product has a reviews rating metafield. |
| Enable quick add button | On/off Default: On | |
| Quick add button style | Choice: Outline button, Solid button Default: Outline button | |
| Mobile Layout |
|---|
| Number of columns on mobile | Choice: 1 column, 2 columns Default: 2 columns | |
| Enable swipe on mobile | On/off Default: On | Slider view only. Off shows a stacked grid on mobile. |
| Section padding |
|---|
| Top padding | Slider 0–100px Default: 48px | |
| Bottom padding | Slider 0–100px Default: 48px | |
| Top padding (mobile) | Slider 0–100px Default: 36px | |
| Bottom padding (mobile) | Slider 0–100px Default: 36px | |
| Button |
|---|
| Button label | Text | Optional link below the rail (e.g. to a full collection). |
| Button link | Link | |
| Design |
|---|
| Heading weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase heading | On/off Default: Off | |
| Heading size (mobile) | Slider 14–44px Default: 22px | |
| Heading color | Color | |
| Section divider |
|---|
| Top divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Bottom divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Divider color | Color | Usually the color of the adjacent section/background. |
| Divider height | Slider 8–160px Default: 40px | |
| Width |
|---|
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Metafield source |
|---|
| Reads a list of products from a product metafield. Keep these matching your metafield definition. |
| Metafield namespace | Text Default: custom | Only change this if your product metafield uses a namespace other than custom. |
| Metafield key | Text Default: metafield_products | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Quick view
| Setting | Type | Notes |
|---|
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Related products
| Setting | Type | Notes |
|---|
| Dynamic recommendations use order and product information to change and improve over time. |
| Heading | Rich text (one line) Default: You may also like | |
| Heading font size | Slider 15–60px Default: 28px | |
| Heading alignment | Choice: Left, Center, Right Default: Left | |
| Heading alignment (mobile) | Choice: Same as desktop, Left, Center, Right Default: Same as desktop | |
| Description | Rich text | |
| Maximum products to show | Slider 2–10 Default: 4 | |
| Number of columns on desktop | Slider 2–6 Default: 4 | |
| Color scheme | Color scheme | |
| Enable quick add to cart | On/off Default: On | |
| Fill remaining slots with recommendations | On/off Default: On | When a product has fewer hand-picked related products (custom.related_picks) than the count above, top up the row with Shopify's automatic recommendations. Off = show only the curated picks. |
| Layout |
|---|
| Slider (carousel) view | On/off Default: Off | On: horizontal slider. Off: static grid. |
| Show slider counter | On/off Default: Off | |
| Auto-rotate slider | On/off Default: Off | |
| Auto-rotate speed | Slider 2–10s Default: 4s | |
| Enable swipe on mobile | On/off Default: On | Slider view only. Off shows a stacked grid on mobile. |
| Product card |
|---|
| Image ratio | Choice: Adapt to image, Portrait, Square Default: Adapt to image | |
| Image shape | Choice: 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 hover | On/off Default: Off | |
| Show vendor | On/off Default: Off | |
| Show rating on cards | On/off Default: Off | Shows stars when a product has a reviews rating metafield. |
| Quick add button style | Choice: Outline button, Solid button Default: Outline button | |
| Mobile Layout |
|---|
| Number of columns on mobile | Choice: 1 column, 2 columns Default: 2 columns | |
| Section padding |
|---|
| Top padding | Slider 0–100px Default: 48px | |
| Bottom padding | Slider 0–100px Default: 48px | |
| Top padding (mobile) | Slider 0–100px Default: 36px | |
| Bottom padding (mobile) | Slider 0–100px Default: 36px | |
| Design |
|---|
| Heading weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase heading | On/off Default: Off | |
| Heading size (mobile) | Slider 14–44px Default: 22px | |
| Heading color | Color | |
| Section divider |
|---|
| Top divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Bottom divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Divider color | Color | Usually the color of the adjacent section/background. |
| Divider height | Slider 8–160px Default: 40px | |
| Width |
|---|
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Pages and templates
404
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Heading | Text Default: 404 | |
| Message | Text | Leave blank for the translated default. |
| Button label | Text | Leave blank for the translated default. |
| Button style | Choice: Primary, Secondary Default: Primary | |
| Secondary button label | Text | |
| Secondary button link | Link | |
| Secondary button style | Choice: Primary, Secondary Default: Secondary | |
| Show search bar | On/off Default: On | |
| Live suggestions while typing | On/off Default: On | |
| Quick links heading | Text Default: Helpful links | Add Quick link blocks to show pills. |
| Image |
|---|
| Image or illustration | Image | |
| Layout | Choice: Image above text, Image beside text Default: Image above text | |
| Image width | Slider 120–700px Default: 360px | |
| Title style |
|---|
| Title size | Slider 40–160px Default: 96px | |
| Title size (mobile) | Slider 32–120px Default: 64px | |
| Title weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Bold | |
| Uppercase title | On/off Default: Off | |
| Title color | Color | |
| Product recovery |
|---|
| Show a product grid | On/off Default: On | |
| Heading | Text | Leave blank for the translated default. |
| Collection | Collection | |
| Products to show | Slider 2–12 Default: 4 | |
| Columns on desktop | Slider 2–5 Default: 4 | |
| Show quick add | On/off Default: Off | |
| Section padding |
|---|
| Top padding | Slider 0–160px Default: 64px | |
| Bottom padding | Slider 0–160px Default: 64px | |
| Padding top (mobile) | Slider 0–120px Default: 40px | |
| Padding bottom (mobile) | Slider 0–120px Default: 40px | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Blocks
Quick link
| Setting | Type | Notes |
|---|
| Label | Text Default: New arrivals | |
| Link | Link | |
Article
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Header |
|---|
| Header alignment | Choice: Left, Center, Right Default: Center | |
| Header alignment (mobile) | Choice: Same as desktop, Left, Center, Right Default: Same as desktop | |
| Show breadcrumbs | On/off Default: On | |
| Show "Back to blog" link | On/off Default: On | |
| Show date | On/off Default: On | |
| Show author | On/off Default: On | |
| Show reading time | On/off Default: On | |
| Show comment count | On/off Default: On | |
| Title size | Slider 24–96px Default: 48px | |
| Title size (mobile) | Slider 18–64px Default: 32px | |
| Title weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase title | On/off Default: Off | |
| Title letter spacing | Slider 0–4px Default: 0px | |
| Title color | Color | |
| Featured image |
|---|
| Hero layout | Choice: Title, then image, Image, then title, Title over image, Image beside title Default: Title, then image | |
| Show featured image | On/off Default: On | |
| Full-width featured image | On/off Default: Off | |
| Image shape | Choice: Original, Wide (16:9), Landscape (3:2), Classic (4:3) Default: Original | |
| Content |
|---|
| Content width | Slider 560–1000px Default: 760px | |
| Text size | Slider 0–24px Default: 0px | 0 = default. |
| Line height | Slider 0–2.4 Default: 0 | 0 = default. |
| Link color | Color | |
| Drop cap on the first paragraph | On/off Default: Off | |
| Table of contents | Choice: 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 bar | On/off Default: Off | |
| Show tags | On/off Default: On | |
| Show share button | On/off Default: On | |
| Share style | Choice: Share button, Network icons Default: Share button | |
| Show previous / next article | On/off Default: On | |
| Show author bio | On/off Default: On | Article metafield custom.author → Author metaobject. |
| Comments |
|---|
| Show comments | On/off Default: On | Also requires comments enabled in the blog's settings. |
| Related posts |
|---|
| Show related posts | On/off Default: On | |
| Number of posts | Slider 2–4 Default: 3 | |
| Image ratio | Choice: Landscape (3:2), Square (1:1), Portrait (3:4) Default: Landscape (3:2) | |
| Section padding |
|---|
| Top padding | Slider 0–100px Default: 40px | |
| Bottom padding | Slider 0–100px Default: 48px | |
| Padding top (mobile) | Slider 0–100px Default: 28px | |
| Padding bottom (mobile) | Slider 0–100px Default: 32px | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Also accepts: app blocks.
Blog posts
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Header |
|---|
| Header alignment | Choice: Left, Center, Right Default: Center | |
| Header alignment (mobile) | Choice: Same as desktop, Left, Center, Right Default: Same as desktop | |
| Intro text | Rich text | |
| Show tag filter bar | On/off Default: On | |
| Tags on mobile | Choice: Wrap onto lines, Scroll sideways, Dropdown Default: Scroll sideways | |
| Show RSS feed link | On/off Default: Off | |
| Title size | Slider 20–90px Default: 44px | |
| Title size (mobile) | Slider 16–60px Default: 30px | |
| Title weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase title | On/off Default: Off | |
| Title letter spacing | Slider 0–4px Default: 0px | |
| Title color | Color | |
| Featured post |
|---|
| Highlight newest post | On/off Default: On | Large hero card on page 1 (hidden when a tag is selected). |
| Featured article | Article | Leave empty to feature the newest post. |
| Featured style | Choice: Image left, Image right, Text over image Default: Image left | |
| Article grid |
|---|
| Layout | Choice: Grid, List (image beside text), Magazine (lead story + grid) Default: Grid | |
| Posts per page | Slider 6–24 Default: 12 | |
| Columns on desktop | Slider 2–4 Default: 3 | |
| Columns on mobile | Choice: 1, 2 Default: 1 | |
| Image ratio | Choice: Landscape (3:2), Square (1:1), Portrait (3:4), Natural Default: Landscape (3:2) | |
| Column gap | Slider 0–60px Default: 16px | |
| Row gap | Slider 0–80px Default: 40px | |
| Article cards |
|---|
| Card style | Choice: Plain, Bordered, Text over image Default: Plain | |
| Zoom image on hover | On/off Default: On | |
| Show date | On/off Default: On | |
| Show reading time | On/off Default: Off | |
| Show tag on cards | On/off Default: On | |
| Show author on cards | On/off Default: On | |
| Show excerpt on cards | On/off Default: On | |
| Excerpt length (words) | Slider 8–60 Default: 22 | |
| Show "Read more" | On/off Default: On | |
| Pagination | Choice: Numbered pages, Load more button, Infinite scroll Default: Numbered pages | |
| Section padding |
|---|
| Top padding | Slider 0–100px Default: 48px | |
| Bottom padding | Slider 0–100px Default: 48px | |
| Padding top (mobile) | Slider 0–100px Default: 32px | |
| Padding bottom (mobile) | Slider 0–100px Default: 32px | |
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Also accepts: app blocks.
Cart
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Layout |
|---|
| Layout | Choice: Items + order summary (2 columns), Stacked (1 column) Default: Items + order summary (2 columns) | |
| Sticky order summary | On/off Default: On | Keeps the summary in view while scrolling (2-column layout, desktop). |
| Show "Continue shopping" link | On/off Default: On | |
| Order summary style | Choice: Bordered card, Plain, Tinted panel Default: Bordered card | |
| Order summary background | Color | |
| Sticky checkout bar on mobile | On/off Default: Off | Keeps the subtotal and checkout button in view on phones. |
| Line items |
|---|
| Image size | Slider 60–160px Default: 90px | |
| Show original price next to each item price | On/off Default: Off | |
| Show "You save" per item | On/off Default: Off | |
| Remove button | Choice: Text link, Trash icon Default: Text link | |
| Discounts and shipping |
|---|
| Show discount code field | On/off Default: Off | |
| Show shipping estimator | On/off Default: Off | Uses your Shopify shipping rates. The first estimate can take a few seconds. |
| Checkout |
|---|
| Checkout button label | Text | Leave blank for the theme default. |
| Show express checkout buttons | On/off Default: On | Shop Pay, PayPal, Apple Pay and others, when enabled in Payments. |
| Require terms agreement | On/off Default: Off | |
| Terms label | Rich text (one line) | Leave blank for the default. Link your terms page here. |
| Empty cart |
|---|
| Empty cart heading | Text | Leave blank for the theme default. |
| Suggested collection | Collection | Shows 4 products when the cart is empty. |
| Title |
|---|
| Header alignment | Choice: Left, Center, Right Default: Left | |
| Title size | Slider 18–80px Default: 40px | |
| Title size (mobile) | Slider 16–60px Default: 28px | |
| Title weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase title | On/off Default: Off | |
| Title letter spacing | Slider 0–4px Default: 0px | |
| Title color | Color | |
| Trust and payment |
|---|
| Show trust block | On/off Default: On | |
| Secure checkout text | Text Default: Secure checkout — encrypted & protected | |
| Show accepted payment icons | On/off Default: On | |
| Recommendations |
|---|
| Show "You might also like" | On/off Default: On | |
| Heading | Text Default: You might also like | |
| Number of products | Slider 2–6 Default: 4 | |
| Section padding |
|---|
| Top padding | Slider 0–100px Default: 48px | |
| Bottom padding | Slider 0–100px Default: 48px | |
| Padding top (mobile) | Slider 0–100px Default: 32px | |
| Padding bottom (mobile) | Slider 0–100px Default: 32px | |
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Also accepts: app blocks.
Blocks
Trust item
| Setting | Type | Notes |
|---|
| Icon (emoji) | Text Default: 🚚 | |
| Text | Text Default: Free returns within 30 days | |
Collection navigation
| Setting | Type | Notes |
|---|
| Show | Choice: 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. |
| Menu | Menu | The current collection is looked up in this menu; its sub-items are shown, or its siblings if it has none. |
| Collections | Collections | |
| Heading | Text | |
| Style | Choice: Pills, Round images, Image cards, Text links Default: Pills | |
| Image size | Slider 48–200px Default: 88px | |
| Show product count | On/off Default: Off | For metafield and picked collections. |
| Alignment | Choice: Left, Center Default: Left | |
| Swipe on mobile | On/off Default: On | |
| Color scheme | Color scheme | |
| Top padding | Slider 0–80px Default: 16px | |
| Bottom padding | Slider 0–80px Default: 16px | |
List collections
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Header |
|---|
| Header alignment | Choice: Left, Center, Right Default: Left | |
| Heading | Rich text (one line) Default: Collections | |
| Heading font size | Slider 15–100px Default: 40px | |
| Heading font size (mobile) | Slider 14–64px Default: 28px | |
| Heading weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase heading | On/off Default: Off | |
| Heading letter spacing | Slider 0–4px Default: 0px | |
| Heading color | Color | |
| Description | Rich text (one line) Default: Browse every collection in the store. | |
| Description style | Choice: Subtitle, Uppercase Default: Subtitle | |
| Collections to show |
|---|
| Show | Choice: All collections, Selected collections Default: All collections | |
| Collections | Collections | Shown in this order. Used when "Selected collections" is chosen. |
| Hide empty collections | On/off Default: Off | |
| Exclude collections | Text | Comma-separated handles, e.g. frontpage, all |
| Collections per page | Slider 12–50 Default: 48 | All collections mode. Sorting applies within each page. |
| Layout |
|---|
| Layout | Choice: 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 style | Choice: Names only, Names with thumbnails Default: Names only | |
| Gap (desktop) | Slider 0–60px Default: 16px | |
| Gap (mobile) | Slider 0–32px Default: 16px | |
| Cards |
|---|
| Card style | Choice: Text below image, Text over image Default: Text below image | |
| Show product count | On/off Default: On | |
| Image overlay | Slider 0–90% Default: 30% | |
| Overlay text color | Color Default: #ffffff | |
| Overlay text position | Choice: Top, Middle, Bottom Default: Bottom | |
| Zoom image on hover | On/off Default: Off | |
| Image corner radius | Slider 0–40px Default: 0px | 0 = theme default. |
| Show description excerpt | On/off Default: Off | Below-image style only. |
| Call to action | Text | e.g. "Shop now". Leave blank to hide. |
| Sort collections by | Choice: 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 ratio | Choice: Adapt to image, Portrait, Square, Landscape, Circle Default: Portrait | Add images by editing your collections. |
| Number of columns on desktop | Slider 1–5 Default: 3 | |
| Mobile Layout |
|---|
| Number of columns on mobile | Choice: 1 column, 2 columns Default: 2 columns | |
| Section padding |
|---|
| Top padding | Slider 0–100px Default: 48px | |
| Bottom padding | Slider 0–100px Default: 48px | |
| Padding top (mobile) | Slider 0–100px Default: 32px | |
| Padding bottom (mobile) | Slider 0–100px Default: 32px | |
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Page
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Header |
|---|
| Show page title | On/off Default: On | |
| Show breadcrumbs | On/off Default: On | Above the title. With a banner, use "Show breadcrumbs in banner" below. |
| Header alignment | Choice: Left, Center, Right Default: Center | |
| Subtitle | Rich text (one line) | Per page: a page metafield custom.subtitle overrides this. |
| Subtitle size | Slider 0–28px Default: 0px | 0 = default. |
| Subtitle color | Color | |
| Under the title show | Choice: Nothing, Published date, Reading time, Date and reading time Default: Nothing | |
| Divider under the header | On/off Default: Off | |
| Title size | Slider 20–90px Default: 44px | |
| Title size (mobile) | Slider 16–60px Default: 30px | |
| Title weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase title | On/off Default: Off | |
| Title letter spacing | Slider 0–4px Default: 0px | |
| Title color | Color | |
| 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 title | On/off Default: Off | |
| Banner image | Image | Set a focal point on the image to control cropping. |
| Mobile banner image | Image | Optional. Used below 750px. |
| Banner height | Slider 160–640px Default: 320px | |
| Text position | Choice: Top, Middle, Bottom Default: Middle | |
| Banner overlay | Slider 0–90% Default: 35% | |
| Overlay color | Color Default: #000000 | |
| Banner text color | Color Default: #ffffff | |
| Show breadcrumbs in banner | On/off Default: Off | |
| Content |
|---|
| Constrain content width (recommended for reading) | On/off Default: On | |
| Content width | Slider 560–1100px Default: 820px | |
| Text size | Slider 0–22px Default: 0px | 0 = default. |
| Line height | Slider 0–2.4 Default: 0 | 0 = default. |
| Link color | Color | |
| Image corner radius | Slider 0–30px Default: 0px | |
| Table of contents |
|---|
| Table of contents | Choice: 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. |
| Title | Text Default: On this page | |
| Include | Choice: Main headings (H2), Headings and subheadings (H2 + H3) Default: Main headings (H2) | |
| Section padding |
|---|
| Top padding | Slider 0–120px Default: 40px | |
| Bottom padding | Slider 0–120px Default: 56px | |
| Padding top (mobile) | Slider 0–120px Default: 28px | |
| Padding bottom (mobile) | Slider 0–120px Default: 40px | |
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Also accepts: app blocks.
Password
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Heading | Rich text (one line) Default: Opening soon | |
| Text | Rich text | |
| Logo width | Slider 60–400px Default: 150px | Uses the logo from Theme settings. |
| Title style |
|---|
| Heading size | Slider 18–80px Default: 40px | |
| Heading size (mobile) | Slider 16–60px Default: 30px | |
| Heading weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase heading | On/off Default: Off | |
| Layout and background |
|---|
| Layout | Choice: Centered, Split (image beside content), Full-screen background Default: Centered | |
| Background image | Image | |
| Mobile background image | Image | Optional. Used below 750px. |
| Image overlay | Slider 0–90% Default: 40% | |
| Text color over image | Color Default: #ffffff | |
| Content card | Choice: None, Solid panel, Frosted glass Default: None | Keeps text readable over busy images. |
| Launch countdown |
|---|
| Launch date | Text | YYYY-MM-DD HH:MM, e.g. 2026-11-01 09:00. Leave blank to hide. Hides itself at zero. |
| Timezone offset | Text Default: +00:00 | e.g. +05:30 for India. |
| Countdown label | Text Default: Launching in | |
| Notify me signup |
|---|
| Show email signup | On/off Default: On | When off, the password form is shown open. |
| Signup heading | Text Default: Be the first to know when we launch. | |
| Signup button label | Text Default: Notify me | |
| Success message | Text | Leave blank for the theme default. |
| Consent note | Rich text (one line) | e.g. "We'll only email you about our launch." with a privacy link. |
| Social |
|---|
| Show social icons | On/off Default: On | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Product grid
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Show collection description | On/off Default: On | Long descriptions can sit below the grid and be trimmed with Read more. |
| Description position | Choice: 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 lines | Slider 0–12 Default: 0 | 0 = show in full. Longer text gets a Read more toggle. |
| Collection header / banner |
|---|
| Use collection image as banner | On/off Default: Off | Shows the collection featured image behind the title. |
| Fallback banner image | Image | Used for collections without their own image. Set a focal point to control cropping. |
| Banner height | Slider 160–640px Default: 320px | |
| Banner text align | Choice: Left, Center, Right Default: Center | |
| Banner overlay | Slider 0–90% Default: 35% | |
| Banner text color | Color | |
| Title size | Slider 18–80px Default: 40px | |
| Title size (mobile) | Slider 16–60px Default: 28px | |
| Title weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase title | On/off Default: Off | |
| Title letter spacing | Slider 0–4px Default: 0px | |
| Title color | Color | |
| Breadcrumbs are controlled in Theme settings → Breadcrumbs. |
| Filtering and sorting |
|---|
| Enable filtering | On/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 filters | On/off Default: On | Keeps the sidebar in view while scrolling (Sidebar layout only). |
| Enable quick add | On/off Default: On | |
| Products per page | Slider 8–48 Default: 16 | |
| Columns on desktop | Slider 2–6 Default: 4 | |
| Columns on mobile | Choice: 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 switcher | Choice: 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 ratio | Choice: Use theme setting, Square, Portrait, Match image Default: Use theme setting | |
| Second image on hover | Choice: Use theme setting, On, Off Default: Use theme setting | |
| Star rating | Choice: Use theme setting, Show, Hide Default: Use theme setting | |
| Quick add button | Choice: Outline, Solid, Icon only Default: Outline | |
| Pagination style | Choice: Page numbers, Load more button, Infinite scroll Default: Page numbers | |
| Show "Showing X of Y" progress | On/off Default: On | Load more and infinite scroll. |
| Section padding |
|---|
| Top padding | Slider 0–100px Default: 48px | Space above the title (below the breadcrumbs). |
| Bottom padding | Slider 0–100px Default: 48px | |
| Padding top (mobile) | Slider 0–100px Default: 32px | |
| Padding bottom (mobile) | Slider 0–100px Default: 32px | |
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Also accepts: app blocks.
Blocks
In-grid promo
| Setting | Type | Notes |
|---|
| Inserts a promo tile into the product grid after the chosen product position. |
| Insert after product # | Slider 1–48 Default: 4 | |
| Desktop column span | Slider 1–3 Default: 2 | |
| Desktop height | Choice: One row, Two rows Default: One row | |
| Width on mobile | Choice: 1 column, 2 columns Default: 2 columns | |
| Show on the first page only | On/off Default: Off | |
| Image | Image | |
| Heading | Text Default: Sale | |
| Text | Text | |
| Button label | Text | |
| Link | Link | |
| Image overlay | Slider 0–90% Default: 25% | |
| Text color | Color | |
Search
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Search box |
|---|
| Search placeholder | Text Default: Search products, articles… | |
| Show live suggestions while typing | On/off Default: On | Uses the same predictive search as the header (Theme settings > Search). |
| Default results tab | Choice: Products, Everything Default: Products | |
| Landing text (before searching) | Text Default: Type above to search the store. | |
| Show Articles tab | On/off Default: On | |
| Show Pages tab | On/off Default: On | |
| Title |
|---|
| Header alignment | Choice: Left, Center, Right Default: Left | |
| Results title | Text Default: Results for “[terms]” | [terms] = what the shopper searched for. |
| Title size | Slider 18–80px Default: 40px | |
| Title size (mobile) | Slider 16–60px Default: 28px | |
| Title weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase title | On/off Default: Off | |
| Title letter spacing | Slider 0–4px Default: 0px | |
| Title color | Color | |
| Results |
|---|
| "All" tab layout | Choice: Mixed grid, Grouped by type Default: Mixed grid | Grouped shows products, then articles, then pages, each with a See all link. |
| Highlight matched words | On/off Default: On | |
| Enable filtering (products) | On/off Default: On | Filters appear on the Products tab when your store has search filters set up. |
| Sticky sidebar filters | On/off Default: On | |
| Filter layout (desktop) | Choice: Sidebar, Horizontal, Drawer Default: Sidebar | |
| Enable quick add | On/off Default: On | |
| Quick add button | Choice: Outline, Solid, Icon only Default: Outline | |
| Results per page | Slider 8–48 Default: 16 | |
| Columns on desktop | Slider 2–5 Default: 4 | |
| Columns on mobile | Choice: 1, 2 Default: 2 | |
| Gap between products (desktop) | Slider 0–48px Default: 16px | |
| Card image ratio | Choice: Use theme setting, Square, Portrait, Match image Default: Use theme setting | |
| Card star rating | Choice: Use theme setting, Show, Hide Default: Use theme setting | |
| Pagination (products) | Choice: Numbered pages, Load more button, Infinite scroll Default: Numbered pages | Applies to the Products tab and the mixed All/Articles/Pages views. |
| No / empty results |
|---|
| Popular searches heading | Text Default: Popular searches | |
| Popular searches open | Choice: Product results, All results Default: Product results | |
| Suggested products heading | Text Default: You may like | |
| Suggested products collection | Collection | |
| Also show suggested products before a search | On/off Default: Off | |
| Section padding |
|---|
| Top padding | Slider 0–100px Default: 48px | |
| Bottom padding | Slider 0–100px Default: 48px | |
| Padding top (mobile) | Slider 0–100px Default: 32px | |
| Padding bottom (mobile) | Slider 0–100px Default: 32px | |
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Also accepts: app blocks.
Blocks
Popular search
| Setting | Type | Notes |
|---|
| Search term | Text Default: Best sellers | |
Cart and pop-ups
Cart drawer
| Setting | Type | Notes |
|---|
| 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 |
|---|
| Width | Slider 320–560px Default: 420px | |
| Slide from | Choice: Right, Left Default: Right | |
| Panel corner radius | Slider 0–32px Default: 0px | Rounds the inner edge of the drawer. |
| Full width on mobile | On/off Default: Off | |
| Overlay color | Color Default: #000000 | |
| Overlay opacity | Slider 0–90% Default: 40% | |
| Open animation | Choice: Slide, Fade Default: Slide | |
| Animation speed | Slider 100–600ms Default: 250ms | |
| Header |
|---|
| Show item count in title | On/off Default: On | |
| Header divider line | On/off Default: On | |
| Footer |
|---|
| Show "Continue shopping" link | On/off Default: Off | |
| Express checkout label | Text | Shown above the dynamic checkout buttons. Leave blank to hide. |
| Show payment icons | On/off Default: On | Renders the payment methods enabled on your store. |
| Show secure-checkout note | On/off Default: Off | |
| Secure-checkout text | Text Default: Secure checkout | |
| Empty state |
|---|
| Show products when cart is empty | On/off Default: Off | |
| Empty-state heading | Text Default: Popular right now | |
| Empty-state collection | Collection | Used when "Show products when cart is empty" is on. |
| Advanced |
|---|
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Cart recommendations
| Setting | Type | Notes |
|---|
| 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 style | Choice: Outline, Solid Default: Outline | |
| Add button label | Text | Leave blank for the default "Add to cart". |
| Show price | On/off Default: On | |
| Show compare-at (sale) price | On/off Default: On | |
| Show vendor | On/off Default: Off | |
| Show rating stars | On/off Default: Off | |
| Image shape | Choice: Square, Rounded, Circle Default: Rounded | |
| Image size | Slider 48–96px Default: 60px | |
Content sections
Alternating rows
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Heading | Rich text (one line) | |
| Heading size | Slider 15–80px Default: 36px | |
| Heading alignment | Choice: Left, Center, Right Default: Center | |
| Heading alignment (mobile) | Choice: Same as desktop, Left, Center, Right Default: Same as desktop | |
| Alternate image sides | On/off Default: On | |
| Image ratio (w/h) | Slider 0.6–1.6 Default: 1.2 | |
| Image column width | Slider 30–70% Default: 50% | Desktop only. 50 = equal columns. |
| Row vertical alignment | Choice: 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 alignment | Choice: Left, Center, Right Default: Left | |
| Text alignment (mobile) | Choice: Same as desktop, Left, Center, Right Default: Same as desktop | |
| Background | Color | |
| Padding |
|---|
| Top | Slider 0–120px Default: 48px | |
| Bottom | Slider 0–120px Default: 48px | |
| Padding top (mobile) | Slider 0–120px Default: 48px | |
| Padding bottom (mobile) | Slider 0–120px Default: 48px | |
| Design |
|---|
| Heading color | Color | |
| Heading weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase heading | On/off Default: Off | |
| Heading letter spacing | Slider 0–4px Default: 0px | |
| Heading size (mobile) | Slider 14–60px Default: 28px | |
| Body text color | Color | |
| Hide on mobile | On/off Default: Off | |
| Hide on desktop | On/off Default: Off | |
| Section divider |
|---|
| Top divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Bottom divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Divider color | Color | Usually the color of the adjacent section/background. |
| Divider height | Slider 8–160px Default: 40px | |
| Divider height (mobile) | Slider 8–160px Default: 24px | |
| Width |
|---|
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Also accepts: theme blocks, app blocks.
Blocks
Row
| Setting | Type | Notes |
|---|
| Image | Image | |
| Caption | Text | |
| Heading | Text Default: Row heading | |
| Heading size | Slider 0–60px Default: 0px | 0 = theme default. |
| Heading size (mobile) | Slider 0–48px Default: 0px | 0 = same as desktop. |
| Text | Rich text | |
| Body text size | Slider 0–32px Default: 0px | 0 = theme default. |
| Body text size (mobile) | Slider 0–28px Default: 0px | 0 = same as desktop. |
| Collapsible heading | Text | |
| Collapsible content | Rich text | |
| Button label | Text | |
| Button link | Link | |
| Link style | Choice: Solid button, Outline button, Text link Default: Outline button | |
Apps
| Setting | Type | Notes |
|---|
| Add app blocks from any installed app. Each app controls its own content. |
| Match the theme's page width | On/off Default: On | |
| Width | Choice: Standard, Wide Default: Standard | |
| Color scheme | Color scheme | |
| Spacing |
|---|
| Top padding | Slider 0–120px Default: 36px | |
| Bottom padding | Slider 0–120px Default: 36px | |
| Top padding (mobile) | Slider 0–120px Default: 28px | |
| Bottom padding (mobile) | Slider 0–120px Default: 28px | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Also accepts: app blocks.
Before/after slider
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Heading | Rich text (one line) Default: Before & after | |
| Heading size | Slider 15–80px Default: 36px | |
| Heading alignment | Choice: Left, Center, Right Default: Center | |
| Heading alignment (mobile) | Choice: Same as desktop, Left, Center, Right Default: Same as desktop | |
| Before image | Image | |
| After image | Image | |
| Before label | Text Default: Before | |
| After label | Text Default: After | |
| Label style | Choice: Solid, Pill, Outline, Minimal (text only) Default: Solid | |
| Label position | Choice: Bottom, Top Default: Bottom | |
| Start position | Slider 0–100% Default: 50% | |
| Image ratio | Choice: 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 width | On/off Default: Off | |
| Slider position | Choice: 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 direction | Choice: Horizontal (left / right), Vertical (up / down) Default: Horizontal (left / right) | |
| Handle style | Choice: Round knob, Bar, Line only Default: Round knob | |
| Handle size | Slider 28–72px Default: 44px | |
| Divider thickness | Slider 1–8px Default: 3px | |
| Handle and divider color | Color Default: #ffffff | |
| Animate on scroll | On/off Default: On | The divider sweeps once when the section scrolls into view (respects reduced-motion). |
| Hint text | Text Default: Drag to compare | Small prompt over the image that fades on first interaction. Leave blank to hide. |
| Padding |
|---|
| Top padding | Slider 0–120px Default: 48px | |
| Bottom padding | Slider 0–120px Default: 48px | |
| Padding top (mobile) | Slider 0–120px Default: 48px | |
| Padding bottom (mobile) | Slider 0–120px Default: 48px | |
| Design |
|---|
| Heading color | Color | |
| Heading weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase heading | On/off Default: Off | |
| Heading size (mobile) | Slider 14–60px Default: 28px | |
| Body text color | Color | |
| Hide on mobile | On/off Default: Off | |
| Hide on desktop | On/off Default: Off | |
| Section divider |
|---|
| Top divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Bottom divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Divider color | Color | Usually the color of the adjacent section/background. |
| Divider height | Slider 8–160px Default: 40px | |
| Width |
|---|
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Also accepts: theme blocks, app blocks.
Blocks
Caption
| Setting | Type | Notes |
|---|
| Caption | Text Default: Before & after | |
| Style | Choice: Subtitle, Uppercase Default: Uppercase | |
Text
| Setting | Type | Notes |
|---|
| Text | Rich text | |
Button
| Setting | Type | Notes |
|---|
| Button label | Text Default: Shop now | |
| Button link | Link | |
| Button style | Choice: Primary, Secondary Default: Primary | |
Blog posts
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Heading | Rich text (one line) Default: Blog posts | |
| Heading size | Slider 15–80px Default: 36px | |
| Heading alignment | Choice: Left, Center Default: Center | |
| Blog | Blog | |
| Posts to show | Slider 2–6 Default: 3 | |
| Columns on desktop | Slider 1–5 Default: 3 | |
| Columns on mobile | Choice: 1 column, 2 columns Default: 1 column | |
| Show featured image | On/off Default: On | |
| Show date | On/off Default: On | |
| Show author | On/off Default: Off | |
| Show excerpt | On/off Default: Off | |
| Show 'View all' | On/off Default: On | |
| Padding |
|---|
| Top | Slider 0–120px Default: 48px | |
| Bottom | Slider 0–120px Default: 48px | |
| Padding top (mobile) | Slider 0–120px Default: 48px | |
| Padding bottom (mobile) | Slider 0–120px Default: 48px | |
| Design |
|---|
| Heading color | Color | |
| Heading weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase heading | On/off Default: Off | |
| Heading letter spacing | Slider 0–4px Default: 0px | |
| Heading size (mobile) | Slider 14–60px Default: 28px | |
| Body text color | Color | |
| Hide on mobile | On/off Default: Off | |
| Hide on desktop | On/off Default: Off | |
| Section divider |
|---|
| Top divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Bottom divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Divider color | Color | Usually the color of the adjacent section/background. |
| Divider height | Slider 8–160px Default: 40px | |
| Divider height (mobile) | Slider 8–160px Default: 24px | |
| Width |
|---|
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Also accepts: theme blocks, app blocks.
Collapsible content
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Caption | Text | |
| Heading | Rich 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 source | Text 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 keys | Text | Only if your definition uses other field keys: question=your_key, answer=your_key. Fields read: question, answer. |
| Heading size | Slider 15–80px Default: 32px | |
| Heading alignment | Choice: Left, Center, Right Default: Left | |
| Heading alignment (mobile) | Choice: Same as desktop, Left, Center, Right Default: Same as desktop | |
| Toggle icon | Choice: Plus / minus, Chevron, Caret (triangle) Default: Plus / minus | |
| Answer text size | Slider 0–24px Default: 0px | 0 = theme default. |
| Answer text size (mobile) | Slider 0–22px Default: 0px | 0 = same as desktop. |
| Open first item by default | On/off Default: On | |
| Side image (optional) | Image | |
| Image position (desktop) | Choice: Left, Right Default: Left | |
| Link label | Text | |
| Link | Link | |
| Background | Color | |
| Padding |
|---|
| Top | Slider 0–120px Default: 48px | |
| Bottom | Slider 0–120px Default: 48px | |
| Padding top (mobile) | Slider 0–120px Default: 48px | |
| Padding bottom (mobile) | Slider 0–120px Default: 48px | |
| Design |
|---|
| Heading color | Color | |
| Heading weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase heading | On/off Default: Off | |
| Heading letter spacing | Slider 0–4px Default: 0px | |
| Heading size (mobile) | Slider 14–60px Default: 28px | |
| Body text color | Color | |
| Hide on mobile | On/off Default: Off | |
| Hide on desktop | On/off Default: Off | |
| Section divider |
|---|
| Top divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Bottom divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Divider color | Color | Usually the color of the adjacent section/background. |
| Divider height | Slider 8–160px Default: 40px | |
| Divider height (mobile) | Slider 8–160px Default: 24px | |
| Width |
|---|
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Also accepts: theme blocks, app blocks.
Blocks
Row
| Setting | Type | Notes |
|---|
| Heading | Text Default: Question | |
| Content | Rich text | |
| Page | Page | Optional. Pulls the row content from a page instead. |
Collection tabs
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Heading | Rich text (one line) Default: Shop by category | |
| Heading size | Slider 15–80px Default: 36px | |
| Heading alignment | Choice: Left, Center, Right Default: Center | |
| Heading alignment (mobile) | Choice: Same as desktop, Left, Center, Right Default: Same as desktop | |
| Description | Rich text | |
| Products per tab | Slider 2–24 Default: 8 | |
| Columns per view (desktop) | Slider 2–6 Default: 4 | |
| Columns on mobile | Choice: 1 column, 2 columns Default: 2 columns | |
| Show 'View all' | On/off Default: On | |
| Show vendor | On/off Default: Off | |
| Enable quick add | On/off Default: On | |
| Quick add style | Choice: Outline, Solid Default: Outline | |
| Design |
|---|
| Heading color | Color | |
| Heading weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase heading | On/off Default: Off | |
| Heading letter spacing | Slider 0–4px Default: 0px | |
| Heading size (mobile) | Slider 14–60px Default: 28px | |
| Body text color | Color | |
| Hide on mobile | On/off Default: Off | |
| Hide on desktop | On/off Default: Off | |
| Padding |
|---|
| Top | Slider 0–100px Default: 48px | |
| Bottom | Slider 0–100px Default: 48px | |
| Padding top (mobile) | Slider 0–120px Default: 48px | |
| Padding bottom (mobile) | Slider 0–120px Default: 48px | |
| Section divider |
|---|
| Top divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Bottom divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Divider color | Color | Usually the color of the adjacent section/background. |
| Divider height | Slider 8–160px Default: 40px | |
| Divider height (mobile) | Slider 8–160px Default: 24px | |
| Width |
|---|
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Blocks
Tab
| Setting | Type | Notes |
|---|
| Collection | Collection | |
Collection tiles
| Setting | Type | Notes |
|---|
| Layout | Choice: 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 scheme | Color scheme | |
| Heading | Rich text (one line) Default: Collections | |
| Heading size | Slider 15–80px Default: 36px | |
| Heading alignment | Choice: Left, Center Default: Left | |
| Heading color | Color | |
| Grid layout |
|---|
| Image ratio | Choice: Portrait, Square, Landscape Default: Square | |
| Columns (desktop) | Slider 2–6 Default: 4 | |
| Columns (mobile) | Choice: 1, 2 Default: 2 | |
| Swipe on mobile | On/off Default: Off | |
| Show 'View all' button | On/off Default: Off | |
| Mosaic layout |
|---|
| Row height (desktop) | Slider 120–400px Default: 220px | |
| Row height (mobile) | Slider 80–300px Default: 160px | |
| Gap | Slider 0–32px Default: 12px | |
| Ribbon layout |
|---|
| Menu (optional source) | Menu | If set, ribbon items come from this menu's links. Otherwise the tile blocks below are used. |
| Item alignment | Choice: Left, Center Default: Center | |
| Image shape | Choice: Circle, Rounded, Square Default: Circle | |
| Media background | Choice: 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 ratio | Choice: 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 position | Choice: Left, Right, Alternate Default: Alternate | |
| Image width | Slider 30–70% Default: 50% | |
| Image ratio | Choice: 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 height | Slider 200–700px Default: 360px | |
| Overlay darkness | Slider 0–80% Default: 35% | |
| Text position | Choice: Left, Center, Right Default: Center | |
| Masonry layout |
|---|
| Columns (desktop) | Slider 2–5 Default: 3 | |
| Columns (mobile) | Slider 1–3 Default: 2 | |
| Gap | Slider 0–32px Default: 12px | |
| Image ratio | Choice: 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 height | Slider 200–600px Default: 340px | |
| Gap | Slider 0–32px Default: 16px | |
| Tile border (mosaic and ribbon) |
|---|
| Corner radius | Slider 0–40px Default: 8px | |
| Border thickness | Slider 0–8px Default: 0px | |
| Design |
|---|
| Heading weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase heading | On/off Default: Off | |
| Heading letter spacing | Slider 0–4px Default: 0px | |
| Heading size (mobile) | Slider 14–60px Default: 28px | |
| Body text color | Color | |
| Zoom image on hover | On/off Default: Off | |
| Hide on mobile | On/off Default: Off | |
| Hide on desktop | On/off Default: Off | |
| Section padding |
|---|
| Padding top | Slider 0–100px Default: 48px | |
| Padding bottom | Slider 0–100px Default: 48px | |
| Padding top (mobile) | Slider 0–120px Default: 48px | |
| Padding bottom (mobile) | Slider 0–120px Default: 48px | |
| Section divider |
|---|
| Top divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Bottom divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Divider color | Color | Usually the color of the adjacent section/background. |
| Divider height | Slider 8–160px Default: 40px | |
| Divider height (mobile) | Slider 8–160px Default: 24px | |
| Width |
|---|
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Blocks
Collection tile
| Setting | Type | Notes |
|---|
| Collection | Collection | |
| 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
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Heading | Rich text (one line) Default: Contact us | |
| Intro text | Rich text | |
| Heading size | Slider 15–80px Default: 36px | |
| Heading alignment | Choice: Left, Center Default: Center | |
| Form width | Slider 400–1000px Default: 640px | Applies to the single-column layout only. |
| Layout |
|---|
| Layout | Choice: Form only, Form + contact info Default: Form only | |
| Info panel position | Choice: Left of form, Right of form Default: Right of form | |
| Form fields |
|---|
| Show phone field | On/off Default: On | |
| Show subject field | On/off Default: Off | |
| Subject label | Text Default: Subject | |
| Require message field | On/off Default: On | |
| Show consent checkbox | On/off Default: Off | |
| Consent text | Text Default: I agree to be contacted regarding my enquiry. | |
| Success message | Text Default: Thanks for reaching out. We will be in touch soon. | |
| Contact info panel |
|---|
| Info heading | Text Default: Get in touch | |
| Info text | Rich text | |
| Show social icons | On/off Default: On | |
| Map display | Choice: None, Static image, Interactive embed Default: Static image | |
| Map / location image | Image | |
| Map / location link | Link | |
| Map embed | Text (multi-line) | Paste the Google Maps "Embed a map" iframe code (or just its src URL). |
| Padding |
|---|
| Top | Slider 0–120px Default: 48px | |
| Bottom | Slider 0–120px Default: 48px | |
| Padding top (mobile) | Slider 0–120px Default: 48px | |
| Padding bottom (mobile) | Slider 0–120px Default: 48px | |
| Design |
|---|
| Heading color | Color | |
| Heading weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase heading | On/off Default: Off | |
| Heading letter spacing | Slider 0–4px Default: 0px | |
| Heading size (mobile) | Slider 14–60px Default: 28px | |
| Body text color | Color | |
| Hide on mobile | On/off Default: Off | |
| Hide on desktop | On/off Default: Off | |
| Section divider |
|---|
| Top divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Bottom divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Divider color | Color | Usually the color of the adjacent section/background. |
| Divider height | Slider 8–160px Default: 40px | |
| Width |
|---|
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Also accepts: theme blocks, app blocks.
Blocks
Info item
| Setting | Type | Notes |
|---|
| Icon | Choice: None, Emoji (custom), Location pin, Phone, Email, Clock, Chat Default: Location pin | |
| Emoji | Text Default: 📍 | Used when Icon is set to "Emoji". |
| Label | Text Default: Address | |
| Text | Text Default: 123 Market St, Suite 100 | |
| Link (optional) | Link | |
Business hours
| Setting | Type | Notes |
|---|
| Label | Text Default: Opening hours | |
| Hours | Rich text | |
Text / note
| Setting | Type | Notes |
|---|
| Text | Rich text | |
Custom Liquid
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Custom Liquid | Liquid | Add app snippets or custom code. |
| Full width | On/off Default: Off | |
| Padding |
|---|
| Top | Slider 0–120px Default: 24px | |
| Bottom | Slider 0–120px Default: 24px | |
| Padding top (mobile) | Slider 0–120px Default: 24px | |
| Padding bottom (mobile) | Slider 0–120px Default: 24px | |
| Section divider |
|---|
| Top divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Bottom divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Divider color | Color | Usually the color of the adjacent section/background. |
| Divider height | Slider 8–160px Default: 40px | |
| Divider height (mobile) | Slider 8–160px Default: 24px | |
| Width |
|---|
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Custom section
| Setting | Type | Notes |
|---|
| Add Group blocks to make columns, then fill them with any block. |
| Blocks | Choice: Stacked, Side by side Default: Stacked | |
| Gap between blocks | Slider 0–80px Default: 24px | |
| Color scheme | Color scheme | |
| Background image | Image | |
| Background overlay | Slider 0–90% Default: 30% | |
| Width | Choice: Standard, Wide, Full width Default: Standard | |
| Spacing |
|---|
| Top padding | Slider 0–160px Default: 64px | |
| Bottom padding | Slider 0–160px Default: 64px | |
| Top padding (mobile) | Slider 0–120px Default: 40px | |
| Bottom padding (mobile) | Slider 0–120px Default: 40px | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Also accepts: theme blocks, app blocks.
Discount ribbon
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Heading | Rich text (one line) | |
| Heading size | Slider 15–70px Default: 30px | |
| Heading size (mobile) | Slider 14–50px Default: 24px | |
| Heading weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Intro text | Rich text | |
| Heading alignment | Choice: Left, Center, Right Default: Center | |
| Heading alignment (mobile) | Choice: Same as desktop, Left, Center, Right Default: Same as desktop | |
| Layout |
|---|
| Columns on desktop | Slider 1–5 Default: 3 | |
| Columns on mobile | Choice: 1 column, 2 columns Default: 1 column | |
| Gap between tiles | Slider 0–40px Default: 16px | |
| Image ratio | Choice: Adapt to image, Wide (2.2:1), Landscape (3:2), Square (1:1), Portrait (3:4) Default: Landscape (3:2) | |
| Corner radius | Slider 0–40px Default: 12px | |
| Zoom image on hover | On/off Default: On | |
| Padding |
|---|
| Top | Slider 0–100px Default: 24px | |
| Bottom | Slider 0–100px Default: 24px | |
| Padding top (mobile) | Slider 0–120px Default: 24px | |
| Padding bottom (mobile) | Slider 0–120px Default: 24px | |
| Design |
|---|
| Heading color | Color | |
| Hide on mobile | On/off Default: Off | |
| Hide on desktop | On/off Default: Off | |
| Section divider |
|---|
| Top divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Bottom divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Divider color | Color | Usually the color of the adjacent section/background. |
| Divider height | Slider 8–160px Default: 40px | |
| Divider height (mobile) | Slider 8–160px Default: 24px | |
| Width |
|---|
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Also accepts: theme blocks, app blocks.
Blocks
Promo image
| Setting | Type | Notes |
|---|
| Image | Image | |
| Link | Link | |
| Overlay content |
|---|
| Heading | Text | |
| Text | Text | |
| Discount code | Text | Shows a click-to-copy code chip. |
| Button label | Text | |
| Button link | Link | |
| Button style | Choice: Primary, Secondary Default: Primary | |
| Overlay style |
|---|
| Text color | Color Default: #ffffff | |
| Image dim | Slider 0–90% Default: 30% | |
| Content position | Choice: Top, Middle, Bottom Default: Middle | |
| Content alignment | Choice: Left, Center, Right Default: Center | |
Feature columns
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Heading | Rich text (one line) | |
| Heading size | Slider 15–80px Default: 32px | |
| Heading alignment | Choice: 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 alignment | Choice: Left, Center, Right Default: Center | |
| Text alignment (mobile) | Choice: Same as desktop, Left, Center, Right Default: Same as desktop | |
| Icon size | Slider 24–96px Default: 48px | |
| Icon size (mobile) | Slider 0–96px Default: 0px | 0 = same as desktop. |
| Column card |
|---|
| Show columns as cards | On/off Default: Off | |
| Card background | Color Default: #ffffff | |
| Card border | On/off Default: Off | |
| Card corner radius | Slider 0–40px Default: 12px | |
| Card padding | Slider 8–48px Default: 24px | |
| Icon badge |
|---|
| Show a shape behind the icon | On/off Default: Off | |
| Badge shape | Choice: Circle, Rounded, Square Default: Circle | |
| Badge color | Color Default: #f3f3f3 | |
| Columns on mobile | Choice: 1 column, 2 columns Default: 1 column | |
| Enable swipe on mobile | On/off Default: Off | |
| Background | Color | |
| Button label | Text | |
| Button link | Link | |
| Design |
|---|
| Heading color | Color | |
| Heading weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase heading | On/off Default: Off | |
| Heading size (mobile) | Slider 14–60px Default: 24px | |
| Body text color | Color | |
| Hide on mobile | On/off Default: Off | |
| Hide on desktop | On/off Default: Off | |
| Padding |
|---|
| Top | Slider 0–120px Default: 48px | |
| Bottom | Slider 0–120px Default: 48px | |
| Padding top (mobile) | Slider 0–120px Default: 48px | |
| Padding bottom (mobile) | Slider 0–120px Default: 48px | |
| Section divider |
|---|
| Top divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Bottom divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Divider color | Color | Usually the color of the adjacent section/background. |
| Divider height | Slider 8–160px Default: 40px | |
| Width |
|---|
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Also accepts: theme blocks, app blocks.
Blocks
Column
| Setting | Type | Notes |
|---|
| Icon image | Image | |
| Or paste SVG icon | HTML | Used if no image is set. |
| Heading | Text Default: Free delivery | |
| Heading size | Slider 0–48px Default: 0px | 0 = theme default. |
| Heading size (mobile) | Slider 0–40px Default: 0px | 0 = same as desktop. |
| Text | Rich text | |
| Body text size | Slider 0–28px Default: 0px | 0 = theme default. |
| Body text size (mobile) | Slider 0–24px Default: 0px | 0 = same as desktop. |
| Link label | Text | |
| Link | Link | |
Featured collection
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Collection | Collection | |
| Products to show | Slider 2–12 Default: 4 | |
| Columns on desktop | Slider 2–5 Default: 4 | |
| Columns on mobile | Choice: 1, 2 Default: 2 | |
| Heading |
|---|
| Heading | Rich text (one line) Default: Featured products | |
| Heading size | Slider 15–80px Default: 40px | |
| Heading alignment | Choice: Left, Center, Right Default: Center | |
| Heading alignment (mobile) | Choice: Same as desktop, Left, Center, Right Default: Same as desktop | |
| Heading color | Color | Leave blank to use the color scheme. Auto-switches to white when a background image is set. |
| Background (banner mode) |
|---|
| Background image | Image | Optional. When set, the section becomes a banner with the products over the image. |
| Image overlay opacity | Slider 0–90% Default: 40% | |
| Full width | On/off Default: Off | |
| Product cards |
|---|
| Show vendor | On/off Default: Off | |
| Enable quick add to cart | On/off Default: On | |
| Quick add button style | Choice: Outline, Solid Default: Solid | |
| Show 'View all' button | On/off Default: On | |
| 'View all' button label | Text Default: View all | |
| Design |
|---|
| Heading weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase heading | On/off Default: Off | |
| Heading letter spacing | Slider 0–4px Default: 0px | |
| Heading size (mobile) | Slider 14–60px Default: 28px | |
| Body text color | Color | |
| Hide on mobile | On/off Default: Off | |
| Hide on desktop | On/off Default: Off | |
| Section padding |
|---|
| Padding top | Slider 0–120px Default: 56px | |
| Padding bottom | Slider 0–120px Default: 56px | |
| Padding top (mobile) | Slider 0–120px Default: 56px | |
| Padding bottom (mobile) | Slider 0–120px Default: 56px | |
| Section divider |
|---|
| Top divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Bottom divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Divider color | Color | Usually the color of the adjacent section/background. |
| Divider height | Slider 8–160px Default: 40px | |
| Divider height (mobile) | Slider 8–160px Default: 24px | |
| Width |
|---|
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Also accepts: theme blocks, app blocks.
Featured product
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Product | Product | |
| Media position | Choice: Left, Right Default: Left | |
| Prioritize image loading | On/off Default: Off | Turn on when this section is near the top of the page (improves LCP). |
| Padding |
|---|
| Top padding | Slider 0–120px Default: 48px | |
| Bottom padding | Slider 0–120px Default: 48px | |
| Padding top (mobile) | Slider 0–120px Default: 48px | |
| Padding bottom (mobile) | Slider 0–120px Default: 48px | |
| Design |
|---|
| Hide on mobile | On/off Default: Off | |
| Hide on desktop | On/off Default: Off | |
| Section divider |
|---|
| Top divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Bottom divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Divider color | Color | Usually the color of the adjacent section/background. |
| Divider height | Slider 8–160px Default: 40px | |
| Divider height (mobile) | Slider 8–160px Default: 24px | |
| Width |
|---|
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Also accepts: app blocks.
Blocks
Title
| Setting | Type | Notes |
|---|
| Font size | Slider 20–64px Default: 32px | |
Vendor
No settings.
Price
No settings.
Rating
No settings.
Variant picker
| Setting | Type | Notes |
|---|
| Picker style | Choice: Color swatches, Image swatches, Buttons (pills), Dropdown Default: Color swatches | |
| Swatch size | Slider 30–80px Default: 44px | |
Quantity selector
No settings.
Buy buttons
| Setting | Type | Notes |
|---|
| Show dynamic checkout buttons | On/off Default: On | |
Description
No settings.
Text
| Setting | Type | Notes |
|---|
| Text | Rich text (one line) Default: Text block | |
Custom Liquid
| Setting | Type | Notes |
|---|
| Custom Liquid | Liquid | |
Image banner
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Image | Image | |
| Mobile image | Image | Optional. Shown on small screens instead of the main image. |
| Desktop height | Slider 200–800px Default: 480px | |
| Mobile height | Slider 200–600px Default: 360px | |
| Image overlay opacity | Slider 0–90% Default: 20% | |
| Full width | On/off Default: On | |
| Content |
|---|
| Heading | Text Default: Welcome | |
| Heading HTML tag | Choice: 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 size | Slider 0–100px Default: 0px | 0 = theme default. |
| Heading size (mobile) | Slider 0–72px Default: 0px | 0 = same as desktop. |
| Subheading | Text Default: Shop the new collection | |
| Subheading size | Slider 0–48px Default: 0px | 0 = theme default. |
| Subheading size (mobile) | Slider 0–40px Default: 0px | 0 = same as desktop. |
| Text color | Color Default: #ffffff | |
| Text box |
|---|
| Show a panel behind the text | On/off Default: Off | Improves legibility over busy images, especially with left/right alignment. |
| Panel color | Color Default: #000000 | |
| Panel opacity | Slider 0–100% Default: 60% | |
| Content position | Choice: Left, Center, Right Default: Center | |
| Text alignment | Choice: Left, Center, Right Default: Center | |
| Text alignment (mobile) | Choice: Same as desktop, Left, Center, Right Default: Same as desktop | |
| Content vertical position | Choice: Top, Middle, Bottom Default: Middle | |
| Content width | Slider 0–900px Default: 0px | Maximum width of the text block. Set to 0 for the default. |
| Buttons |
|---|
| First button label | Text Default: Shop now | |
| First button link | Link | |
| First button style | Choice: Solid, Outline Default: Solid | |
| Second button label | Text | |
| Second button link | Link | |
| Second button style | Choice: Solid, Outline Default: Outline | |
| Design |
|---|
| Hide on mobile | On/off Default: Off | |
| Hide on desktop | On/off Default: Off | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Also accepts: theme blocks, app blocks.
Image with text
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Image | Image | |
| Second image | Image | Optional. Overlaps the first image at the bottom corner. |
| Image position | Choice: Left, Right Default: Left | |
| Image ratio (w/h) | Slider 0.6–1.6 Default: 1 | |
| Vertical alignment | Choice: Top, Middle, Bottom Default: Middle | |
| Text alignment | Choice: Left, Center Default: Left | |
| Background | Color | |
| Text box |
|---|
| Show a panel behind the text | On/off Default: Off | Improves legibility, especially over a colored section background. |
| Panel color | Color Default: #000000 | |
| Panel opacity | Slider 0–100% Default: 60% | |
| Padding |
|---|
| Top | Slider 0–120px Default: 48px | |
| Bottom | Slider 0–120px Default: 48px | |
| Padding top (mobile) | Slider 0–120px Default: 48px | |
| Padding bottom (mobile) | Slider 0–120px Default: 48px | |
| Design |
|---|
| Hide on mobile | On/off Default: Off | |
| Hide on desktop | On/off Default: Off | |
| Section divider |
|---|
| Top divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Bottom divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Divider color | Color | Usually the color of the adjacent section/background. |
| Divider height | Slider 8–160px Default: 40px | |
| Divider height (mobile) | Slider 8–160px Default: 24px | |
| Width |
|---|
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Also accepts: theme blocks, app blocks.
Blocks
Caption
| Setting | Type | Notes |
|---|
| Caption | Text Default: Our story | |
| Text style | Choice: Subtitle, Uppercase (letter spacing) Default: Uppercase (letter spacing) | |
Collapsible tab
| Setting | Type | Notes |
|---|
| Heading | Text Default: Collapsible row | |
| Content | Rich text | |
Heading
| Setting | Type | Notes |
|---|
| Heading | Rich text (one line) Default: Image with text | |
| Font size | Slider 18–72px Default: 36px | |
| Heading weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase heading | On/off Default: Off | |
| Heading letter spacing | Slider 0–4px Default: 0px | |
| Heading size (mobile) | Slider 14–80px Default: 36px | |
| Heading color | Color | |
Text
| Setting | Type | Notes |
|---|
| Text | Rich text | |
| Body text size | Slider 0–32px Default: 0px | 0 = theme default. |
| Body text size (mobile) | Slider 0–28px Default: 0px | 0 = same as desktop. |
Button
| Setting | Type | Notes |
|---|
| Label | Text Default: Learn more | |
| Link | Link | |
| Style | Choice: Solid, Outline Default: Solid | |
Logo list
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Heading | Rich text (one line) Default: As seen in | |
| Heading size | Slider 15–80px Default: 28px | |
| Heading alignment | Choice: Left, Center, Right Default: Center | |
| Heading alignment (mobile) | Choice: Same as desktop, Left, Center, Right Default: Same as desktop | |
| Intro text | Rich text | |
| Layout |
|---|
| Layout | Choice: Grid, Carousel (auto-scroll) Default: Grid | |
| Scroll duration | Slider 10–90s Default: 30s | Lower is faster. |
| Card style | Choice: None, Bordered, Filled Default: None | |
| Uniform logo height | Slider 0–120px Default: 0px | 0 = use each logo's own size. |
| Columns on desktop | Slider 2–8 Default: 5 | |
| Columns on mobile | Choice: 2 columns, 3 columns Default: 2 columns | |
| Grayscale logos | On/off Default: On | |
| Logo opacity (idle) | Slider 40–100% Default: 70% | Logos fade to full opacity on hover. |
| Enable swipe on mobile | On/off Default: Off | |
| Background color | Color | |
| Padding |
|---|
| Top padding | Slider 0–100px Default: 40px | |
| Bottom padding | Slider 0–100px Default: 40px | |
| Padding top (mobile) | Slider 0–120px Default: 40px | |
| Padding bottom (mobile) | Slider 0–120px Default: 40px | |
| Design |
|---|
| Heading color | Color | |
| Heading weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase heading | On/off Default: Off | |
| Heading letter spacing | Slider 0–4px Default: 0px | |
| Heading size (mobile) | Slider 14–60px Default: 28px | |
| Body text color | Color | |
| Hide on mobile | On/off Default: Off | |
| Hide on desktop | On/off Default: Off | |
| Section divider |
|---|
| Top divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Bottom divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Divider color | Color | Usually the color of the adjacent section/background. |
| Divider height | Slider 8–160px Default: 40px | |
| Width |
|---|
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Also accepts: theme blocks, app blocks.
Blocks
Logo
| Setting | Type | Notes |
|---|
| Logo image | Image | |
| Max width | Slider 40–240px Default: 120px | |
| Link | Link | |
| Open link in new tab | On/off Default: Off | |
| Label (optional) | Text | Shown under the logo; also used as the link's accessible name. |
Lookbook
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Heading | Text Default: Shop the look | |
| Intro text | Rich text | |
| Heading size | Slider 15–80px Default: 36px | |
| Heading alignment | Choice: Left, Center, Right Default: Center | |
| Heading alignment (mobile) | Choice: Same as desktop, Left, Center, Right Default: Same as desktop | |
| Data source | Text 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 keys | Text | Only if your definition uses other field keys: image=your_key, heading=your_key. Fields read: image, heading, body, products. |
| Row layout |
|---|
| Image ratio | Choice: Natural, Square (1:1), Portrait (3:4), Landscape (4:3), Wide (16:9) Default: Natural | |
| Image : text width | Choice: 50 / 50, Image major (60 / 40), Text major (40 / 60) Default: 50 / 50 | |
| First image side | Choice: Left, Right Default: Left | |
| Vertical alignment | Choice: Center, Top Default: Center | |
| Row gap | Slider 16–96px Default: 48px | |
| Story text |
|---|
| Story text alignment | Choice: Left, Center, Right Default: Left | |
| Story text alignment (mobile) | Choice: Same as desktop, Left, Center, Right Default: Same as desktop | |
| Story heading size | Slider 16–48px Default: 24px | |
| Body text size | Slider 0–24px Default: 0px | 0 = theme default. |
| Max text width | Slider 0–700px Default: 0px | 0 = no limit. |
| Show text on a panel | On/off Default: Off | |
| Shop this look |
|---|
| Products label | Text Default: Shop this look | |
| Products layout | Choice: Grid, Carousel on mobile Default: Grid | |
| Zoom image on hover | On/off Default: Off | |
| Spacing |
|---|
| Top padding | Slider 0–120px Default: 40px | |
| Bottom padding | Slider 0–120px Default: 40px | |
| Top padding (mobile) | Slider 0–120px Default: 32px | |
| Bottom padding (mobile) | Slider 0–120px Default: 32px | |
| Design |
|---|
| Heading weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase heading | On/off Default: Off | |
| Heading letter spacing | Slider 0–4px Default: 0px | |
| Heading size (mobile) | Slider 14–60px Default: 26px | |
| Heading color | Color | |
| Body text color | Color | |
| Hide on mobile | On/off Default: Off | |
| Hide on desktop | On/off Default: Off | |
| Section divider |
|---|
| Top divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Bottom divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Divider color | Color | Usually the color of the adjacent section/background. |
| Divider height | Slider 8–160px Default: 40px | |
| Width |
|---|
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Also accepts: theme blocks, app blocks.
Mosaic grid
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Heading | Rich text (one line) Default: Multimedia collage | |
| Heading size | Slider 15–80px Default: 36px | |
| Heading alignment | Choice: 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 layout | Choice: Collage, Column Default: Column | |
| Tile style | Choice: None, Boxed Default: Boxed | |
| Padding |
|---|
| Top padding | Slider 0–100px Default: 36px | |
| Bottom padding | Slider 0–100px Default: 36px | |
| Padding top (mobile) | Slider 0–120px Default: 36px | |
| Padding bottom (mobile) | Slider 0–120px Default: 36px | |
| Design |
|---|
| Heading color | Color | |
| Heading weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase heading | On/off Default: Off | |
| Heading letter spacing | Slider 0–4px Default: 0px | |
| Heading size (mobile) | Slider 14–60px Default: 28px | |
| Body text color | Color | |
| Hide on mobile | On/off Default: Off | |
| Hide on desktop | On/off Default: Off | |
| Section divider |
|---|
| Top divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Bottom divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Divider color | Color | Usually the color of the adjacent section/background. |
| Divider height | Slider 8–160px Default: 40px | |
| Divider height (mobile) | Slider 8–160px Default: 24px | |
| Width |
|---|
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Also accepts: theme blocks, app blocks.
Blocks
Image
| Setting | Type | Notes |
|---|
| Image | Image | |
| Link | Link | Where the image click goes (collection, product, page, or any URL). |
Product
| Setting | Type | Notes |
|---|
| Product | Product | |
Collection
| Setting | Type | Notes |
|---|
| Collection | Collection | |
Video
| Setting | Type | Notes |
|---|
| Cover image | Image | |
| Video URL | Video link Default: https://www.youtube.com/watch?v=UELVSZC06BE | |
| Video alt text | Text Default: Describe the video | |
Newsletter
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Content width | Slider 400–900px Default: 600px | |
| Content alignment | Choice: Left, Center, Right Default: Center | |
| Content alignment (mobile) | Choice: Same as desktop, Left, Center, Right Default: Same as desktop | |
| Background | Color | |
| Padding |
|---|
| Top | Slider 0–120px Default: 56px | |
| Bottom | Slider 0–120px Default: 56px | |
| Padding top (mobile) | Slider 0–120px Default: 56px | |
| Padding bottom (mobile) | Slider 0–120px Default: 56px | |
| Design |
|---|
| Hide on mobile | On/off Default: Off | |
| Hide on desktop | On/off Default: Off | |
| Section divider |
|---|
| Top divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Bottom divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Divider color | Color | Usually the color of the adjacent section/background. |
| Divider height | Slider 8–160px Default: 40px | |
| Divider height (mobile) | Slider 8–160px Default: 24px | |
| Width |
|---|
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Also accepts: theme blocks, app blocks.
Blocks
Heading
| Setting | Type | Notes |
|---|
| Heading | Rich text (one line) Default: Subscribe to our newsletter | |
| Font size | Slider 18–64px Default: 32px | |
| Heading weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase heading | On/off Default: Off | |
| Heading letter spacing | Slider 0–4px Default: 0px | |
| Heading size (mobile) | Slider 14–80px Default: 32px | |
| Heading color | Color | |
Text
| Setting | Type | Notes |
|---|
| Text | Rich text | |
| Text size | Slider 0–28px Default: 0px | 0 = theme default. |
| Text size (mobile) | Slider 0–24px Default: 0px | 0 = same as desktop. |
Email form
| Setting | Type | Notes |
|---|
| Show consent checkbox | On/off Default: Off | |
| Consent text | Text Default: I agree to receive marketing emails. | |
| Require consent to subscribe | On/off Default: On | |
Page
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Page | Page | |
| Heading size | Slider 15–80px Default: 36px | |
| Content alignment | Choice: Left, Center Default: Left | |
| Padding |
|---|
| Top padding | Slider 0–120px Default: 48px | |
| Bottom padding | Slider 0–120px Default: 48px | |
| Padding top (mobile) | Slider 0–120px Default: 48px | |
| Padding bottom (mobile) | Slider 0–120px Default: 48px | |
| Section divider |
|---|
| Top divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Bottom divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Divider color | Color | Usually the color of the adjacent section/background. |
| Divider height | Slider 8–160px Default: 40px | |
| Divider height (mobile) | Slider 8–160px Default: 24px | |
| Width |
|---|
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Product hotspots
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Heading | Rich text (one line) Default: Shop the look | |
| Heading size | Slider 15–80px Default: 36px | |
| Heading alignment | Choice: Left, Center, Right Default: Center | |
| Heading alignment (mobile) | Choice: Same as desktop, Left, Center, Right Default: Same as desktop | |
| Image | Image | |
| Mobile image | Image | Optional. Shown on small screens instead of the main image. |
| Image height | Slider 300–900px Default: 600px | |
| Corner radius | Slider 0–40px Default: 8px | |
| Full width | On/off Default: Off | |
| Enable quick add | On/off Default: On | |
| Quick add style | Choice: Outline, Solid Default: Solid | |
| Padding |
|---|
| Top | Slider 0–100px Default: 48px | |
| Bottom | Slider 0–100px Default: 48px | |
| Padding top (mobile) | Slider 0–120px Default: 48px | |
| Padding bottom (mobile) | Slider 0–120px Default: 48px | |
| Design |
|---|
| Heading color | Color | |
| Heading weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase heading | On/off Default: Off | |
| Heading letter spacing | Slider 0–4px Default: 0px | |
| Heading size (mobile) | Slider 14–60px Default: 28px | |
| Body text color | Color | |
| Hide on mobile | On/off Default: Off | |
| Hide on desktop | On/off Default: Off | |
| Section divider |
|---|
| Top divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Bottom divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Divider color | Color | Usually the color of the adjacent section/background. |
| Divider height | Slider 8–160px Default: 40px | |
| Divider height (mobile) | Slider 8–160px Default: 24px | |
| Width |
|---|
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Also accepts: theme blocks, app blocks.
Blocks
Hotspot
| Setting | Type | Notes |
|---|
| Product | Product | |
| Text (optional) | Rich text | |
| Card width | Slider 160–320px Default: 220px | |
| Desktop position |
|---|
| Horizontal | Slider 0–100% Default: 50% | |
| Vertical | Slider 0–100% Default: 50% | |
| Mobile position |
|---|
| Horizontal | Slider 0–100% Default: 50% | |
| Vertical | Slider 0–100% Default: 50% | |
Promotion banner
| Setting | Type | Notes |
|---|
| Color scheme | Color 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 keys | Text | Only 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 style | Choice: Text strip, Background image, Side-by-side Default: Text strip | |
| Content alignment | Choice: Left, Center, Right Default: Center | |
| Content alignment (mobile) | Choice: Same as desktop, Left, Center, Right Default: Same as desktop | |
| Max content width | Slider 0–900px Default: 0px | 0 = full width. |
| Min height | Slider 120–640px Default: 300px | Background image style only. |
| Countdown |
|---|
| Show countdown to end date | On/off Default: Off | Uses the promotion's end date. Hidden if the promo has no end date. |
| Countdown label | Text Default: Ends in | |
| Message and button |
|---|
| Message size | Slider 13–60px Default: 18px | |
| Message size (mobile) | Slider 12–40px Default: 16px | |
| Message weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase message | On/off Default: Off | |
| Message letter spacing | Slider 0–4px Default: 0px | |
| Button style | Choice: Primary, Secondary, Text link Default: Primary | |
| Overlay |
|---|
| Overlay color | Color Default: #000000 | |
| Overlay opacity | Slider 0–90% Default: 35% | |
| Text color | Color | Overrides the color scheme over a background image. |
| Behavior |
|---|
| Let shoppers dismiss | On/off Default: Off | Adds a close button; the dismissal is remembered on the shopper's device. |
| Spacing |
|---|
| Top padding | Slider 0–120px Default: 24px | |
| Bottom padding | Slider 0–120px Default: 24px | |
| Top padding (mobile) | Slider 0–120px Default: 20px | |
| Bottom padding (mobile) | Slider 0–120px Default: 20px | |
| Design |
|---|
| Hide on mobile | On/off Default: Off | |
| Hide on desktop | On/off Default: Off | |
| Section divider |
|---|
| Top divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Bottom divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Divider color | Color | Usually the color of the adjacent section/background. |
| Divider height | Slider 8–160px Default: 40px | |
| Width |
|---|
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Quick order list
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Heading | Rich text (one line) Default: Quick order | |
| Heading size | Slider 15–80px Default: 32px | |
| Heading alignment | Choice: Left, Center, Right Default: Left | |
| Heading alignment (mobile) | Choice: Same as desktop, Left, Center, Right Default: Same as desktop | |
| Product | Product | |
| Columns |
|---|
| Show image | On/off Default: On | |
| Show price | On/off Default: On | |
| Show availability | On/off Default: On | |
| Show inventory count | On/off Default: Off | Displays remaining stock next to "In stock" when tracked. |
| Show SKU | On/off Default: Off | |
| Show line total | On/off Default: On | |
| Sticky totals bar | On/off Default: On | Keeps the total and Add to cart button visible while scrolling a long list. |
| Padding |
|---|
| Top padding | Slider 0–120px Default: 48px | |
| Bottom padding | Slider 0–120px Default: 48px | |
| Padding top (mobile) | Slider 0–120px Default: 48px | |
| Padding bottom (mobile) | Slider 0–120px Default: 48px | |
| Design |
|---|
| Heading color | Color | |
| Heading weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase heading | On/off Default: Off | |
| Heading letter spacing | Slider 0–4px Default: 0px | |
| Heading size (mobile) | Slider 14–60px Default: 28px | |
| Body text color | Color | |
| Hide on mobile | On/off Default: Off | |
| Hide on desktop | On/off Default: Off | |
| Section divider |
|---|
| Top divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Bottom divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Divider color | Color | Usually the color of the adjacent section/background. |
| Divider height | Slider 8–160px Default: 40px | |
| Divider height (mobile) | Slider 8–160px Default: 24px | |
| Width |
|---|
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Recently viewed
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Heading | Rich text (one line) Default: Recently viewed | |
| Heading size | Slider 15–80px Default: 28px | |
| Heading alignment | Choice: Left, Center, Right Default: Left | |
| Heading alignment (mobile) | Choice: Same as desktop, Left, Center, Right Default: Same as desktop | |
| Image ratio | Choice: Portrait, Square, Landscape Default: Square | |
| Image shape | Choice: 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 hover | On/off Default: Off | |
| Show vendor | On/off Default: Off | |
| Show rating | On/off Default: Off | Shows product stars when a reviews app provides a rating metafield. |
| Enable quick add to cart | On/off Default: Off | Single-variant products add straight to cart; products with options link to the product page. |
| Quick add button style | Choice: Outline button, Solid button Default: Outline button | |
| Layout | Choice: Carousel, Grid Default: Grid | |
| Max products | Slider 2–20 Default: 8 | |
| Columns per view (desktop) | Slider 2–6 Default: 5 | |
| Columns on mobile | Slider 1–3 Default: 2 | |
| Enable swipe on mobile | On/off Default: On | Carousel layout only. Off shows a stacked grid on mobile. |
| Padding |
|---|
| Top | Slider 0–100px Default: 48px | |
| Bottom | Slider 0–100px Default: 48px | |
| Padding top (mobile) | Slider 0–120px Default: 48px | |
| Padding bottom (mobile) | Slider 0–120px Default: 48px | |
| Design |
|---|
| Heading color | Color | |
| Heading weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase heading | On/off Default: Off | |
| Heading letter spacing | Slider 0–4px Default: 0px | |
| Heading size (mobile) | Slider 14–60px Default: 28px | |
| Body text color | Color | |
| Hide on mobile | On/off Default: Off | |
| Hide on desktop | On/off Default: Off | |
| Section divider |
|---|
| Top divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Bottom divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Divider color | Color | Usually the color of the adjacent section/background. |
| Divider height | Slider 8–160px Default: 40px | |
| Divider height (mobile) | Slider 8–160px Default: 24px | |
| Width |
|---|
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Rich text
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Alignment | Choice: Left, Center, Right Default: Center | |
| Alignment (mobile) | Choice: Same as desktop, Left, Center, Right Default: Same as desktop | |
| Content width | Slider 400–1200px Default: 720px | |
| Background | Color | |
| Text color | Color | |
| Full width | On/off Default: Off | |
| Padding |
|---|
| Top | Slider 0–160px Default: 72px | |
| Bottom | Slider 0–160px Default: 72px | |
| Padding top (mobile) | Slider 0–120px Default: 72px | |
| Padding bottom (mobile) | Slider 0–120px Default: 72px | |
| Design |
|---|
| Hide on mobile | On/off Default: Off | |
| Hide on desktop | On/off Default: Off | |
| Section divider |
|---|
| Top divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Bottom divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Divider color | Color | Usually the color of the adjacent section/background. |
| Divider height | Slider 8–160px Default: 40px | |
| Divider height (mobile) | Slider 8–160px Default: 24px | |
| Width |
|---|
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Also accepts: theme blocks, app blocks.
Blocks
Caption
| Setting | Type | Notes |
|---|
| Caption | Text Default: Master Theme | |
Heading
| Setting | Type | Notes |
|---|
| Heading | Rich text (one line) Default: Elegance | |
| Font size | Slider 20–100px Default: 56px | |
| Heading weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase heading | On/off Default: Off | |
| Heading letter spacing | Slider 0–4px Default: 0px | |
| Heading size (mobile) | Slider 14–80px Default: 56px | |
| Heading color | Color | |
Text
| Setting | Type | Notes |
|---|
| Text | Rich text | |
| Body text size | Slider 0–32px Default: 0px | 0 = theme default. |
| Body text size (mobile) | Slider 0–28px Default: 0px | 0 = same as desktop. |
Button
| Setting | Type | Notes |
|---|
| Label | Text Default: Button label | |
| Link | Link | |
| Style | Choice: Solid, Outline Default: Outline | |
Sale timer
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Deadline |
|---|
| End date (YYYY-MM-DD) | Text | Leave blank for a rolling 24-hour timer. |
| End time (HH:MM:SS) | Text Default: 23:59:59 | |
| Timezone offset | Text Default: +00:00 | e.g. +05:30, -08:00 |
| Hide section after it expires | On/off Default: Off | |
| Layout |
|---|
| Layout | Choice: Side by side, Stacked Default: Side by side | |
| Content alignment | Choice: Left, Center, Right Default: Left | |
| Content alignment (mobile) | Choice: Same as desktop, Left, Center, Right Default: Same as desktop | |
| Timer size | Choice: Small, Medium, Large Default: Medium | |
| Padding |
|---|
| Top | Slider 0–100px Default: 48px | |
| Bottom | Slider 0–100px Default: 48px | |
| Padding top (mobile) | Slider 0–120px Default: 48px | |
| Padding bottom (mobile) | Slider 0–120px Default: 48px | |
| Design |
|---|
| Hide on mobile | On/off Default: Off | |
| Hide on desktop | On/off Default: Off | |
| Section divider |
|---|
| Top divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Bottom divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Divider color | Color | Usually the color of the adjacent section/background. |
| Divider height | Slider 8–160px Default: 40px | |
| Divider height (mobile) | Slider 8–160px Default: 24px | |
| Width |
|---|
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Also accepts: theme blocks, app blocks.
Blocks
Heading
| Setting | Type | Notes |
|---|
| Heading | Rich text (one line) Default: Sale ends soon | |
| Font size | Slider 16–64px Default: 32px | |
| Heading weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase heading | On/off Default: Off | |
| Heading letter spacing | Slider 0–4px Default: 0px | |
| Heading size (mobile) | Slider 14–80px Default: 32px | |
| Heading color | Color | |
Caption
| Setting | Type | Notes |
|---|
| Caption | Text Default: Limited time only | |
| Text style | Choice: Subtitle, Uppercase (letter spacing) Default: Uppercase (letter spacing) | |
| Font size | Slider 12–40px Default: 16px | |
Text
| Setting | Type | Notes |
|---|
| Text | Rich text | |
Copy discount code
| Setting | Type | Notes |
|---|
| Discount code | Text Default: SAVE20 | |
Button
| Setting | Type | Notes |
|---|
| Label | Text Default: Shop the sale | |
| Link | Link | |
| Style | Choice: Solid, Outline Default: Solid | |
Shop by brand
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Heading | Text Default: Shop by brand | |
| Intro text | Rich text | |
| Heading size | Slider 15–80px Default: 36px | |
| Heading alignment | Choice: Left, Center, Right Default: Center | |
| Heading alignment (mobile) | Choice: Same as desktop, Left, Center, Right Default: Same as desktop | |
| Data source | Text 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 keys | Text | Only if your definition uses other field keys: name=your_key, logo=your_key. Fields read: name, logo, description, url. |
| Layout |
|---|
| Layout | Choice: Grid (cards), Carousel (auto-scroll strip), Logo wall (borderless) Default: Grid (cards) | |
| Card style | Choice: 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 duration | Slider 10–90s Default: 30s | Lower is faster. |
| Logos |
|---|
| Logo height | Slider 32–140px Default: 64px | |
| Grayscale logos (color on hover) | On/off Default: Off | |
| Show brand name under logo | On/off Default: Off | |
| Show brand description | On/off Default: Off | |
| Button |
|---|
| Button label | Text | Leave blank to hide. |
| Button link | Link | |
| Spacing |
|---|
| Top padding | Slider 0–120px Default: 40px | |
| Bottom padding | Slider 0–120px Default: 40px | |
| Top padding (mobile) | Slider 0–120px Default: 32px | |
| Bottom padding (mobile) | Slider 0–120px Default: 32px | |
| Design |
|---|
| Heading color | Color | |
| Heading weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase heading | On/off Default: Off | |
| Heading letter spacing | Slider 0–4px Default: 0px | |
| Heading size (mobile) | Slider 14–60px Default: 26px | |
| Body text color | Color | |
| Hide on mobile | On/off Default: Off | |
| Hide on desktop | On/off Default: Off | |
| Section divider |
|---|
| Top divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Bottom divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Divider color | Color | Usually the color of the adjacent section/background. |
| Divider height | Slider 8–160px Default: 40px | |
| Width |
|---|
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Also accepts: theme blocks, app blocks.
Slideshow
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Height | Choice: Medium, Large, Full screen Default: Large | |
| Mobile height | Choice: Medium, Large Default: Large | |
| Auto-rotate slides | On/off Default: On | |
| Change every | Slider 3–12s Default: 6s | |
| Carousel description (a11y) | Text Default: Slideshow about our store | |
| Controls |
|---|
| Transition | Choice: Slide, Fade, Fade through black, Fade through white, Zoom, Zoom in, Zoom out, Slide up, Slide down, Wipe Default: Slide | |
| Show arrows | On/off Default: On | |
| Arrow button color | Color | |
| Active dot color | Color | |
| Design |
|---|
| Hide on mobile | On/off Default: Off | |
| Hide on desktop | On/off Default: Off | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Also accepts: theme blocks, app blocks.
Blocks
Slide
| Setting | Type | Notes |
|---|
| Image | Image | |
| Mobile image | Image | Optional. Shown on small screens. |
| Caption | Text | |
| Heading | Rich text (one line) Default: Slide heading | |
| Subheading | Rich text (one line) | |
| Subheading size | Slider 0–48px Default: 0px | 0 = theme default. |
| Subheading size (mobile) | Slider 0–40px Default: 0px | 0 = same as desktop. |
| Heading size | Slider 20–100px Default: 52px | |
| Heading weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase heading | On/off Default: Off | |
| Heading letter spacing | Slider 0–4px Default: 0px | |
| Heading size (mobile) | Slider 14–80px Default: 52px | |
| Heading color | Color | |
| Text | Rich text | |
| Body text size | Slider 0–32px Default: 0px | 0 = theme default. |
| Body text size (mobile) | Slider 0–28px Default: 0px | 0 = same as desktop. |
| Button label | Text Default: Shop now | |
| Button link | Link | |
| Button style | Choice: Solid, Outline Default: Solid | |
| Content position | Choice: Left, Center, Right Default: Center | |
| Content position | Choice: Top, Middle, Bottom Default: Middle | |
| Text color | Color Default: #ffffff | |
| Image overlay | Slider 0–80% Default: 20% | |
| Text box |
|---|
| Show a panel behind the text | On/off Default: Off | Improves legibility over busy images, especially with left/right alignment. |
| Panel color | Color Default: #000000 | |
| Panel opacity | Slider 0–100% Default: 60% | |
Store locator
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Heading | Text Default: Find a store | |
| Intro text | Rich text | |
| Heading size | Slider 15–80px Default: 36px | |
| Heading alignment | Choice: Left, Center, Right Default: Center | |
| Heading alignment (mobile) | Choice: Same as desktop, Left, Center, Right Default: Same as desktop | |
| Data source | Text 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 keys | Text | Only 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 layout | Choice: Stacked (image top), Horizontal (image left) Default: Stacked (image top) | |
| Card style | Choice: Bordered, Plain, Filled Default: Bordered | |
| Show location images | On/off Default: On | |
| Image ratio | Choice: Natural, Square (1:1), Landscape (4:3), Portrait (3:4) Default: Natural | |
| Show contact icons | On/off Default: On | |
| Directions button label | Text Default: Get directions | |
| Show map embed (per-location map_embed_url) | On/off Default: Off | |
| Search |
|---|
| Enable search / filter | On/off Default: On | |
| Search placeholder | Text Default: Search by city or postcode | |
| Show result count | On/off Default: On | |
| Result count text | Text Default: Showing [shown] of [total] | Use [shown] and [total] as placeholders. |
| No-results text | Text Default: No locations match your search. | |
| Spacing |
|---|
| Top padding | Slider 0–120px Default: 40px | |
| Bottom padding | Slider 0–120px Default: 40px | |
| Top padding (mobile) | Slider 0–120px Default: 32px | |
| Bottom padding (mobile) | Slider 0–120px Default: 32px | |
| Design |
|---|
| Heading weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase heading | On/off Default: Off | |
| Heading letter spacing | Slider 0–4px Default: 0px | |
| Heading size (mobile) | Slider 14–60px Default: 26px | |
| Heading color | Color | |
| Body text color | Color | |
| Hide on mobile | On/off Default: Off | |
| Hide on desktop | On/off Default: Off | |
| Section divider |
|---|
| Top divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Bottom divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Divider color | Color | Usually the color of the adjacent section/background. |
| Divider height | Slider 8–160px Default: 40px | |
| Width |
|---|
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Also accepts: theme blocks, app blocks.
Testimonials
| Setting | Type | Notes |
|---|
| Color scheme | Color 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 source | Text 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 keys | Text | Only if your definition uses other field keys: quote=your_key, author=your_key. Fields read: quote, author, caption, avatar, rating. |
| Heading | Rich text (one line) Default: What customers say | |
| Heading size | Slider 15–80px Default: 36px | |
| Heading alignment | Choice: 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 style | Choice: Bordered card, Plain Default: Bordered card | |
| Avatar position | Choice: Top, With name Default: With name | |
| Avatar size (top) | Slider 40–120px Default: 72px | |
| Image shape | Choice: Circle, Rounded, Square Default: Circle | |
| Image corner radius | Slider 0–40px Default: 8px | |
| Image border thickness | Slider 0–8px Default: 0px | |
| Text alignment | Choice: Left, Center, Right Default: Left | |
| Text alignment (mobile) | Choice: Same as desktop, Left, Center, Right Default: Same as desktop | |
| Swipe on mobile | On/off Default: Off | Show testimonials as a horizontal swipe row on phones instead of a stacked grid. |
| Quote text size | Slider 0–32px Default: 0px | 0 = theme default. |
| Quote text size (mobile) | Slider 0–28px Default: 0px | 0 = same as desktop. |
| Padding |
|---|
| Top | Slider 0–100px Default: 48px | |
| Bottom | Slider 0–100px Default: 48px | |
| Padding top (mobile) | Slider 0–120px Default: 48px | |
| Padding bottom (mobile) | Slider 0–120px Default: 48px | |
| Design |
|---|
| Heading color | Color | |
| Heading weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase heading | On/off Default: Off | |
| Heading letter spacing | Slider 0–4px Default: 0px | |
| Heading size (mobile) | Slider 14–60px Default: 28px | |
| Body text color | Color | |
| Hide on mobile | On/off Default: Off | |
| Hide on desktop | On/off Default: Off | |
| Section divider |
|---|
| Top divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Bottom divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Divider color | Color | Usually the color of the adjacent section/background. |
| Divider height | Slider 8–160px Default: 40px | |
| Divider height (mobile) | Slider 8–160px Default: 24px | |
| Width |
|---|
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Also accepts: theme blocks, app blocks.
Blocks
Review
| Setting | Type | Notes |
|---|
| Avatar | Image | |
| Name | Text Default: Happy customer | |
| Caption | Text Default: Verified buyer | |
| Stars | Slider 0–5 Default: 5 | |
| Review | Rich text | |
Trust badges
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Heading | Text | |
| Heading size | Slider 15–60px Default: 28px | |
| Heading size (mobile) | Slider 14–48px Default: 24px | |
| Heading weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Alignment | Choice: Left, Center, Right Default: Center | |
| Alignment (mobile) | Choice: Same as desktop, Left, Center, Right Default: Same as desktop | |
| Layout |
|---|
| Columns on desktop | Slider 2–5 Default: 4 | |
| Columns on mobile | Choice: 1 column, 2 columns Default: 2 columns | |
| Badge layout | Choice: Icon above text, Icon beside text Default: Icon above text | |
| Card style | Choice: None, Boxed Default: None | |
| Show dividers between badges | On/off Default: Off | Ignored when card style is Boxed. |
| Icon |
|---|
| Icon size | Slider 20–72px Default: 32px | |
| Icon color | Color | |
| Icon background | Choice: None, Circle, Rounded, Square Default: None | |
| Icon background color | Color Default: #f3f3f3 | |
| Top padding | Slider 0–100px Default: 24px | |
| Bottom padding | Slider 0–100px Default: 24px | |
| Padding top (mobile) | Slider 0–120px Default: 24px | |
| Padding bottom (mobile) | Slider 0–120px Default: 24px | |
| Design |
|---|
| Heading color | Color | |
| Body text color | Color | |
| Hide on mobile | On/off Default: Off | |
| Hide on desktop | On/off Default: Off | |
| Section divider |
|---|
| Top divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Bottom divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Divider color | Color | Usually the color of the adjacent section/background. |
| Divider height | Slider 8–160px Default: 40px | |
| Divider height (mobile) | Slider 8–160px Default: 24px | |
| Width |
|---|
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
Also accepts: theme blocks, app blocks.
Blocks
Badge
| Setting | Type | Notes |
|---|
| Built-in icon | Choice: 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 | |
| Title | Text Default: Secure checkout | |
| Subtitle | Text Default: Encrypted & protected | |
| Link (optional) | Link | Makes the whole badge clickable — e.g. link to your shipping or returns policy. |
Video
| Setting | Type | Notes |
|---|
| Color scheme | Color scheme | |
| Heading | Rich text (one line) | |
| Heading size | Slider 15–80px Default: 32px | |
| Heading alignment | Choice: 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 image | Image | Shown until played (better performance). |
| Prioritize cover image loading | On/off Default: Off | Turn on only when this video is near the top of the page (improves LCP). |
| Aspect ratio | Choice: 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 | |
| Loop | On/off Default: Off | |
| Full width | On/off Default: Off | |
| Overlay color | Color Default: #000000 | |
| Overlay opacity | Slider 0–90% Default: 0% | |
| Overlay content position | Choice: Top, Middle, Bottom Default: Middle | |
| Overlay text alignment | Choice: Left, Center, Right Default: Center | |
| Hide overlay text when the video plays | On/off Default: Off | |
| Padding |
|---|
| Top | Slider 0–120px Default: 48px | |
| Bottom | Slider 0–120px Default: 48px | |
| Padding top (mobile) | Slider 0–120px Default: 48px | |
| Padding bottom (mobile) | Slider 0–120px Default: 48px | |
| Design |
|---|
| Heading color | Color | |
| Heading weight | Choice: Theme default, Regular, Medium, Semibold, Bold Default: Theme default | |
| Uppercase heading | On/off Default: Off | |
| Heading letter spacing | Slider 0–4px Default: 0px | |
| Heading size (mobile) | Slider 14–60px Default: 28px | |
| Body text color | Color | |
| Hide on mobile | On/off Default: Off | |
| Hide on desktop | On/off Default: Off | |
| Section divider |
|---|
| Top divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Bottom divider | Choice: None, Angle, Angle (left), Curve, Rounded, Wave, Triangle Default: None | |
| Divider color | Color | Usually the color of the adjacent section/background. |
| Divider height | Slider 8–160px Default: 40px | |
| Divider height (mobile) | Slider 8–160px Default: 24px | |
| Width |
|---|
| Section width | Choice: Standard, Wide, Full width Default: Standard | |
| Custom CSS | Text (multi-line) | Scoped to this section. Write declarations (color: red) or nested rules (& .foo { ... }). |
Also accepts: theme blocks, app blocks.
Blocks
Text
| Setting | Type | Notes |
|---|
| Text | Rich text (one line) Default: Tell your story | |
| Font size | Slider 16–80px Default: 40px | |
Button
| Setting | Type | Notes |
|---|
| Button label | Text Default: Shop now | |
| Button link | Link | |
| Button style | Choice: Solid, Outline Default: Solid | |
Theme blocks
These blocks can be added to any section that accepts theme blocks.
Button
| Setting | Type | Notes |
|---|
| Label | Text Default: Shop now | |
| Link | Link | |
| Open in a new tab | On/off Default: Off | |
| Style | Choice: Filled, Outline, Text link Default: Filled | |
| Alignment | Choice: Left, Center, Right Default: Left | |
| Full width | On/off Default: Off | |
| Spacing |
|---|
| Space above | Slider 0–80px Default: 0px | |
| Space below | Slider 0–80px Default: 0px | |
Countdown
| Setting | Type | Notes |
|---|
| Counts down to a real date and disappears when it ends. Leave the date empty to hide it. |
| Label | Text Default: Offer ends in | |
| End date | Text | YYYY-MM-DD, e.g. 2026-12-31 |
| End time | Text Default: 23:59:59 | |
| Time zone offset | Text Default: +00:00 | e.g. +05:30 for India, -05:00 for New York. |
| Size | Choice: Small, Medium, Large Default: Medium | |
| Alignment | Choice: Left, Center, Right Default: Left | |
| Spacing |
|---|
| Space above | Slider 0–80px Default: 0px | |
| Space below | Slider 0–80px Default: 0px | |
Divider
| Setting | Type | Notes |
|---|
| Thickness | Slider 1–8px Default: 1px | |
| Width | Slider 10–100% Default: 100% | |
| Opacity | Slider 5–100% Default: 20% | |
| Spacing |
|---|
| Space above | Slider 0–80px Default: 0px | |
| Space below | Slider 0–80px Default: 0px | |
Group
| Setting | Type | Notes |
|---|
| Direction | Choice: Stacked, Side by side Default: Stacked | |
| Equal width columns | On/off Default: On | |
| Stack on mobile | On/off Default: On | |
| Align items | Choice: Start, Center, End, Stretch Default: Stretch | |
| Distribute | Choice: Start, Center, End, Space between Default: Start | |
| Gap | Slider 0–80px Default: 16px | |
| Box |
|---|
| Color scheme | Color scheme | |
| Padding | Slider 0–80px Default: 0px | |
| Corner radius | Slider 0–40px Default: 0px | |
| Max width | Slider 0–1600px Default: 0px | 0 = full width of the section. |
| Spacing |
|---|
| Space above | Slider 0–80px Default: 0px | |
| Space below | Slider 0–80px Default: 0px | |
Heading
| Setting | Type | Notes |
|---|
| Text | Rich text (one line) Default: Heading | |
| HTML tag | Choice: H1, H2, H3, Paragraph Default: H2 | Use one H1 per page. |
| Size | Slider 14–120px Default: 40px | |
| Size on mobile | Slider 12–80px Default: 28px | |
| Weight | Choice: Theme default, Light, Regular, Medium, Semibold, Bold Default: Theme default | |
| Alignment | Choice: Left, Center, Right Default: Left | |
| Uppercase | On/off Default: Off | |
| Letter spacing | Slider 0–6px Default: 0px | |
| Color | Color | |
| Spacing |
|---|
| Space above | Slider 0–80px Default: 0px | |
| Space below | Slider 0–80px Default: 0px | |
Image
| Setting | Type | Notes |
|---|
| Image | Image | |
| Alt text | Text | Describe the image for screen readers. Leave empty if it's decorative. |
| Link | Link | |
| Shape | Choice: Original, Square, Portrait, Landscape, Wide Default: Original | |
| Fit | Choice: Fill the shape, Show the whole image Default: Fill the shape | |
| Width | Slider 20–100% Default: 100% | |
| Alignment | Choice: Left, Center, Right Default: Left | |
| Corner radius | Slider 0–40px Default: 0px | |
| Spacing |
|---|
| Space above | Slider 0–80px Default: 0px | |
| Space below | Slider 0–80px Default: 0px | |
Spacer
| Setting | Type | Notes |
|---|
| Height | Slider 0–200px Default: 40px | |
| Height on mobile | Slider 0–160px Default: 24px | |
Text
| Setting | Type | Notes |
|---|
| Text | Rich text | |
| Size | Slider 0–32px Default: 0px | 0 = theme default. |
| Alignment | Choice: Left, Center, Right Default: Left | |
| Max line length | Slider 0–120ch Default: 0ch | 0 = no limit. About 65 reads best. |
| Color | Color | |
| Spacing |
|---|
| Space above | Slider 0–80px Default: 0px | |
| Space below | Slider 0–80px Default: 0px | |