Shopify theme documentation

Altiora
Customization Guide

A practical reference for configuring Altiora’s navigation, product experiences, collection layouts, storytelling sections, and interactive shopping features.

22 customization guides Responsive documentation Theme editor reference

Header & Navigation

Altiora's header is a responsive navigation system with five desktop layout options, mega-menus with collection products and promotional cards, sticky positioning, search integration, and synchronized cart and wishlist counters.

Desktop Header

Desktop Layout Modes

Choose a layout in Desktop Header Layout (header_layout).

Layout Key How it appears
Sidebar Trigger sidebar A hamburger trigger stays on the left, with an optional compact teaser menu, centered logo, and action icons on the right. The full catalog opens in a slide-out drawer.
Centered + Mega Menu centered The logo is centered, search sits on the far left, and utility icons sit on the right. A full-width navigation row below supports dropdowns and mega-menus.
Logo Left + Inline Nav left_classic The logo and horizontal navigation share one row, with utility icons aligned to the far right.
Minimal (Logo Only) minimal A minimal header shows the logo and hamburger trigger. Search, account, wishlist, and cart icons appear inside the slide-out drawer.
Two Rows two_row The first row has a centered logo and right-aligned action icons. The second row has centered navigation with dropdown and mega-menu support.

Header & Branding Settings

Setting Type Description
Desktop Header Layout Select Select one of the five layout modes listed above.
Enable sticky header Checkbox Keeps the header fixed at the top of the viewport while scrolling.
Show bottom border line Checkbox Adds a subtle divider between the header and page content.
Logo image Image Picker Choose the store's brand logo.
Logo width - desktop Slider (50–250px) Sets the maximum logo width on desktop screens.
Logo width - mobile Slider (50–250px) Sets the maximum logo width on mobile screens.
Header vertical padding Slider (0–20px) Sets the top and bottom inner padding for header bars.
Maximum header height Slider (56–160px) Limits total header height to prevent oversized logos from expanding it.

Menu & Drawer Configuration

Setting Type Description
Main menu Menu Picker The primary navigation menu used by horizontal navigation and the mobile drawer.
Teaser menu Menu Picker A secondary quick-link menu shown in the top bar for the Sidebar Trigger layout.
Drawer title Text Heading shown inside the slide-out mobile/sidebar drawer. The default is Shop by.
Show search icon Checkbox Shows or hides the search icon and its modal trigger.

Mega-Menu Blocks & Promotional Banners

Attach visual content to a top-level navigation item by setting Link Name Title to exactly match the text of that item in the Main menu.

Promo Menu Block (promo_column)

Add up to four promotional cards below a navigation item's dropdown.

Setting Type Description
Link Name Title Text Exact top-level menu item name, such as New Arrivals or Sale.
Promo Image 1–4 Image Picker Thumbnail image for each promotional card.
Heading 1–4 Text Promotional card heading.
Caption 1–4 Text Short description or offer.
Button text 1–4 Text Optional call-to-action label.
Link 1–4 URL Destination for each card.

Category Menu Block (category_menu)

Creates a multi-column mega-menu with live collection product cards and banner images.

Setting Type Description
Link Name Title Text Exact top-level menu item name, such as Shop or Catalog.
Collections Collection list (up to 6) Each collection creates a category column on desktop and an accordion panel on mobile.
Image 1 & 2 Image Picker Promotional banner cards displayed alongside the category columns.
Number of products per category Slider (1–8) Number of product cards displayed for each collection.
Show product title Checkbox Displays product titles in mega-menu cards.
Show product price Checkbox Displays product prices in mega-menu cards.
Collection Page

Built-in Integrations & Accessibility

  • AJAX cart counter: Intercepts /cart/add, /cart/update, and /cart/change fetch requests to update the header cart badge without a full-page refresh.
  • Wishlist counter synchronization: Reads wishlist_handles from localStorage and updates the badge on page load, wishlist:updated events, and cross-tab storage events.
  • Sticky header parent detection: Detects nested .shopify-section wrappers and assigns sticky behavior to a suitable wt-sticky-host parent.
  • Keyboard and ARIA support: Mobile and sidebar drawers support keyboard navigation, including Escape to close and Space/Enter to toggle submenus. Body scrolling is locked while a drawer is active.

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 Page

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.
Swatch-Variants

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.js using AJAX, shows immediate button feedback (Adding… then Added!), and dispatches cart:updated so 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

  1. Open the Shopify theme editor.
  2. Go to Customize → Footer area → Add section → Compare Widget.
  3. 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.

Comparison Feature

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 active localStorage entries. 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

  1. In Shopify Admin → Online Store → Pages, create a page titled Compare Products.
  2. Set the page handle/URL slug to compare.
  3. Assign the compare template suffix (page.compare).
Comparison Page

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.

Rich Text with Image

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 PICTURE1 is present and Image 1 is selected, Altiora replaces the token with an inline image using the inline-icon class.
  • If an image link is provided, the image is wrapped in an anchor using the icon-link class.
  • 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.

Frequently Bought Together

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.

Collection Glass Grid

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.
Altiora Collection Bento Showcase

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 localStorage using window.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:updated window 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.
Wishlist Section

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:

  1. Compare Checkbox: Placed in the top corner of the card media, seamlessly hooked into the theme's global product comparison tool (snippets/compare-widget.liquid and window.PGSCompare).
  2. Product Image: Featured media thumbnail with lazy-loading enabled.
  3. Product Title & Price: Displays title, regular price, and strikethrough compare-at price when on sale.
  4. Quick Add Button: Adds the first available variant directly to the cart via AJAX /cart/add.js with instant loading/success state feedback and automatic cart drawer opening.

Storage & Synchronization Mechanics

  • Storage Key: shopify_recently_viewed in browser localStorage stores 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}.js asynchronously 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.
Recently Viewed Products Section

Flowing Menu

The Flowing Menu section (sections/flowing-menu.liquid) is a luxury interactive navigation component powered by GSAP. Hovering over any menu item triggers a direction-aware sliding marquee banner complete with continuous looping text and inline media thumbnails.

Section Dimensions & Speed

Setting Type Description
Section height (px) Slider (300–900px) Total fixed height allocated to the full-bleed menu container.
Marquee speed (seconds per loop) Slider (5–40s) Duration in seconds for one full horizontal cycle of the marquee animation (lower = faster).

Color Palette

Setting Type Description
Background color Color Picker Main resting background color of the section.
Menu item text color Color Picker Inactive link text color.
Item border color Color Picker Horizontal separator line color between menu items.
Marquee background color Color Picker Active background fill that slides into view on hover.
Marquee text color Color Picker Scrolling text color inside the active hover marquee.

Block: Menu Item (item)

Add Menu Item blocks to construct your flowing navigation list.

Field Type Description
Text Text Label displayed in the resting menu item and repeated across the marquee banner.
Link URL Destination link URL when the item is clicked.
Marquee image Image Picker Thumbnail image displayed between repeating text tokens inside the marquee stream.

Built-in Features & GSAP Engineering

  • Direction-Aware Edge Detection: Calculates mouse entry coordinates (mouseenter / mouseleave) relative to top/bottom element edges to slide the marquee layer smoothly from the direction of approach.
  • Infinite Loop Text Cloner: Dynamically calculates viewport width and appends duplicate marquee content nodes (marquee__part) to ensure gapless, uninterrupted horizontal scrolling.
  • Auto-Loading GSAP Engine: Automatically detects if GreenSock Animation Platform (GSAP 3) is present and dynamically injects the CDN script if missing.
  • Seamless Resize Observer: Recalculates repetition counts and animation timelines on window resize events to maintain seamless fluidity.
  • Responsive Viewport Typography: Uses scalable viewport-relative typography (4vh) to maintain proportional hierarchy across diverse screen sizes.
Flowing Menu

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 / touchend events 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.
Theme Blocks

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.js request, 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.
Theme Blocks

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.
Custom Slideshow Design

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.
Project Showcase

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.
Store Locator

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 wholesale see 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-motion and provides keyboard and ARIA support.
Product Showcase

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.
Video Image Text Split

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.
Brand Story Slider

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.
Shoppable Video Reels

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.
Countdown Product Showcase

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.
Content Glass Grid