Documentation

Product page blocks: price, variants and buy buttons

Every block that drives the purchase on the Story Theme product page: price, variants, quantity, buy buttons, sticky bar, stock, delivery and personalization.

These are the blocks in the buy column: the ones customers look at right before they click. You'll find them under Add block, Product page category, inside the Product page section (and also in Featured product and the Quick view template). Each block follows the page's product; its Product setting, left empty, uses the nearest product.

The presentation blocks (title, rating, gallery, description, size guide…) are described in Product page blocks: content, and discounts, add-ons and subscriptions in Offer blocks.

Where these blocks are

In the shipped product page, the buy column is a Group block that holds, in order: Breadcrumb, Product rating, Product title, Price, Variant picker, Stock, Quantity, Buy buttons, Checklist, Delivery date, Product description and two accordions. The Sticky add to cart block is there but hidden.

  1. Open Edit theme > Products > Default product.
  2. In the Product page section, expand the buy column's Group.
  3. Click a block to set it up, or click Add block > Product page to add one.
Screenshot to take — Theme editor > Products > Default product: sidebar with the Product page section expanded, the buy column Group open and its blocks listed (Price, Variant picker, Stock, Quantity, Buy buttons…)

Price

Shows the price of the selected variant, the compare-at price, a discount badge and the tax note.

The Price block on the Sylys demo: compare-at price before the price and a -13% badge
The Price block on the Sylys demo: compare-at price before the price and a -13% badge
  • [Display] Show compare-at price and its Position (Before the price / After the price), Show discount badge (off by default) and its Badge value (Percentage / Amount), Show unit price, Show "from" price, Show Shop Pay Installments, Show the tax and shipping note.
  • [Offers] Price shown with an offer: Offer total, Total with add-ons, Price per item or Variant price. The price then follows the product's Offers, Purchase options and Add-ons blocks.
  • [Style] Size (Small to Extra large), Alignment, Price color, Sale price color, badge colors.

The compare-at price comes from the variant's Compare-at price field in Shopify. Shop Pay Installments only appears if it's turned on in your payment settings and the price is eligible.

Variant picker

The block that lets customers choose the size, color or format. It can show buttons, a list or a dropdown, and turns colors into swatches.

Size buttons as rounded pills on the Pulse demo
Size buttons as rounded pills on the Pulse demo
Square buttons on the Darly demo, with the Size guide link on the right
Square buttons on the Darly demo, with the Size guide link on the right
Color swatches on the Softy demo: Gold or Silver finish
Color swatches on the Softy demo: Gold or Silver finish
  • [Display] Type (Buttons, List, Dropdown), Show the selected value beside the option name, Show each option's price (List type), Hide option names.
  • [Colour swatches] Show colour options as swatches, Options shown as swatches (by default "Color, Colour, Couleur, Coloris"), Swatch content (Color / Variant photo), Swatch shape, Swatch size.
  • [Button appearance] Shape (Pill, Rounded, Square, Underline), Selected state (Filled, Outline, Thick border), borders, padding, sizes, Unavailable options (Dimmed, Struck through, Hidden) and colors.
  • [Offer cards] turns up to three option values into cards (Offer 1: option value, Badge, Title, Price text…). The value must be typed exactly as in Shopify. These cards only change the look: the variant is charged at its own price.
  • [Size guide] Show a size guide adds a link on the option whose name exactly matches Option that carries it ("Size" by default); it opens as a Centered window or a Side drawer.

All the details on swatches are in Variants and color swatches.

Quantity

The quantity selector, as a separate block so you can place it wherever you want.

The Quantity block in the Bordered box style on the Havn demo
The Quantity block in the Bordered box style on the Havn demo
  • [Display] Show the label, Show the quantity already in the cart (editable text, $qty = the quantity), Show volume pricing (B2B customers whose catalog includes quantity pricing).
  • [Appearance] Style (Bordered box, Separate buttons, Minimal), Size, Corners and colors.

The block respects Shopify's quantity rules (minimum, maximum, increment).

Buy buttons

The Add to cart button, with optional express checkout buttons, pickup availability, pre-order and back-in-stock alert.

The Lumyx demo buy button, with the price in the text and a second line "Ships within 24 hours"
The Lumyx demo buy button, with the price in the text and a second line "Ships within 24 hours"
The Sylys demo buy buttons: built-in quantity selector, "Add the gift set" button and express checkout
The Sylys demo buy buttons: built-in quantity selector, "Add the gift set" button and express checkout
  • [Button] Button text (empty = "Add to cart" in the store language; [price], [compare_price], [savings] and [percent] follow the selected offer), Second line under the text, Style, Icon, Width (Content, Half, Full).
  • Show a quantity selector and its style, Show the express checkout buttons (off by default), Show pickup availability, Let shoppers send a gift card to someone (gift cards only).
  • Show payment icons and a rating under the buttons: payment icons (or an Image instead), stars, Rating and Text beside the stars.
  • [Pre-order] Show pre-order (Never, Out of stock but still sold, Always), Pre-order button text, Message under the button (also saved on the order line).
  • [Back in stock] Notify me form (None, Email to the store, Klaviyo) and Text above the form, shown while the selected variant is sold out.
  • [Text above] a short text above the button, and its alignment.
The back-in-stock form on the Narvo demo: email field and "Notify me" button under a sold-out variant
The back-in-stock form on the Narvo demo: email field and "Notify me" button under a sold-out variant

Sticky add to cart

A bar that stays on screen when the page's buy button is out of view. Its button adds everything chosen on the page: variant, quantity, personalization and offer.

The sticky add to cart bar on the Sylys demo, at the bottom of the screen: image, title, variant, compare-at price, variant dropdown and button
The sticky add to cart bar on the Sylys demo, at the bottom of the screen: image, title, variant, compare-at price, variant dropdown and button
  • [Display] image, title, selected variant, compare-at price, Variant selector (None / Dropdown, which changes the variant for the whole page), Show quantity selector.
  • [Behavior] Appears (Once the add to cart button is out of view / As soon as the page scrolls), Hide at the bottom of the page, Show on.
  • [Position] Position (Bottom, Top, Floating), Position on mobile, Layout on mobile (Compact keeps the price and the button; Detailed).
  • [Button] Button text ([price], [compare_price]) and Button style; [Appearance] palette, Frosted glass, border, shadow, Full width.

Stock

A message that follows the selected variant's stock: in stock, running low, sold without stock, sold out.

The Stock block on the Maison Mocha demo: orange dot and "Only 4 left in stock"
The Stock block on the Maison Mocha demo: orange dot and "Only 4 left in stock"
The same block on the Softy demo when stock is sufficient: green dot and "In stock, ready to ship"
The same block on the Softy demo when stock is sufficient: green dot and "In stock, ready to ship"
  • [Display] Stock type: Stock managed on Shopify or Simulated figure. In Shopify mode: Running low at or below (10), and whether to show the In stock, Sold without stock and Sold out messages. In simulated mode: Figure, Lower the figure during the visit, One less every, Minimum simulated stock.
  • [Messages] Low stock ([quantity] = the number left), In stock, Sold without stock, Sold out.
  • [Indicator] Indicator (Dot, Bar, None), Full bar at, one color per state.
  • [Appearance] Style (Plain, Filled, Outline), size and alignment.

In Shopify mode, inventory tracking must be turned on for the variant; otherwise the block shows "in stock" with no number. A simulated figure isn't connected to your stock: the editor reminds you to keep it honest. See Stock bar and urgency.

Delivery date

Three dated steps (Ordered, Shipped, Delivered) or a single line, calculated in business days from today, in the store's time zone.

The Delivery date block as steps on the Havn demo: ordered Sep 26, shipped Sep 30, delivered Oct 2 to 5
The Delivery date block as steps on the Havn demo: ordered Sep 26, shipped Sep 30, delivered Oct 2 to 5
  • [Display] Layout (Steps / One line with [dates]), Icon style (Filled, Soft tint, Outline).
  • [Order step], [Shipping step], [Delivery step]: a Label and an Icon per step.
  • [Dates] Days to prepare order (1), Shortest shipping time (days) (2) and Longest shipping time (days) (4), Don't count weekends, Closed days (25/12, 01/01), Cut-off time (14:00), Show the time left before the cut-off and its Text ([timer], [date]), Date format.
  • [Appearance] Style (Plain, Filled, Outline), Highlight, size and alignment.

Public holidays aren't known automatically: add them in Closed days. The same calculation powers the Delivery estimate cart block. See Delivery estimate.

Free shipping progress

Shows what the cart is missing for free shipping, and updates with every addition.

The free shipping bar on the Softy demo: "Only €39 away from free shipping" on a light background
The free shipping bar on the Softy demo: "Only €39 away from free shipping" on a light background
On the Sylys demo, the product alone unlocks free shipping: "Free shipping with this product"
On the Sylys demo, the product alone unlocks free shipping: "Free shipping with this product"
  • Threshold (50 by default, in the store currency) and Thresholds per currency (for example USD:60;GBP:45).
  • [Messages] Progress message ([amount]), Say when this product unlocks free shipping and its message, Message once unlocked, Icon.
  • [Progress bar] show or hide, thickness, colors; [Appearance] Style (Plain, Filled, Outline), Highlight.

The block doesn't give anything away by itself: create the free shipping rate or a "Free shipping" discount in Shopify. See Free shipping bar.

Personalisation field

A field the customer fills in before adding to cart: text to engrave, a card message, a photo to print, a date, a wrapping choice. Presets: Engraving, Photo upload and Gift wrapping.

A required "Name to engrave" field on the Softy demo, limited to 10 characters with a counter
A required "Name to engrave" field on the Softy demo, limited to 10 characters with a counter
A long text field on the Darly demo: the message written on the card, 200 characters max
A long text field on the Darly demo: the message written on the card, 200 characters max
  • [Field] Field type (Short text, Long text, Number, Dropdown, Choice buttons, Checkbox, Date, File), Field title (it also names the value in the cart and the order), Placeholder, Choices (one per line), Default value, Help text, Required and Error message.
  • [Rules] Character limit and Show character counter, Height (lines), Earliest date, Accepted files (Images, Images and PDF, Any file) and Maximum size (1 to 20 MB), Number of fields (several photos, for example), Columns, Show only for these option values (for example With engraving), Hide from cart and order.
  • [Appearance] Field style (Outline / Filled), Show title, Show the required asterisk.

The value entered goes with the item and shows in the order. A Required field blocks adding to cart while it's empty, including from the sticky bar.

Learn more