Shopify theme documentation
Altiora
Customization Guide
A practical reference for configuring Altiora’s navigation, product experiences, collection layouts, storytelling sections, and interactive shopping features.
Product Detail Page
The Product Detail section (sections/main-product.liquid) powers product detail pages and featured product showcases. It uses configurable information blocks and includes color swatches, stock indicators, hover zoom, and AJAX Add to Cart alongside Shopify's native Buy It Now flow.

Product & Media Settings
| Setting | Type | Description |
|---|---|---|
| Product | Product Picker | Selects a product for a homepage or non-product-page showcase. If left blank, the active product is displayed on a product page. |
| Gap between image and info | Slider (20–100px) | Sets the horizontal gap between the media gallery and product information. |
| Make info column sticky on scroll | Checkbox | Keeps the product information column in view while scrolling through gallery images on desktop. |
| Main image aspect ratio | Select | Choose Square (1:1), Portrait (3:4), Landscape (4:3), or Original image ratio. |
| Image corner radius | Slider (0–30px) | Sets corner rounding for gallery media and thumbnails. |
| Zoom image on hover | Checkbox | Enables cursor-tracked zoom on the main product image. |
Variant Options & Color Swatches
| Setting | Type | Description |
|---|---|---|
| Option names to show as color swatches | Text | Comma-separated option names to render as swatches, for example Color, Color. Other options render as button pills. |
| Swatch size | Slider (16–44px) | Sets the dimensions of color swatches. |
| Swatch corner radius | Slider (0–50%) | Controls swatch shape: 50% makes a circle and 0% makes a square. |
| Swatch border color | Color Picker | Sets the outline color for inactive swatches. |
| Active swatch ring color | Color Picker | Sets the accent ring for the selected swatch. |
| Show divider line after variant options | Checkbox | Adds a divider below the variant selectors. |

Real-Time Inventory & Stock Indicator
| Setting | Type | Description |
|---|---|---|
| Show stock status | Checkbox | Displays a visual status/progress bar for inventory availability. |
| Low stock threshold | Slider (1–20 units) | Sets the inventory level at or below which the bar switches to its low-stock warning state. |
| In-stock bar color | Color Picker | Color used for higher inventory levels. |
| Low-stock bar color | Color Picker | Warning color used when inventory is at or below the threshold. |
| Out-of-stock bar color | Color Picker | Alert color used when the selected variant is sold out. |
Product Information Blocks
Reorder and customize the product information blocks in the theme editor.
| Block | Limit | Purpose |
|---|---|---|
Vendor (vendor) |
1 | Displays the product vendor or brand. |
Title (title) |
1 | Displays the main product title. |
Price (price) |
1 | Displays the current price, compare-at price when applicable, and an optional divider. |
Variant Picker (variant_picker) |
1 | Provides interactive color swatches and button pills. |
Stock Status (inventory_status) |
1 | Displays the real-time stock indicator. |
Quantity Selector (quantity_selector) |
1 | Provides increment/decrement controls and manual quantity input. |
Buy Buttons (buy_buttons) |
1 | Provides Add to Cart, optional Buy It Now, and an optional View full product details link. |
Description (description) |
1 | Displays the product description with optional word truncation controls. |
Trust Badge (trust_badge) |
Unlimited | Displays value-proposition badges with Truck, Refresh, Leaf, Shield, Gift, or Headset icons. |
Color Palette & Typography
- Customize the heading/title color and font size (20–48px).
- Set body text, border, and price-highlight colors.
- Configure sale badge and custom tag label colors.
- Set default and selected background/text colors for pill option buttons.
- Customize background and text colors for Add to Cart and Buy It Now buttons.
Built-in Cart & Variant Behavior
-
Add to Cart: Submits through
/cart/add.jsusing AJAX, shows immediate button feedback (Adding… then Added!), and dispatchescart:updatedso the header and cart drawer counters can refresh. -
Buy It Now: Uses Shopify's native direct checkout flow through
/checkout. - Variant image switching: Selecting a swatch or pill finds the matching variant, updates the price and availability, and switches the featured media where a matching image exists.
Product Compare Widget & Matrix
Altiora's global comparison feature uses the Compare Widget section (sections/compare-widget-global.liquid) and its companion snippet (snippets/compare-widget.liquid). It provides a floating comparison dock, synchronized comparison checkboxes on product cards, and a side-by-side comparison page.
Enable the Global Compare Dock
- Open the Shopify theme editor.
- Go to Customize → Footer area → Add section → Compare Widget.
- Add the section to the Footer group so the comparison dock can appear across page templates.
The global section delegates its rendering to snippets/compare-widget.liquid. The Compare Now action directs customers to /pages/compare, configurable through the Shopify page handle.

Floating Compare Dock Features
| Feature | Behavior |
|---|---|
| Product chips | Shows selected products as pill-shaped labels with one-click removal controls. |
| Item counter | Shows the number selected out of the maximum capacity, such as 2 / 3 selected. |
| Compare capacity | Supports up to three products at once. |
| Clear | Removes all selected products and deselects active comparison checkboxes across the page. |
| Compare Now | Becomes active when two or three products are selected and opens the comparison page. |
| Mobile layout | Below 600px, product chips collapse while the counter, Clear control, and call-to-action remain available. |
Connect Product Cards to Compare
A product card or section can participate in comparison by including a checkbox with the data-compare-checkbox attribute and the product's ID, handle, and title.
<label class="product-compare-toggle">
<input
type="checkbox"
data-compare-checkbox
data-product-id="{{ product.id }}"
data-product-handle="{{ product.handle }}"
data-product-title="{{ product.title | escape }}"
>
<span>Compare</span>
</label>
JavaScript API: window.PGSCompare
-
window.PGSCompare.sync()rescans the page and synchronizes comparison checkboxes with the activelocalStorageentries. Call it after dynamically rendering AJAX product grids, such as recently viewed products, infinite scroll, or filter pagination. -
window.PGSCompare.getList()returns the current array of compared product objects in the form[{ id, handle, title }].
Set Up the Comparison Page
- In Shopify Admin → Online Store → Pages, create a page titled Compare Products.
- Set the page handle/URL slug to
compare. - Assign the
comparetemplate suffix (page.compare).

Comparison Matrix Details
- Sticky attribute column: The leftmost attribute column stays visible while users scroll horizontally on smaller screens.
- Product header: Includes a thumbnail, product title link, view-product button, and a control to remove the product from comparison.
-
Vendor / brand: Shows the brand name or an em dash (
—) when unavailable. - Price: Displays regular and compare-at prices where applicable.
- Description: Shows a cleaned, HTML-stripped excerpt shortened for side-by-side reading.
- Variant options: Builds comparison rows from the unique variant options found across the selected products, such as Size, Color, or Material.
Rich Text with Image
The Rich Text with Image section (sections/rich-text-with-image.liquid) creates editorial-style statements with circular inline images, badges, or icons. It supports placeholder-token substitution, scroll-reveal animation, and separate desktop and mobile text scaling.

Section Settings
| Setting | Type | Description |
|---|---|---|
| Desktop Text Alignment | Select | Aligns content left, center, or right. |
| Text Color | Color Picker | Sets the color of the subheading and main copy. |
| Background Color | Color Picker | Sets the section background. |
| Top Margin | Slider (0–100px) | Sets spacing above the section. |
| Bottom Margin | Slider (0–100px) | Sets spacing below the section. |
| Fade text in on scroll | Checkbox | Enables a scroll-reveal entrance animation using IntersectionObserver. |
Subheading Block (heading)
Limit: One block per section.
| Setting | Type | Description |
|---|---|---|
| Subheading Text | Rich text | Introductory label or short kicker above the main headline. |
| Text Transformation | Select | Displays text in Normal or Uppercase format. |
| Hide on Mobile | Checkbox | Hides this block on viewports narrower than 1000px. |
Main Text & Icons Block (text)
Limit: One block per section.
| Setting | Type | Description |
|---|---|---|
| Main Content | Textarea | Main headline copy. It supports the PICTURE1, PICTURE2, and PICTURE3 tokens. |
| Text Transformation | Select | Displays text in Normal or Uppercase format. |
| Hide on Mobile | Checkbox | Hides this block on viewports narrower than 1000px. |
| Desktop Font Scale | Slider (50–500%) | Scales the headline on desktop screens. |
| Mobile Font Scale | Slider (80–300%) | Scales the headline on mobile viewports narrower than 1000px. |
| Line Height | Slider (1.0–2.0) | Sets the headline line-spacing multiplier. |
| Select Image 1 / 2 / 3 | Image Picker | Assigns the inline image for the matching token. |
| Image 1 / 2 / 3 Link | URL | Optionally makes the corresponding inline image clickable. |
Using Inline Image Tokens
Type the uppercase token into the Main Content field where the image should appear. For example:
Handcrafted with PICTURE1 organic cotton and PICTURE2 sustainable dyes for a PICTURE3 timeless look.
- When
PICTURE1is present and Image 1 is selected, Altiora replaces the token with an inline image using theinline-iconclass. - If an image link is provided, the image is wrapped in an anchor using the
icon-linkclass. - Inline images use circular framing, a subtle outline, and vertical middle alignment to fit the text flow.
Scroll-Reveal Animation
When Fade text in on scroll is enabled, elements start at opacity: 0.15 with a translateY(18px) offset. An IntersectionObserver triggers a smooth cubic-bezier transition as the section enters the viewport. The effect respects the system's prefers-reduced-motion: reduce accessibility preference.
Frequently Bought Together
The Frequently Bought Together section (sections/frequently-bought-together.liquid) is an upsell and cross-sell component designed for product templates. It displays a main product with companion products, lets customers select items and variants, calculates bundle totals and savings, and can add selected items to the cart in one action.

Content & Product Source Settings
| Setting | Type | Description |
|---|---|---|
| Heading | Text | Heading displayed above the bundle, such as Frequently bought together. |
| Heading tag | Select | Chooses the semantic heading tag: h1–h6 or p. |
| Product source | Select | Choose Automatic (recommendations / collection fallback), Specific collection, or Manual products via blocks. |
| Collection | Collection Picker | Sets the source collection when Specific collection is selected. |
| Companion products to show | Slider (1–5) | Sets the maximum number of companion products shown alongside the main product. |
| Include this product in the bundle | Checkbox | Includes the current product as the primary bundle item. |
| Prevent removing this product from the bundle | Checkbox | Locks the current product's checkbox so customers cannot deselect it. |
| Disable automatic fallback | Checkbox | Disables automatic fallback products when recommendations or the selected collection are empty. |
Variant Picker & Cart Integration
| Setting | Type | Description |
|---|---|---|
| Show variant picker when a product has options | Checkbox | Shows variant dropdowns for products with multiple options, such as size or color. |
| Button text | Text | Sets the bundle call-to-action label, such as Add selected to cart. |
| Button background color | Color Picker | Sets the bundle button background. |
| Button text color | Color Picker | Sets the button text and icon color. |
| Button border color | Color Picker | Sets the button outline color. |
| Button border width | Slider (0–4px) | Sets the button outline thickness. |
| Cart sections to refresh after adding | Text | Comma-separated section IDs to refresh through AJAX, for example cart-drawer, cart-icon-bubble. |
| Reload page after adding to cart | Checkbox | Forces a full page refresh after a successful cart submission instead of opening the AJAX cart drawer. |
Pricing, Totals & Bundle Discounts
| Setting | Type | Description |
|---|---|---|
| Show individual prices | Checkbox | Displays each product's price below its title. |
| Show compare-at price | Checkbox | Displays the original price with a strikethrough when a product is discounted. |
| Show running total | Checkbox | Displays the combined price of selected products above the Add to Cart button. |
| Enable bundle discount | Checkbox | Enables automatic bundle-discount calculation for selected items. |
| Discount type | Select | Choose Percentage (%) or Fixed amount ($). |
| Discount value | Number | Enter the discount value, such as 10 for 10% or 10.00 for a fixed amount. |
| Discount code to auto-apply | Text | Shopify checkout discount code passed to a checkout URL such as /checkout?discount=CODE. |
| Savings label | Text | Text for the discount badge, such as Bundle discount or Save 15%. |
Layout & Card Styling
| Setting | Type | Description |
|---|---|---|
| Layout | Select | Choose Horizontal (side-by-side cards with plus connectors) or Vertical (stacked list with checkboxes). |
| Section width | Select | Choose Page width or Full width. |
| Section alignment | Select | Align content left, center, or right. |
| Card width (horizontal layout) | Slider (120–260px) | Sets product card width in horizontal layout. |
| Space between cards | Slider (8–40px) | Sets horizontal and vertical spacing between cards and plus connectors. |
| Card corner radius | Slider (0–24px) | Sets rounding for product card containers and images. |
| Card border width | Slider (0–4px) | Sets product card outline thickness. |
| “+” vertical position | Slider (-40px to 40px) | Adjusts the vertical alignment of plus-sign connectors. |
Media, Typography & Spacing
| Setting | Type | Description |
|---|---|---|
| Image shape | Select | Choose Square (1:1), Portrait (3:4), or Landscape (4:3). |
| Image fit | Select | Cover crops the image to fill its area; Contain shows the full image. |
| Use a custom image height | Checkbox | Overrides the selected aspect ratio with a fixed image height. |
| Image height | Slider (100–300px) | Sets the fixed image height when custom height is enabled. |
| Show vendor | Checkbox | Displays the product vendor or brand above the title. |
| Background color | Color Picker | Sets the section background. |
| Text color | Color Picker | Sets heading, product title, and price colors. |
| Checkmark color | Color Picker | Sets the checkmark color in active checkbox pills. |
| Top padding / Bottom padding | Slider (0–100px each) | Sets spacing above and below the section. |
Product Blocks
Add Product blocks to select exact companion products when using manual product selection.
| Block | Field | Description |
|---|---|---|
Product (product) |
Product Picker | Selects the specific Shopify product to include in the bundle. |
Built-in Features
- Live price calculation: Checkboxes recalculate the original total, discounted total, and savings amount without refreshing the page.
- Dynamic variant switching: Changing a variant dropdown updates the item price, availability, and product thumbnail.
-
Multi-item AJAX cart add: Adds selected products and chosen variant IDs in one batch request to
/cart/add.js. - Automatic discount application: Can attach a discount code to checkout redirection or line-item properties.
- Staggered animations: Uses entrance transitions, hover elevation, and active-selection border glows.
Collection Glass Grid
The Collection Glass Grid section (sections/collection-list-glass-effect.liquid) presents Shopify collections in a modern grid with frosted-glass overlays, bottom-up blur gradients, fluid typography, and staggered entrance animations.

Section Header
| Setting | Type | Description |
|---|---|---|
| Section Heading | Text | Main title displayed above the collection cards. |
| Subheading | Text | Supporting subtitle beneath the heading. |
Layout & Responsive Columns
| Setting | Type | Description |
|---|---|---|
| Collections per row | Slider (2–4) | Sets the number of desktop columns. |
| Gap between cards (px) | Slider (10–50px) | Sets the horizontal and vertical space between cards. |
| Show collection description | Checkbox | Displays a concise, one-line description inside the glass card overlay. |
| Button label | Text | Sets the call-to-action label, such as Discover or Shop Now. The default is Shop Now. |
Responsive Behavior
| Viewport | Layout |
|---|---|
| Desktop (over 990px) | Uses the selected column count: two, three, or four columns per row. |
| Tablet (750px–989px) | Automatically changes to a two-column grid. |
| Mobile (under 750px) | Uses a full-width, single-column stack with touch-friendly dimensions. |
Collection Blocks
Limit: 12 Collection blocks per section. Add Collection blocks to populate the grid.
| Field | Type | Description |
|---|---|---|
| Choose collection | Collection Picker | Selects the collection that provides the cover image, title, and destination link. |
| One-line description | Text | Custom teaser text that overrides the default collection description and is truncated to 70 characters. |
Built-in Visual Effects
- Frosted-glass overlay: Combines a layered backdrop filter, subtle white translucency, and a bottom-to-top gradient blur mask.
- Staggered entrance animation: Cards animate into view with cubic-bezier easing and sequential delays based on each block's index.
- Elevated hover effect: On devices with hover-capable pointers, cards move upward and scale slightly, with a deeper ambient shadow.
- Touch hover safeguard: Prevents sticky hover states on iOS and Android touchscreens while preserving button tap responsiveness.
- Consistent image framing: Card imagery maintains a 3:4 portrait aspect ratio.
Collection Bento Showcase
The Collection Bento Showcase section (sections/collection-grid.liquid) creates a modern asymmetric bento-box grid displaying curated collections or promotional categories. It combines high-impact featured large tiles with secondary bento tiles, video background loops, and customizable focal-point positioning.
Section Header
| Setting | Type | Description |
|---|---|---|
| Heading | Text | Headline title displayed above the bento grid. |
| Subheading | Text | Italicized or small subtitle above/below the heading. |
| Description | Rich Text | Introductory text or narrative for the collection showcase. |
| Header Alignment | Select | Left, Center, or Right alignment. |
Bento Grid Layout
| Setting | Type | Description |
|---|---|---|
| Section Width | Select | Page width (contained with margin) or Full width (spans edge-to-edge). |
| Grid Gap (px) | Slider (8–40px) | Horizontal and vertical spacing between bento tiles. |
| Tile Corner Radius (px) | Slider (0–32px) | Border radius applied to all bento card containers. |
| Desktop Layout Orientation | Select | Hero Left (large tile on the left), Hero Right (large tile on the right), or Symmetric Bento. |
| Mobile Layout | Select | Stacked Single Column or 2-Column Compact Grid. |
Card Visuals & Hover Effects
| Setting | Type | Description |
|---|---|---|
| Enable Hover Zoom | Checkbox | Scales card media slightly on mouse hover. |
| Enable Card Hover Lift | Checkbox | Adds smooth 3D elevation and drop shadow on card hover. |
| Overlay Style | Select | Dark Gradient, Light Frosted Tint, or Solid Overlay. |
| Overlay Opacity (%) | Slider (0–90%) | Transparency level of the media overlay to ensure text contrast. |
Colors
| Setting | Type | Description |
|---|---|---|
| Section Background | Color Picker | Background color of the outer section container. |
| Heading Color | Color Picker | Main heading and subheading text color. |
| Card Title Color | Color Picker | Collection name text color inside tiles. |
| Card Subtitle / Meta Color | Color Picker | Secondary item count and description text color. |
| Badge Background | Color Picker | Background color for category and status pills. |
| Badge Text Color | Color Picker | Text color inside badges. |
| Button Background | Color Picker | Call-to-action button fill color. |
| Button Text Color | Color Picker | Call-to-action button label color. |
Section Spacing
| Setting | Type | Description |
|---|---|---|
| Top Padding | Slider (0–120px) | Vertical spacing above the section. |
| Bottom Padding | Slider (0–120px) | Vertical spacing below the section. |
Block Types
A. Block: Large Tile (large_tile, Limit: 1)
The primary focal anchor of the bento grid occupying double height and width.
| Field | Type | Description |
|---|---|---|
| Collection | Collection Picker | Source collection for automatic link and image fallback. |
| Custom Title Override | Text | Overrides default collection title. |
| Subtitle / Description | Text | Secondary text highlight. |
| Media Type | Select | Image or Video. |
| Image | Image Picker | Desktop & mobile featured image. |
| Video | Video Picker | Shopify-hosted looping video file. |
| Custom Media Position X (%) | Slider (0–100%) | Horizontal focal point alignment for cropping control. |
| Custom Media Position Y (%) | Slider (0–100%) | Vertical focal point alignment for cropping control. |
| Custom Media Zoom (%) | Slider (100–160%) | Scales the background media within the tile. |
| Badge Text | Text | Status label (e.g. Trending, New Season, Best Seller). |
| Badge Color | Color Picker | Custom background color for this tile's badge. |
| Button Label | Text | Primary CTA button label (e.g., Shop Collection). |
| Button Link | URL | Destination URL (defaults to collection URL). |
B. Block: Standard Tile (tile)
Secondary bento tiles that wrap around the large featured tile.
| Field | Type | Description |
|---|---|---|
| Collection | Collection Picker | Linked collection. |
| Custom Title Override | Text | Custom headline for this tile. |
| Subtitle | Text | Supporting description or item count. |
| Media Type | Select | Image or Video. |
| Image | Image Picker | Tile cover photo. |
| Video | Video Picker | Ambient background video. |
| Custom Media Position X (%) | Slider (0–100%) | Horizontal focal point offset. |
| Custom Media Position Y (%) | Slider (0–100%) | Vertical focal point offset. |
| Badge Text | Text | Optional badge tag (e.g. Featured, Sale). |
| Link URL | URL | Destination link override. |
Built-in Features
- Asymmetric Bento Layout: Dynamically organizes single and double-span tiles into a harmonious responsive grid.
- Focal Point & Zoom Controls: Fine-tune the X/Y focal point on any tile image or video, plus zoom on the Large Tile, without re-uploading cropped assets.
- Background Video Support: Auto-playing, muted, looped MP4 videos with smooth fallback to poster images.
- Custom Status Badges: Floating category badges with live color overrides per tile.
- Responsive Stacking: Collapses to a stacked single column or a 2-column compact grid on mobile, per the Mobile Layout setting.

Wishlist Page
The Wishlist section (sections/main-wishlist.liquid) provides a dedicated standalone wishlist portal for customers. It integrates seamlessly with the theme's client-side wishlist engine (window.Wishlist), rendering saved items with animated skeleton loading cards, live item counts, animated removal transitions, and empty state guidance.
Section Settings
| Setting | Type | Description |
|---|---|---|
| Heading | Text | Headline title displayed at the top of the wishlist page (e.g. My wishlist). |
| Products per row (desktop) | Slider (2–5) | Number of product columns rendered in the grid on desktop viewports. |
| Gap between products | Slider (8–48px) | Grid column and row gap spacing between product cards. |
| Empty state message | Text | Informational message shown when the wishlist has no saved items (e.g. You haven't saved anything yet.). |
| Empty state button label | Text | Call-to-action button text for the empty state (e.g. Continue shopping). |
| Empty state button link | URL | Redirection target URL for the empty state button (e.g. /collections/all). |
Layout & Responsive Breakpoints
| Viewport | Columns | Behavior |
|---|---|---|
| Desktop (> 989px) | Configurable (2–5) | Uses the section's Products per row setting via CSS custom property --wishlist-columns. |
| Tablet (750px–989px) | 3 Columns | Automatically adapts to 3 equal-width columns. |
| Mobile (< 750px) | 2 Columns | Responsive 2-column mobile grid with fluid card image scaling. |
Storage & Live Synchronization
-
Storage Architecture: Reads the customer's saved product handles array from
localStorageusingwindow.Wishlist.getWishlist(). -
Skeleton Shimmer Loading: Renders pulsating skeleton placeholder cards matching the desktop column count while asynchronously fetching product metadata via
/products/{handle}.js. - Dynamic Count Counter: Live badge displays the exact number of active products saved in the customer's wishlist.
-
Event-Driven Removal: Listens to the
wishlist:updatedwindow event. When an item is removed (via the card's delete icon or any external wishlist button), the card executes an exit shrink animation (wishlistCardOut), removes itself from the DOM, and recalculates the total count in real time. -
Currency Support: Automatic active currency formatting matching
window.Shopify.currency.active.

Recently Viewed Products
The Recently Viewed Products section (sections/recently-viewed-products.liquid) is a client-side product recommendation component. It automatically records products visited by the user using browser localStorage and renders a clean, interactive product grid with direct quick-add and product comparison support.
Section Settings
| Setting | Type | Description |
|---|---|---|
| Section width | Select | Container boundary: Page width (page-width) or Full width (full-width). |
| Heading | Text | Headline title displayed above the recently viewed grid (e.g. Recently Viewed). |
| Number of products to show | Slider (2–12) | Maximum number of recently viewed product cards rendered in the grid. |
| Empty state text | Text | Informational message displayed when no products have been browsed yet (e.g. You haven't viewed any products yet.). |
Card Elements & Architecture
Each dynamically rendered card includes:
-
Compare Checkbox: Placed in the top corner of the card media, seamlessly hooked into the theme's global product comparison tool (
snippets/compare-widget.liquidandwindow.PGSCompare). - Product Image: Featured media thumbnail with lazy-loading enabled.
- Product Title & Price: Displays title, regular price, and strikethrough compare-at price when on sale.
-
Quick Add Button: Adds the first available variant directly to the cart via AJAX
/cart/add.jswith instant loading/success state feedback and automatic cart drawer opening.
Storage & Synchronization Mechanics
-
Storage Key:
shopify_recently_viewedin browserlocalStoragestores an array of product handles. -
Active PDP Filter: When placed on a Product page (
template.name == 'product'), the section automatically filters out the currently viewed product so it is not shown to the customer again within the recommendation grid. -
Live Endpoint Fetching: Reads
/products/{handle}.jsasynchronously to ensure up-to-date pricing, availability, and image URLs. -
Compare Tool Sync: Invokes
window.PGSCompare.sync()immediately after card injection to keep compare checkboxes in sync with global comparison storage.

Collection Feature List
The Collection Feature List section (sections/collection-featured-list.liquid) is an editorial, typographic list designed to display collections or navigation links with smooth hover animations, revealing circular thumbnail images, animated divider underlines, and responsive touch gestures.
Eyebrow Header
| Setting | Type | Description |
|---|---|---|
| Eyebrow text | Text | Small uppercase header text placed above the collection list. |
| Gap below eyebrow (px) | Slider (4–60px) | Spacing between the eyebrow and the first list item. |
Typography
| Setting | Type | Description |
|---|---|---|
| Font size — desktop (px) | Slider (24–120px) | Large editorial font size on desktop screens. |
| Font size — mobile (px) | Slider (24–80px) | Scaled font size for mobile devices. |
| Line height | Slider (0.8–2.0) | Vertical line height multiplier for list items. |
| Font weight | Select | Light (300), Regular (400), Medium (500), Semibold (600), or Bold (700). |
| Font family override | Select | Theme default, Serif, or Monospace. |
| Letter spacing | Slider (0–20) | Letter tracking adjustment (1 = 0.01em, 0 = normal). |
Hover Animations & Interactivity
| Setting | Type | Description |
|---|---|---|
| Text slide distance on hover (px) | Slider (0–60px) | Horizontal slide displacement of the text when hovered. |
| Transition duration (ms) | Slider (100–800ms) | Animation speed for text transforms and color transitions. |
| Animate underline on hover | Checkbox | Expands an underline beneath the collection title on hover. |
| Underline thickness (px) | Slider (1–6px) | Height/thickness of the animated hover underline. |
| Show item numbers | Checkbox | Displays leading zero index numbers (e.g. 01, 02, 03). |
| Show arrow on hover | Checkbox | Reveals a directional arrow icon that slides in next to the hovered title. |
Dividers & Borders
| Setting | Type | Description |
|---|---|---|
| Show divider lines | Checkbox | Renders subtle horizontal border lines between items. |
| Animate divider on hover | Checkbox | Slides a colored accent divider line from left to right on item hover. |
Alignment & Layout
| Setting | Type | Description |
|---|---|---|
| Text alignment | Select | Left, Center, or Right alignment. |
| Full width | Checkbox | Expands section to span 100% viewport width. |
| Max width (px) | Slider (400–1600px) | Maximum container width when Full width is disabled. |
| Item vertical padding (px) | Slider (4–40px) | Top and bottom spacing inside each collection row. |
Colors
| Setting | Type | Description |
|---|---|---|
| Section background | Color Picker | Background color of the entire section. |
| Text color (default) | Color Picker | Inactive collection title color. |
| Text color (hover) | Color Picker | Title and icon color when hovered or touched. |
| Eyebrow color | Color Picker | Eyebrow header text color. |
| Divider color | Color Picker | Horizontal separator line color. |
| Image placeholder background | Color Picker | Background fill for empty image thumbnails. |
Spacing
| Setting | Type | Description |
|---|---|---|
| Padding top (px) | Slider (0–160px) | Outer vertical spacing above the section. |
| Padding bottom (px) | Slider (0–160px) | Outer vertical spacing below the section. |
Block: Collection Item (item, Limit: 12)
Add Collection Item blocks to build your curated list.
| Field | Type | Description |
|---|---|---|
| Collection | Collection Picker | Source collection for automatic title, link, and featured image. |
| Custom label | Text | Optional override text for the collection title. |
| Custom URL | URL | Custom destination link (used when no collection is selected). |
| Image | Image Picker | Custom image shown inside the floating hover circle (overrides collection image). |
Built-in Features
- Floating Circle Reveal: Hovering an item dynamically reveals a circular thumbnail image sized to match the typography scale.
-
Directional Slide Physics: Smooth cubic-bezier (
cubic-bezier(0.22, 1, 0.36, 1)) physics for text, arrows, and accent borders. -
Touch Device Optimization: Detects
touchstart/touchendevents to trigger brief preview states before navigating on mobile devices. - Scroll Reveal Intersection Observer: List items animate into view sequentially as the customer scrolls down the page.
- Font Family Flexibility: One-click switching between serif, monospace, or theme typography presets.

Bundle Builder
The Bundle Builder section (sections/bundle-builder.liquid) is an interactive multi-step product-bundling experience. Customers can curate kits across steps, track quantity-based discount progress, and add the selected bundle to cart.
Header & Text Content
| Setting | Type | Description |
|---|---|---|
| Heading | Text | Main title displayed at the top of the bundle builder. |
| Subheading | Inline Rich Text | Subtitle or introductory instructions below the heading. |
| Section Tag / Category Badge | Text | Category indicator, such as Special Offer or Custom Sets. |
| Tag Badge Background Color | Color Picker | Background fill for the category badge. |
| Tag Badge Text Color | Color Picker | Text color for the category badge. |
Tiered Discount Milestones
Configure up to three progressive quantity-based discount tiers.
| Setting | Type | Description |
|---|---|---|
| Tier 1 Minimum Quantity | Number | Total item count required to unlock Tier 1. |
| Tier 1 Discount Percentage (%) | Number | Discount percentage applied at Tier 1. |
| Tier 2 Minimum Quantity | Number | Total item count required to unlock Tier 2. |
| Tier 2 Discount Percentage (%) | Number | Discount percentage applied at Tier 2. |
| Tier 3 Minimum Quantity | Number | Total item count required to unlock Tier 3. |
| Tier 3 Discount Percentage (%) | Number | Discount percentage applied at Tier 3. |
| Tier Discount Code (Optional) | Text | Discount code applied at checkout, or a checkout-script identifier. |
Layout & Step Navigation
| Setting | Type | Description |
|---|---|---|
| Step Layout Mode | Select | Tabbed Steps (horizontal step switch) or Vertical Accordion / Scroll. |
| Products per Row (Desktop) | Slider (2–5) | Product columns per step on desktop screens. |
| Products per Row (Mobile) | Slider (1–2) | Product columns per step on mobile devices. |
| Product Card Aspect Ratio | Select | Square (1:1), Portrait (3:4), or Landscape (4:3). |
| Show Variant Selector | Checkbox | Allows size or color options to be selected inside a bundle card. |
| Show Quantity Counter on Card | Checkbox | Enables increment and decrement controls for each product. |
Sticky Bundle Summary Footer
| Setting | Type | Description |
|---|---|---|
| Sticky Summary Bar | Checkbox | Persistent bottom bar showing selected items, savings, and checkout action. |
| Summary Background Color | Color Picker | Background color of the floating summary bar. |
| Summary Text Color | Color Picker | Text color for item count and pricing total. |
| Checkout Button Text | Text | CTA label, such as Add Bundle to Cart or Complete My Box. |
| Checkout Button Background | Color Picker | Primary checkout button background. |
| Checkout Button Text Color | Color Picker | Primary checkout button label color. |
| Show Discount Savings Pill | Checkbox | Displays a badge with the amount or percentage saved. |
Colors & Theme Styling
| Setting | Type | Description |
|---|---|---|
| Section Background | Color Picker | Background of the entire section. |
| Heading / Title Color | Color Picker | Section headline and step title color. |
| Text Color | Color Picker | Body copy and step-description color. |
| Progress Bar Track Color | Color Picker | Inactive progress-track color. |
| Progress Bar Fill Color | Color Picker | Active accent showing discount progress. |
| Card Background | Color Picker | Background of each product card. |
| Card Border Color | Color Picker | Product-card border color. |
| Active / Selected Card Outline | Color Picker | Highlight outline for a selected product. |
Section Spacing
| Setting | Type | Description |
|---|---|---|
| Top Padding | Slider (0–120px) | Vertical space above the section. |
| Bottom Padding | Slider (0–120px) | Vertical space below the section. |
Block Type: Step (step)
Add Step blocks to define each stage, for example choosing a base, toppings, or accessories.
| Setting | Type | Description |
|---|---|---|
| Step Title | Text | Name of the step. |
| Step Description | Inline Rich Text | Instructions or guidelines for the step. |
| Collection | Collection Picker | Shopify collection supplying products for this step. |
| Minimum Required Items | Number | Minimum number of selections required before proceeding. |
| Maximum Allowed Items | Number | Optional cap on selections in this step. |
Built-in Features
- Dynamic tier progress: Updates as items are added or removed and indicates how many more items unlock the next discount.
-
Batch AJAX cart submission: Sends selected variant IDs and quantities in one
/cart/add.jsrequest, with line-item properties linking bundle members. - Multi-step state preservation: Retains selections while customers navigate between steps.
- Variant integration: Supports variant dropdowns and swatches in bundle cards.
- Mobile sticky summary: Condenses the summary bar on mobile and provides quick drawer access to review bundle items.

Custom Slideshow — Three Slide Design
The Custom Slideshow supports three block types: Slide (full-bleed image and text), Media with Text (55/45 split), and Three Fold (image | text | image).
Performance
| Setting | Type | Description |
|---|---|---|
| Enable LCP optimization | Checkbox | Prioritizes the first slide image for faster paint. Turn this off if the section is below the fold. |
Slideshow Settings
| Setting | Type | Description |
|---|---|---|
| Auto-play slides | Checkbox | Automatically advances slides. |
| Slide duration | Slider (3–12s) | Time each slide remains visible. |
| Pause on hover | Checkbox | Stops autoplay while the pointer hovers over the slideshow. |
| Transition style | Select | Slide (horizontal pan) or Fade (crossfade). |
| Pagination style | Select | None, Dots, or Bars (progress indicators). |
| Show navigation arrows | Checkbox | Displays previous and next controls. |
Desktop Layout
| Setting | Type | Description |
|---|---|---|
| Full width | Checkbox | Spans edge-to-edge without side padding. |
| Rounded corners | Checkbox | Applies corner rounding to the slideshow container. |
| Height | Select | Small (450px), Medium (550px), Large (650px), Extra Large (750px), or Fullscreen. |
| Padding top | Slider (0–100px) | Vertical space above the section. |
| Padding bottom | Slider (0–100px) | Vertical space below the section. |
Mobile Layout
| Setting | Type | Description |
|---|---|---|
| Full width on mobile | Checkbox | Spans edge-to-edge on mobile. |
| Rounded corners on mobile | Checkbox | Applies corner rounding on mobile. |
| Height on mobile | Select | Small (250px), Medium (350px), Large (450px), Extra Large (550px), or Fullscreen. |
| Padding top | Slider (0–100px) | Vertical space above the section on mobile. |
| Padding bottom | Slider (0–100px) | Vertical space below the section on mobile. |
Block Type: Slide
A full-bleed image with overlaid content positioned in any of nine grid positions.
Media
| Setting | Type | Description |
|---|---|---|
| Desktop image | Image Picker | Main image for desktop. |
| Mobile image (optional) | Image Picker | Alternative image for mobile screens. |
| Slide link | URL | Makes the entire slide clickable. |
| Overlay opacity | Slider (0–100%) | Controls the darkness of the tint layer over the image. |
| Hosted video | Video Picker | Shopify-hosted video; overrides the image. |
| Autoplay video (muted) | Checkbox | Plays video automatically in a muted loop. |
| Show sound toggle | Checkbox | Displays a mute/unmute control. |
| YouTube / Vimeo URL | Video URL | External video source. |
| Video alt text | Text | Accessibility description for the video. |
Content
| Setting | Type | Description |
|---|---|---|
| Subheading | Text | Small text above the heading. |
| Heading | Text | Main slide title. |
| Heading tag | Select | H1, H2, H3, or Paragraph. |
| Heading size (px, desktop) | Number | Desktop heading font size. |
| Body text | Rich Text | Paragraph content below the heading. |
| Content position | Select | Nine-position grid: top/middle/bottom × left/center/right. |
Buttons
| Setting | Type | Description |
|---|---|---|
| Button 1 / Button 2 label | Text | Text displayed on each CTA button. |
| Button 1 / Button 2 link | URL | Destination for each button. |
| Button 1 / Button 2 style | Select | Primary (solid), Secondary (outline), or Text link. |
| Open in new tab | Checkbox | Opens the corresponding link in a new browser tab. |
Slide Colors
| Setting | Type | Description |
|---|---|---|
| Text color | Color Picker | Heading and body text color. |
| Primary button color | Color Picker | Primary button background. |
| Primary button text color | Color Picker | Primary button label color. |
| Secondary button color | Color Picker | Secondary button outline color. |
| Content background | Color Picker | Background behind text on mobile only. |
Block Type: Media with Text
Uses a 55% image / 45% text split side-by-side on desktop and stacks on mobile.
| Setting | Type | Description |
|---|---|---|
| Desktop image | Image Picker | Main image. |
| Mobile image (optional) | Image Picker | Alternative mobile image. |
| Image link | URL | Makes the image clickable. |
| Subheading / Heading / Body text | Text / Rich Text | Text content for the text panel. |
| Heading tag | Select | H1, H2, H3, or Paragraph. |
| Heading size (px, desktop) | Number | Desktop heading size. |
| Text alignment | Select | Left, Center, or Right. |
| Image position | Select | Image left or Image right. |
| Buttons | Same as Slide | Two buttons with label, link, style, and new-tab options. |
| Text panel background | Color Picker | Background color of the text column. |
| Text color | Color Picker | Heading and body text color. |
| Primary button colors | Color Pickers | Primary button fill and label colors. |
| Secondary button color | Color Picker | Secondary button outline color. |
Block Type: Three Fold Slide
Three-panel layout: left image, center text, right image.
| Setting | Type | Description |
|---|---|---|
| Left image (desktop / mobile) | Image Pickers | Left-side image and optional mobile alternative. |
| Left image link | URL | Makes the left image clickable. |
| Right image (desktop / mobile) | Image Pickers | Right-side image and optional mobile alternative. |
| Right image link | URL | Makes the right image clickable. |
| Subheading / Heading / Body text | Text / Rich Text | Content displayed in the center panel. |
| Heading tag | Select | H1, H2, H3, or Paragraph. |
| Heading size (px, desktop) | Number | Desktop heading size. |
| Text alignment | Select | Left, Center, or Right. |
| Buttons | Same as Slide | Two buttons with label, link, style, and new-tab options. |
| Center panel background | Color Picker | Background behind the center text column. |
| Text color | Color Picker | Center-panel heading and body text color. |
| Primary button colors | Color Pickers | Primary button fill and label colors. |
| Secondary button color | Color Picker | Secondary button outline color. |
Built-in Features
- Slide animations: Sequential element reveals with staggered timing.
- Media clip reveals: Image panels slide or fade into view according to block type.
- Ken Burns effect: Subtle zoom on active slide images.
- Touch swipe: Native swipe gestures on mobile.
- Keyboard navigation: Left/right arrow keys navigate slides.
- Autoplay pause: Pauses on hover, focus, or when the browser tab is hidden.
- Video support: Shopify-hosted, YouTube, and Vimeo videos.

Project Showcase
The Project Showcase section (sections/project-showcase.liquid) presents portfolio work, case studies, or featured projects in a 3D-stacked polaroid layout with interactive hover behavior.
Section Header Settings
| Setting | Type | Description |
|---|---|---|
| Heading | Text | Main section title, centered above the showcase. |
| Subheading | Text | Subtitle displayed beneath the main heading. |
| Heading color | Color Picker | Heading color; leave blank to inherit theme defaults. |
| Subheading color | Color Picker | Subheading color; leave blank to inherit theme defaults. |
| Project title & description color | Color Picker | Text color for card headings and summaries. |
Card Styling & Gradients
| Setting | Type | Description |
|---|---|---|
| Corner radius (px) | Slider (0–40px) | Corner radius for cards and inner image frames. |
| Card gradient — top color | Color Picker | Starting color of the card’s vertical gradient. |
| Card gradient — bottom color | Color Picker | Ending color of the card’s vertical gradient. |
| Image shadow color | Color Picker | Drop-shadow color and opacity for stacked preview cards. |
| Image padding | Slider (0–60px) | Space between preview images and card edges. |
Button Styling
| Setting | Type | Description |
|---|---|---|
| Button corner radius (px) | Slider (0–40px) | Corner roundness for project CTA buttons. |
| Button background | Color Picker | Default button fill. |
| Button text color | Color Picker | Default button label color. |
| Button border | Color Picker | Button outline color. |
| Button background (hover) | Color Picker | Button fill on hover or focus. |
| Button text color (hover) | Color Picker | Button label color on hover or focus. |
Section Spacing
| Setting | Type | Description |
|---|---|---|
| Top padding | Slider (0–120px) | Vertical space above the section. |
| Bottom padding | Slider (0–120px) | Vertical space below the section. |
Block Customization: Project
Up to six Project blocks can be added. Each block renders one showcase card.
| Setting | Type | Description |
|---|---|---|
| Project / client name | Text | Title of the project or client. |
| Description | Textarea | Short overview or scope of work. |
| Feature full width | Checkbox | Spans the card across the full grid row with a 16:9 landscape ratio. |
| Image 1 (back, left) | Image Picker | Left background preview image, rotated −3° on desktop. |
| Image 1 alt text | Text | Accessible description for image 1. |
| Image 2 (front, center) | Image Picker | Centered foreground image. |
| Image 2 alt text | Text | Accessible description for image 2. |
| Image 3 (back, right) | Image Picker | Right background preview image, rotated +3° on desktop. |
| Image 3 alt text | Text | Accessible description for image 3. |
| Button label | Text | CTA text, such as View Project or Read Case Study. |
| Button link | URL | Destination for the project page or an external link. |
Built-in Interactive Features
- Stacked polaroid effect: Three overlapping images use angled offsets; standard cards use 9:16 portrait images and full-width cards use 16:9 landscape images.
- Interactive fan and focus: Hovering or keyboard-focusing an image brings it forward in full color while inactive images dim to grayscale.
- Container-query responsiveness: Column count, image angles, and typography adapt to container size.
- Stacking-context isolation: Preview layers stay contained below sticky headers and modals.

Testimonials Carousel
The Testimonials Carousel presents customer reviews in a sliding or fading carousel. Card treatments include glass, solid, outline, and no-card styles, with configurable navigation, ratings, and author details.
Background & Layout
| Setting | Type | Description |
|---|---|---|
| Background image | Image Picker | Full-width background behind the carousel. |
| Background color | Color Picker | Color behind or instead of the image. |
| Image overlay color | Color Picker | Tint color layered over the background image. |
| Image overlay opacity | Slider (0–90%) | Strength of the image overlay. |
| Content max width | Slider (800–1800px) | Maximum content container width. |
| Stretch content to full width | Checkbox | Ignores the max-width limit and spans the full container. |
| Padding top / bottom | Sliders (0–120px) | Vertical spacing above and below the section. |
Heading
| Setting | Type | Description |
|---|---|---|
| Heading | Text | Main section title. |
| Subheading | Text | Subtitle below the heading. |
| Heading position | Select | Left, Center, or Right. |
| Heading size — desktop | Slider (14–64px) | Desktop heading size. |
| Heading size — mobile | Slider (12–40px) | Mobile heading size. |
| Heading color | Color Picker | Heading text color. |
| Subheading size | Slider (12–28px) | Subheading font size. |
| Subheading color | Color Picker | Subheading text color. |
Carousel Behaviour
| Setting | Type | Description |
|---|---|---|
| Transition | Select | Slide (horizontal pan) or Fade (one card at a time). |
| Transition speed | Slider (200–1200ms) | Animation duration. |
| Testimonials per view (desktop) | Slider (1–3) | Visible desktop cards; ignored with Fade. |
| Gap between cards | Slider (0–48px) | Horizontal space between cards. |
| Loop back to start | Checkbox | Enables continuous looping. |
| Enable autoplay | Checkbox | Automatically advances slides. |
| Autoplay delay | Slider (2–10s) | Time between automatic transitions. |
| Pause autoplay on hover | Checkbox | Stops autoplay while hovering. |
Card Style
| Setting | Type | Description |
|---|---|---|
| Card style | Select | Glass (translucent with blur), Solid, Outline, or No card. |
| Card background | Color Picker | Card background color. |
| Glass background opacity | Slider (0–100%) | Transparency; applies to Glass style only. |
| Glass blur | Slider (0–30px) | Backdrop blur; applies to Glass style only. |
| Card border color | Color Picker | Card outline color. |
| Card border width | Slider (0–4px) | Border thickness. |
| Card corner radius | Slider (0–60px) | Corner roundness. |
| Card padding | Slider (12–64px) | Inner card spacing. |
| Card max width | Slider (40–100%) | Maximum card width when showing one at a time. |
| Card position | Select | Left, Center, or Right. |
| Card shadow | Select | None, Soft, or Strong. |
| Content alignment | Select | Left, Center, or Right text alignment. |
Testimonial Text
| Setting | Type | Description |
|---|---|---|
| Font size — desktop | Slider (12–36px) | Testimonial text size on desktop. |
| Font size — mobile | Slider (12–28px) | Testimonial text size on mobile. |
| Text color | Color Picker | Testimonial text color; also used for author details unless overridden. |
| Italic text | Checkbox | Applies italic styling to testimonial copy. |
| Author name color (optional) | Color Picker | Optional override for author names. |
| Author title / company color (optional) | Color Picker | Optional override for author metadata. |
Quote Icon
| Setting | Type | Description |
|---|---|---|
| Show quote icon | Checkbox | Displays a decorative quote icon. |
| Quote icon size | Slider (16–64px) | Quote icon dimensions. |
| Quote icon color | Color Picker | Quote icon fill color. |
Star Rating
| Setting | Type | Description |
|---|---|---|
| Stars position | Select | Above or below the testimonial text. |
| Star size | Slider (12–32px) | Star icon dimensions. |
| Filled star color | Color Picker | Filled-star color. |
| Empty star color | Color Picker | Unfilled-star color. |
Author
| Setting | Type | Description |
|---|---|---|
| Author layout | Select | Avatar beside name or avatar above name. |
| Show avatar | Checkbox | Displays author profile images. |
| Avatar size | Slider (36–96px) | Avatar dimensions. |
| Avatar shape | Select | Circle, Rounded square, or Square. |
| Avatar border width | Slider (0–4px) | Border thickness around avatars. |
| Avatar border color | Color Picker | Avatar border color. |
Arrows
| Setting | Type | Description |
|---|---|---|
| Show arrows | Checkbox | Displays navigation arrows. |
| Arrow position (desktop / tablet) | Select | Left and right of the card, or bottom beside the dots. |
| Show arrows on mobile | Checkbox | Displays arrows on mobile. |
| Arrow icon | Select | Chevron or Arrow. |
| Arrow button shape | Select | Circle, Rounded square, Square, or Icon only. |
| Arrow size — desktop | Slider (28–72px) | Desktop arrow-button dimensions. |
| Arrow size — mobile | Slider (24–56px) | Mobile arrow-button dimensions. |
| Arrow background / icon color / border color | Color Pickers | Arrow button fill, icon, and border colors. |
| Arrow border width | Slider (0–3px) | Arrow border thickness. |
| Arrow hover background / icon color | Color Pickers | Hover-state background and icon colors. |
| Arrow shadow | Checkbox | Adds a drop shadow to arrow buttons. |
Dots
| Setting | Type | Description |
|---|---|---|
| Show dots | Checkbox | Displays pagination dots. |
| Dot style | Select | Circle, Pill (active dot stretches), Line, or Square. |
| Dot size | Slider (6–20px) | Dot dimensions. |
| Gap between dots | Slider (4–24px) | Horizontal spacing between dots. |
| Dot color | Color Picker | Inactive dot color, shown semi-transparent. |
| Active dot color | Color Picker | Active dot color. |
| Dots / bottom arrows alignment | Select | Left, Center, or Right. |
| Space above dots | Slider (8–56px) | Vertical gap above the dots. |
Block: Testimonial
Add Testimonial blocks to populate the carousel.
| Setting | Type | Description |
|---|---|---|
| Testimonial text | Textarea | Review or quote content. |
| Author name | Text | Customer name. |
| Author title | Text | Job title or role. |
| Company (optional) | Text | Company or organization name. |
| Rating (stars) | Slider (0–5) | Star rating; set to 0 to hide stars. |
| Author avatar (optional) | Image Picker | Customer profile image. |
Built-in Features
- Glass effect: Translucent cards with backdrop blur.
- Slide or fade transitions: Horizontal movement or crossfade.
- Keyboard navigation: Arrow keys navigate the carousel.
- Touch swipe: Native drag and swipe gestures on mobile.
- Autoplay with pause: Pauses on hover, focus, or when the browser tab is hidden.
- Responsive layout: Adapts columns and sizing for tablet and mobile.

Store Locator
The Store Locator displays a searchable and filterable map plus a list of physical locations sourced from the store_location metaobject. It supports distance calculations, directions, and open/closed status.
Content
| Setting | Type | Description |
|---|---|---|
| Heading | Text | Main section title. |
| Subheading | Textarea | Descriptive text below the heading. |
Map
| Setting | Type | Description |
|---|---|---|
| Map height | Slider (320–900px) | Height of the map panel. |
| Default zoom | Slider (2–18) | Initial zoom level before a store or search is selected. |
| Default map center latitude | Text | Latitude for the initial map center, used before a location is known. |
| Default map center longitude | Text | Longitude for the initial map center. |
Store List
| Setting | Type | Description |
|---|---|---|
| Maximum stores to display | Slider (10–500) | Total number of stores loaded from the metaobject. |
| Store type filters | Text | Comma-separated types such as Retail, Outlet, Dealer. Values must match each store’s Store Type field. |
| Show store images | Checkbox | Displays store images on cards. |
| Show phone number | Checkbox | Displays phone numbers on cards. |
| Show filters | Checkbox | Displays store-type filter chips above the list. |
| Show distance filter | Checkbox | Displays a radius dropdown to filter by proximity. |
| Distance filter options (km) | Text | Comma-separated distances, such as 5, 10, 15, 25, 50. |
| Distance filter label | Text | Label for the distance dropdown. |
| Show "use my location" button | Checkbox | Displays geolocation control in the search bar. |
Labels
| Setting | Type | Description |
|---|---|---|
| Search button | Text | Label for the search submit button. |
| Locate button (aria-label) | Text | Accessibility label for the geolocation button. |
| Directions button | Text | Label for the Get Directions button. |
| Open in Google Maps link | Text | Label for the external Google Maps link. |
Style
| Setting | Type | Description |
|---|---|---|
| Accent color | Color Picker | Primary brand color for buttons and active states. |
| Card background | Color Picker | Background of store cards. |
| Border color | Color Picker | Border and separator color. |
| Corner radius | Slider (0–24px) | Corner radius for cards and inputs. |
| Map marker color | Color Picker | Color of map pin markers. |
| Get Directions button background | Color Picker | Directions button fill color. |
| Get Directions button text | Color Picker | Directions button label color. |
Block: Benefit
Add up to four Benefit blocks to show feature highlights below the map.
| Setting | Type | Description |
|---|---|---|
| Icon | Select | Pin, Clock, Shield, or Truck. |
| Heading | Text | Benefit title. |
| Text | Textarea | Short benefit description. |
Built-in Features
- Live search: Geocodes addresses and filters stores by proximity.
- Distance calculation: Shows the distance in kilometers for each store after a location search.
- Store-type filters: Clickable chips filter stores by type.
- Radius filter: Limits results to stores within the selected distance.
- Geolocation: The “Use my location” control searches around the current position.
- Directions: Shows an inline route on the map and an external Google Maps link.
- Real-time hours: Displays Open now or Closed based on each store’s timezone and opening hours.
- Map controls: Satellite/terrain toggle and fullscreen button.
- Keyboard accessibility: Supports keyboard and screen-reader navigation.
- SEO: Emits schema.org JSON-LD for local business markup.
Metaobject: store_location
Each store must be defined as a store_location metaobject entry. The following fields are documented:
| Field | Required | Description |
|---|---|---|
| active | Yes | Boolean; only active stores are shown. |
| store_name | Yes | Store name. |
| latitude | Yes | Decimal latitude. |
| longitude | Yes | Decimal longitude. |
| address_line_1 | Yes | Street address. |
| address_line_2 | No | Suite or unit number. |
| city | Yes | City name. |
| state | Yes | State or province. |
| postal_code | Yes | Postal or ZIP code. |
| country | Yes | Country. |
| store_type | No | Type label, such as Retail or Outlet. |
| phone | No | Phone number. |
| hours | No | JSON object containing opening hours. |
| timezone | No | IANA timezone, such as America/New_York. |
| image | No | Store photo. |
| maps_url | No | Override URL for directions. |
| website | No | Store website URL. |

Product Showcase
The Product Showcase section (sections/product-showcase.liquid) is a responsive product grid and carousel. It supports collection-based or manual product feeds, color swatches, Quick Add and Quick View, comparison, wishlist integration, and wholesale pricing.
Content & Source Settings
| Setting | Type | Description |
|---|---|---|
| Heading | Text | Main headline above the section. |
| Subheading | Text | Italicized subtitle beneath the heading. |
| Description | Rich Text | Optional paragraph for context or promotions. |
| Product source | Dropdown | Collection or manually selected products. If any Product blocks are added, manual mode is used regardless of this setting. |
| Collection | Collection Picker | Collection to load when Collection source is selected. |
| Number of products to show | Slider (2–24) | Number of collection products to load. |
| Show all products in collection | Checkbox | Overrides the product count and renders all collection items. |
Layout & Responsiveness
| Setting | Type | Description |
|---|---|---|
| Display mode | Dropdown | Carousel (scrollable slider) or Grid (multi-row layout). |
| Products per row (Desktop) | Slider (2–6) | Visible columns/slides above 989px. |
| Products per row (Tablet) | Slider (2–4) | Visible columns/slides from 750px to 989px. |
| Products per row (Mobile) | Slider (1–3) | Visible columns/slides below 750px. |
| Spacing between cards | Slider (0–40px) | Horizontal and vertical gaps between cards. |
| Card corner radius | Slider (0–24px) | Corner radius on cards and inner images. |
| Enable card hover shadow / lift | Checkbox | Adds subtle elevation and a floating lift on hover. |
| Image aspect ratio | Dropdown | Square (1:1), Portrait (3:4), Landscape (4:3), or Original ratio (auto). |
| Equal height product cards | Checkbox | Matches card heights in each row so prices and buttons align. |
Carousel Controls
These controls apply only when Display Mode is set to Carousel.
| Setting | Type | Description |
|---|---|---|
| Enable autoplay | Checkbox | Automatically slides through products and pauses on hover. |
| Autoplay speed | Slider (2–10s) | Interval between automatic transitions. |
| Infinite loop | Checkbox | Allows continuous looping beyond the first and last slides. |
| Show navigation arrows | Checkbox | Displays previous and next controls in the section header. |
| Show pagination dots | Checkbox | Displays clickable slide indicators below the cards. |
Product Card Features & Badges
| Setting | Type | Description |
|---|---|---|
| Show vendor / product type | Checkbox | Displays product type or vendor above the title. |
| Show product rating | Checkbox | Displays five-star ratings from standard Shopify review metafields. |
| Show compare-at price | Checkbox | Shows the original strikethrough price when a product is on sale. |
| Show sale badge | Checkbox | Displays a badge on discounted products. |
| Sale badge style | Dropdown | Amount saved (for example, Save $15) or Percent off (for example, −25%). |
| Show product labels | Checkbox | Displays badges from product tags, including tags formatted as label:Text. |
| Show wishlist icon | Checkbox | Shows a heart icon synced with the theme’s global wishlist store. |
| Show Quick Add button | Checkbox | Adds the active variant to cart using Ajax. |
| Show Quick Look / Quick View | Checkbox | Opens an in-page modal with product image, details, and Add to Cart. |
| Show color swatches | Checkbox | Shows interactive dots for products with a Color or Color variant option. |
Color Swatches Configuration
| Setting | Type | Description |
|---|---|---|
| Swatch size | Slider (16–40px) | Dimensions of color swatch circles or squares. |
| Swatch corner radius | Slider (0–50%) | 50% is circular, 0% is square, and intermediate values create rounded squares. |
| Swatch border color | Color Picker | Outline color for inactive swatches. |
| Active swatch border color | Color Picker | Border or ring color for the selected swatch. |
Interactive swatch behavior: Selecting a swatch updates the primary image, price, compare-at price, and selected variant ID used for Quick Add. Standard color names such as Navy, Sage, Terracotta, and Camel are mapped to hex values.
Wholesale Pricing
-
Automatic detection: Logged-in customers with the customer tag
wholesalesee discounted pricing. - Display: The calculated wholesale rate appears in green alongside the crossed-out retail price, with a Wholesale -X% badge.
- Global percentage: Configured under Theme settings → Wholesale Pricing.
Colors & Styling
- Section background: Background of the full section container.
- Heading / title color: Main heading, subheadings, and product titles.
- Subheading / description color: Subtitle and description text.
- Card background and border: Product-card surface and outline.
- Price and compare price: Price highlight and strikethrough colors.
- Sale and label badges: Badge background colors.
- Button and accent colors: Quick Add buttons, carousel arrows, and active pagination dots.
Spacing
- Top padding (0–120px): adjusts spacing above the section.
- Bottom padding (0–120px): adjusts spacing below the section.
Block Customization: Manual Products
- Product: Select a specific product from the catalog.
- Custom label override: Override automatic tag labels with text such as Best Seller, Limited Edition, or Staff Pick.
Additional Built-in Capabilities
- Secondary image hover: Reveals the second product image on hover.
- Product compare toggle: Integrates with the theme’s compare-widget.
- Cart drawer and toast integration: Updates the cart drawer and shows a confirmation toast after adding a product.
- Mobile touch optimization: Uses native CSS scroll snapping for smooth swiping.
-
Accessibility and reduced motion: Respects
prefers-reduced-motionand provides keyboard and ARIA support.

Video + Image Split
The Video + Image Split section pairs an autoplaying video with an image panel carrying overlaid text and a call-to-action. Its layout can reverse on desktop and stack in a chosen order on mobile.
Performance
| Setting | Type | Description |
|---|---|---|
| Enable LCP optimization | Checkbox | Prioritizes the panel image for the fastest paint. Turn this off if the section is below the fold. |
Section Label
| Setting | Type | Description |
|---|---|---|
| Section label (above the section) | Text | Small label displayed above the section. |
| Label alignment | Select | Left, Center, or Right. |
| Label color | Color Picker | Label text color. |
| Gap below label (px) | Slider (0–60px) | Vertical space between the label and the section. |
Layout
| Setting | Type | Description |
|---|---|---|
| Video position | Select | Video left, image right, or video right, image left. |
| Full width | Checkbox | Removes side padding for an edge-to-edge layout. |
| Mobile stack order | Select | Video on top or image on top. |
| Hide video on mobile | Checkbox | Shows only the image panel on mobile screens. |
| Min height — desktop (px) | Slider (200–900px) | Minimum height for each desktop panel. |
| Min height — mobile (px) | Slider (160–700px) | Minimum height for each mobile panel. |
| Show box shadow | Checkbox | Adds a drop shadow to the section container. |
| Border radius (px) | Slider (0–32px) | Corner radius for the section. |
Divider Line
| Setting | Type | Description |
|---|---|---|
| Show center divider line | Checkbox | Displays a vertical line between the two panels. |
| Divider width (px) | Slider (1–8px) | Thickness of the divider. |
| Divider color | Color Picker | Divider line color. |
Video
| Setting | Type | Description |
|---|---|---|
| Shopify-hosted video (desktop) | Video Picker | Primary video for desktop. |
| Shopify-hosted video (mobile) | Video Picker | Alternative mobile video; falls back to the desktop video if blank. |
| YouTube or Vimeo URL | Video URL | External video used when no hosted video is selected. |
| Show scrim over video | Checkbox | Adds a dark tint over the video. |
| Video scrim opacity (%) | Slider (0–80%) | Controls the video overlay darkness. |
| Show play icon on placeholder | Checkbox | Displays a play icon before the video loads. |
Image
| Setting | Type | Description |
|---|---|---|
| Image | Image Picker | Background image for the image panel. |
| Image overlay color | Color Picker | Tint color layered over the image. |
| Image overlay opacity (%) | Slider (0–80%) | Controls overlay transparency. |
| Zoom image on hover | Checkbox | Adds a subtle scale-up animation on hover. |
Text Content
| Setting | Type | Description |
|---|---|---|
| Eyebrow text (inside image panel) | Text | Small label above the heading in the image panel. |
| Heading | Textarea | Main headline displayed over the image. |
| Heading HTML tag | Select | H1, H2, H3, or Paragraph. |
| Heading weight | Select | Light, Regular, Semibold, Bold, or Extrabold. |
| Subheading | Rich Text | Paragraph content below the heading. |
| Text vertical position | Select | Top, Middle, or Bottom. |
| Text horizontal position | Select | Left, Center, or Right. |
| Content inner padding (px) | Slider (16–80px) | Spacing inside the text area. |
Button
| Setting | Type | Description |
|---|---|---|
| Button label | Text | Call-to-action text. |
| Button URL | URL | Destination for the button. |
| Button style | Select | Solid (primary), Outlined (secondary), or Text link. |
| Show arrow icon on button | Checkbox | Displays an arrow next to the label. |
| Open link in new tab | Checkbox | Opens the destination in a new browser tab. |
| Button border radius (px) | Slider (0–40px) | Corner radius for the button. |
Colors
| Setting | Type | Description |
|---|---|---|
| Section background | Color Picker | Background color behind the section. |
| Heading color | Color Picker | Heading text color. |
| Subheading color | Color Picker | Subheading text color. |
| Button background | Color Picker | Button fill color. |
| Button text color | Color Picker | Button label color. |
| Button border color (outlined style) | Color Picker | Border color for outlined buttons. |
Spacing
| Setting | Type | Description |
|---|---|---|
| Padding top (px) | Slider (0–120px) | Vertical space above the section. |
| Padding bottom (px) | Slider (0–120px) | Vertical space below the section. |
Built-in Features
- Autoplay video: Hosted videos autoplay muted and looped, including iOS-compatible behavior.
- YouTube / Vimeo embeds: External videos can autoplay with native controls hidden.
- Mobile video swap: Use a separate video file on mobile for optimized loading.
- Responsive stacking: Side-by-side on desktop and stacked on mobile, with configurable order.
- Text positioning: Place text in a nine-position grid: top/middle/bottom × left/center/right.
- Video pause on scroll: Pauses video when it scrolls out of view to save battery.
- Accessibility: Keyboard navigation and screen-reader support.

Brand Story Slider
The Brand Story Slider combines a fixed two-image polaroid collage with a text carousel. The image pair stays in place while Story Slide blocks change, making it suited to brand narratives and milestones.
Layout
| Setting | Type | Description |
|---|---|---|
| Full width section | Checkbox | Lets the section background span edge-to-edge while keeping content within its maximum readable width. |
| Gap between images and text | Slider (20–100px) | Horizontal spacing between the image collage and text columns. |
| Image collage height (desktop) | Slider (300–700px) | Fixed height of the image collage on desktop. |
| Image collage height (mobile) | Slider (250–550px) | Fixed height of the image collage on mobile. |
Images — Fixed Across Slides
| Setting | Type | Description |
|---|---|---|
| Back image | Image Picker | Left-side tilted image in the collage. |
| Front image | Image Picker | Right-side elevated image in the collage. |
Photo Card Style
| Setting | Type | Description |
|---|---|---|
| Back card tilt angle | Slider (−20° to +20°) | Rotation angle for the back image. |
| Front card tilt angle | Slider (−20° to +20°) | Rotation angle for the front image. |
| Card border color | Color Picker | Border color around each image. |
| Card border width | Slider (0–16px) | Thickness of the image border. |
| Card corner radius | Slider (0–24px) | Corner radius for rounded image corners. |
Colors
| Setting | Type | Description |
|---|---|---|
| Section background | Color Picker | Background color of the entire section. |
| Eyebrow text color | Color Picker | Color for the small label above the heading. |
| Heading color | Color Picker | Main heading text color. |
| Body text color | Color Picker | Paragraph text color. |
| Accent color (links) | Color Picker | Color for inline links in body text. |
Button
| Setting | Type | Description |
|---|---|---|
| Button background | Color Picker | Button fill color. |
| Button text color | Color Picker | Button label color. |
Navigation Arrows
| Setting | Type | Description |
|---|---|---|
| Arrow background | Color Picker | Circular background for arrow buttons. |
| Arrow icon color | Color Picker | Arrow icon color. |
Section Spacing
| Setting | Type | Description |
|---|---|---|
| Top padding | Slider (0–120px) | Vertical space above the section. |
| Bottom padding | Slider (0–120px) | Vertical space below the section. |
Block: Story Slide
Add multiple Story Slide blocks to populate the text carousel.
| Setting | Type | Description |
|---|---|---|
| Eyebrow text | Text | Small label above the heading. |
| Heading | Text | Main slide title. |
| Body text | Rich Text | Paragraph content for the story slide. |
| Button text (optional) | Text | Call-to-action label. |
| Button link (optional) | URL | Destination URL for the button. |
Built-in Features
- Fixed image collage: Two stacked polaroid-style images remain visible across all slides.
- Text carousel: Horizontal transitions between story blocks.
- Responsive stacking: Images appear above text on mobile and beside it on desktop.
- Navigation arrows: Previous and next controls cycle through story slides.
- Automatic sizing: Collage proportions scale down on tablet without changing shape.

Shoppable Video Reels
The Shoppable Video Reels section displays portrait videos in an infinite-loop carousel, with a linked product card beneath each video and sound controls on the active reel.
Content
| Setting | Type | Description |
|---|---|---|
| Heading | Text | Main section title above the carousel. |
| Heading position | Select | Left, Center, or Right alignment. |
| Heading size — desktop (px) | Slider (14–64px) | Heading font size on desktop. |
| Heading size — mobile (px) | Slider (12–40px) | Heading font size on mobile. |
| Heading color | Color Picker | Heading text color. |
Slides
| Setting | Type | Description |
|---|---|---|
| Slide width (px) | Slider (160–380px) | Width of each video slide on desktop; scales down by 28% on mobile. |
| Gap between slides (px) | Slider (4–40px) | Horizontal spacing between slides. |
| Video corner radius (px) | Slider (0–32px) | Corner radius for video containers. |
Product Card
| Setting | Type | Description |
|---|---|---|
| Card background | Color Picker | Product card background color. |
| Card text | Color Picker | Product title color. |
| Card muted text | Color Picker | Vendor name and price color. |
| Card button background | Color Picker | Fill color for the icon button. |
| Card button hover | Color Picker | Button fill color on hover. |
| Card button icon | Color Picker | Icon color inside the button. |
Navigation
| Setting | Type | Description |
|---|---|---|
| Button background | Color Picker | Arrow button background fill. |
| Button border / dot color | Color Picker | Arrow-button border and inactive pagination-dot color. |
| Button hover background | Color Picker | Arrow button background on hover. |
| Button hover border | Color Picker | Border color on hover. |
| Button icon / active dot | Color Picker | Arrow icon and active pagination-dot color. |
Section
| Setting | Type | Description |
|---|---|---|
| Background | Color Picker | Section background color. |
| Padding top (px) | Slider (0–100px) | Vertical space above the section. |
| Padding bottom (px) | Slider (0–100px) | Vertical space below the section. |
Block: Reel
Add up to 12 Reel blocks to populate the carousel.
| Setting | Type | Description |
|---|---|---|
| Video | Video Picker | Shopify-hosted portrait video (9:16 aspect ratio). |
| Product | Product Picker | Product linked to the reel. |
Built-in Features
- Infinite-loop carousel: Clone-buffer technique loops through slides without a visible jump.
- Center-active scaling: Active slide scales to 100%; inactive slides scale to 88% with reduced opacity.
- Autoplay video: Only the active slide’s video plays; other videos pause and reset.
- Sound toggle: Mute/unmute control appears on the active slide.
- Product card: Shows product image, vendor, title, price, and an external-link icon.
- Touch swipe: Drag and swipe gestures work on mobile and desktop.
- Keyboard navigation: Left/right arrow keys navigate the carousel.
- Navigation controls: Previous/next buttons and dot indicators.
- Responsive sizing: Slide width scales down on mobile while preserving the 9:16 aspect ratio.

Countdown Product Showcase
The Countdown Product Showcase combines promotional copy and a live timer with a product carousel. It supports configurable expiry behavior, responsive product-card layouts, Quick Add, wishlist, and ratings.
Content
| Setting | Type | Description |
|---|---|---|
| Subtitle (optional) | Text | Small italicized text above the heading. |
| Heading | Text | Main section title. |
| Description | Rich Text | Optional paragraph for context. |
| Button text | Text | Call-to-action label; leave blank to hide the button. |
| Button link | URL | Destination URL for the button. |
Text Sizes
| Setting | Type | Description |
|---|---|---|
| Subtitle size | Slider (12–24px) | Subtitle font size. |
| Heading size — desktop | Slider (20–72px) | Main heading size on desktop. |
| Heading size — mobile | Slider (18–48px) | Main heading size on mobile. |
| Description size | Slider (12–22px) | Body text font size. |
| Button text size | Slider (11–20px) | Button label font size. |
Layout
| Setting | Type | Description |
|---|---|---|
| Content max width | Slider (1000–1800px) | Maximum container width. |
| Mobile alignment (heading & timer) | Select | Align the heading and timer left or center on mobile. |
Countdown
| Setting | Type | Description |
|---|---|---|
| Enable countdown timer | Checkbox | Shows or hides the countdown timer. |
| Countdown end date | Text | End date in YYYY-MM-DD format. |
| Countdown end time (24hr) | Text | End time in HH:MM format. |
| Timezone offset (hours from UTC) | Text | For example, -5 for EST, -4 for EDT, or 5.5 for IST. Leave blank to use the visitor’s local time. |
| Expiry message | Text | Message shown after the countdown ends. |
| Show days / hours / minutes / seconds | Checkboxes | Choose which time units appear. |
| Use leading zeros | Checkbox | Formats values as 01 instead of 1. |
Timer Style
| Setting | Type | Description |
|---|---|---|
| Timer box background | Color Picker | Background color for each time-unit box. |
| Timer number color | Color Picker | Countdown number color. |
| Timer label color | Color Picker | Color for labels such as Days and Hours. |
| Timer box corner radius | Slider (0–30px) | Corner radius for timer boxes. |
| Timer number size — desktop | Slider (18–64px) | Countdown number size on desktop. |
| Timer number size — mobile | Slider (16–40px) | Countdown number size on mobile. |
| Timer label size | Slider (8–16px) | Timer label font size. |
Products
| Setting | Type | Description |
|---|---|---|
| Select products | Product List (max 12) | Choose products to display and set their order. |
| Products per view — desktop | Slider (2–6) | Visible product cards on desktop. |
| Products per view — tablet | Slider (2–4) | Visible product cards on tablet. |
| Products per view — mobile | Slider (1–3) | One shows the image beside text; two or more places the image above text. |
| Gap between products | Slider (8–40px) | Horizontal gap between product cards. |
| Show slider arrows | Checkbox | Displays previous and next navigation arrows. |
| Show slider dots | Checkbox | Displays slide indicator dots below the carousel. |
| Show sale badge | Checkbox | Displays a Sale badge on discounted products. |
| Show Quick Add to Cart button | Checkbox | Enables one-click add-to-cart functionality. |
| Show wishlist icon | Checkbox | Displays the wishlist heart icon. |
| Show product rating | Checkbox | Displays star ratings for products with review data. |
Product Card Style
| Setting | Type | Description |
|---|---|---|
| Card layout (desktop & tablet) | Select | Image beside text or image above text. |
| Image size (when beside text) | Slider (48–160px) | Product image dimensions when beside the text. |
| Product title size | Slider (11–20px) | Product title font size. |
| Product price size | Slider (12–26px) | Product price font size. |
| Card corner radius | Slider (0–30px) | Product-card corner radius. |
| Card background | Color Picker | Product-card background color. |
| Card title / price color | Color Picker | Title and price text color. |
| Card muted text color | Color Picker | Product type and secondary text color. |
| Image placeholder / wishlist background | Color Picker | Background for missing images and the wishlist button. |
| Compare-at price color | Color Picker | Strikethrough price color. |
| Rating star color | Color Picker | Rating star fill color. |
| Badge background / text | Color Pickers | Sale badge background and label colors. |
| Wishlist heart (saved) | Color Picker | Heart fill color when a product is saved. |
| Quick Add button background / text | Color Pickers | Quick Add button fill and label colors. |
Background
| Setting | Type | Description |
|---|---|---|
| Background color | Color Picker | Section background color. |
| Background image (optional) | Image Picker | Full-width background image. |
| Enable overlay on background image | Checkbox | Adds a tint layer over the background image. |
| Overlay color | Color Picker | Overlay tint color. |
| Overlay opacity | Slider (0–90%) | Overlay transparency. |
Text & Accent Colors
| Setting | Type | Description |
|---|---|---|
| Heading color | Color Picker | Main heading text color. |
| Description / text color | Color Picker | Body text and subtitle color. |
| Button / arrows accent color | Color Picker | Button background and arrow-button fill. |
| Button / arrows text color | Color Picker | Button label and arrow icon color. |
Padding
| Setting | Type | Description |
|---|---|---|
| Top padding (desktop) | Slider (0–150px) | Vertical space above the section on desktop. |
| Bottom padding (desktop) | Slider (0–150px) | Vertical space below the section on desktop. |
| Top padding (mobile) | Slider (0–100px) | Vertical space above the section on mobile. |
| Bottom padding (mobile) | Slider (0–100px) | Vertical space below the section on mobile. |
Built-in Features
- Live countdown: Updates every second with animated number flips.
- Product carousel: Smooth slide transitions with touch and drag support.
- Quick Add: Ajax add-to-cart with instant feedback.
- Wishlist integration: Syncs with the theme’s global wishlist store.
- Responsive layout: Adapts automatically for tablet and mobile.
- Accessibility: Keyboard navigation and screen-reader support.

Content Glass Grid
The Content Glass Grid displays custom image-led cards in a responsive grid. Each card can include a heading, optional description, and button, with a glass-blur gradient rising from the bottom of the image.
Section Settings
| Setting | Type | Description |
|---|---|---|
| Section heading | Text | Main title displayed above the grid. |
| Subheading | Text | Subtitle below the heading. |
| Cards per row | Slider (2–4) | Number of desktop columns; the layout uses two columns on tablet and one on mobile. |
| Gap between cards | Slider (10–50px) | Horizontal and vertical spacing between cards. |
| Show card description | Checkbox | Shows or hides description text on each card. |
| Default button label | Text | Fallback label used when a card’s own button label is empty. |
Colors
| Setting | Type | Description |
|---|---|---|
| Subheading color | Color Picker | Subheading text color. |
| Card placeholder background | Color Picker | Background while an image loads or when no image is set. |
| Overlay tint color | Color Picker | Base color for the gradient overlay. |
| Overlay tint strength | Slider (0–80%) | Opacity of the gradient tint. |
| Heading / description color | Color Picker | Card heading and description text color. |
| Button background | Color Picker | Button fill color. |
| Button text | Color Picker | Button label color. |
| Button hover background | Color Picker | Button fill on hover. |
| Button hover text | Color Picker | Button label color on hover. |
Block: Card
Add up to 12 Card blocks to populate the grid.
| Setting | Type | Description |
|---|---|---|
| Image | Image Picker | Card background image in portrait 3:4 aspect ratio. |
| Heading | Text | Card title displayed over the image. |
| Description | Textarea | Short summary, truncated to 100 characters and clamped to two lines. |
| Button label | Text | Call-to-action text; leave empty to use the section’s default label. |
| Button link | URL | Destination URL for the button. |
Built-in Features
- Glass-blur gradient: Backdrop blur fades from bottom to top with a color gradient.
- Zoom on hover: The image scales up slightly when a card is hovered.
- Fade-up animation: Cards animate into view with staggered delays as the visitor scrolls.
- Responsive layout: Desktop grid, two columns on tablet, and one column on mobile.
- Mobile stack: Cards are centered at a maximum width of 480px on mobile.
- Accessibility: ARIA labels and keyboard navigation support.



