Product blocks

Written in stage 2

What this is for, when to use it, its layouts, screenshots and examples. Everything below is generated from the theme’s schema, so it always matches the theme editor.

Badge

Used in: Product badges and in the 8 sections that accept any theme block.

Setting	Type	Default	Options and range
Label	Text	New
Style	Select	Soft	Solid Soft Outline

• Badge
  Starts with: empty

Product badges

Used in: Featured product, Product and in the 8 sections that accept any theme block.

Accepts:

• Badge

Setting	Type	Default	Options and range
Show sale badge	Checkbox	On
Sale badge text Shown when Show sale badge is on.	Select	Percentage saved	Sale Percentage saved Amount saved
Show sold out badge	Checkbox	On
Add a Badge block for each pill to display.

• Product badges
  Starts with: empty

Product bundle

Used in: Featured product, Product and in the 8 sections that accept any theme block.

Setting	Type	Default	Options and range
Heading	Text	Complete the look
Products from Complementary products come from the Search & Discovery app. A product list can be connected to a product metafield so each product carries its own set.	Select	Product list	Product list Complementary products
Products One to three products besides this one. Connect a product list metafield to give every product its own.	Products	—	up to 3
Show offer line	Checkbox	Off
Offer line Shown as written. The theme never calculates a saving: create an automatic discount in Shopify, and the cart shows it on the lines. Shown when Show offer line is on.	Text	Save 10% when you buy the full set

• Product bundle
  Starts with: empty

Buy buttons

Used in: Featured product, Product, Quick view and in the 8 sections that accept any theme block.

Setting	Type	Default	Options and range
Show quantity selector	Checkbox	On
Button style	Select	Primary	Primary Secondary
Show dynamic checkout buttons Hidden automatically on gift card products, which can’t use accelerated checkout with a recipient.	Checkbox	On
Show Shop Pay Installments Appears when Shop Pay Installments is turned on in your payment settings.	Checkbox	On
Show quantity rules Shows minimum, maximum and increment rules set for B2B catalogs.	Checkbox	On
Show volume pricing	Checkbox	On
Show back-in-stock request Shows an email field on sold out variants. Requests arrive as contact form messages that you answer yourself.	Checkbox	Off
Purchase options for subscriptions and the gift card recipient form appear automatically when a product needs them.

• Buy buttons
  Starts with: empty

Complementary products

Used in: Featured product, Product and in the 8 sections that accept any theme block.

Setting	Type	Default	Options and range
Shows the products you pair with this one in the Search & Discovery app. With no complementary products, the block shows nothing.
Heading	Text	Pairs well with
Products to show	Range	3	1–10, step 1
Layout	Select	List	List Carousel
Columns on desktop Shown when Layout is Carousel.	Range	2	1–4, step 1
Columns on mobile Shown when Layout is Carousel.	Select	2	1 2
Image ratio Shown when Layout is Carousel.	Select	Portrait	Adapt to image Square Portrait Landscape
Text on glass Auto picks dark or light text for each glass element from the brightness of the photo behind it. Shown when Layout is Carousel.	Select	Auto	Auto Light Dark
Show quick add	Checkbox	On

• Complementary products
  Starts with: empty

Ask a question

Used in: Featured product, Product and in the 8 sections that accept any theme block.

Setting	Type	Default	Options and range
Opens your store’s contact form with the product name and link already in the message. Messages arrive in your store’s email.
Link label	Text	Ask a question
Dialog heading Leave blank to use “Ask a question”.	Text	—
Text	Rich text	—
Show phone field	Checkbox	Off
Style	Select	Link	Link Button
Show icon	Checkbox	On

• Ask a question
  Starts with: empty

Custom Liquid

Used in: Featured product, Product, Quick view and in the 8 sections that accept any theme block.

Setting	Type	Default	Options and range
Liquid code Output store data using Liquid. Invalid code can break this block until fixed.	Liquid	—

• Custom Liquid
  Starts with: empty

Product description

Used in: Featured product, Product, Quick view and in the 8 sections that accept any theme block.

Setting	Type	Default	Options and range
Long descriptions	Select	Show in full	Show in full Show a preview
Lines shown Shown when Long descriptions is Show a preview.	Range	5	3–12, step 1
Show “View full details” link A link to the product page under the description. Quick view only. Shown when the section’s qv_gallery is set.	Checkbox	On

• Product description
  Starts with: empty

Fact

Used in: and in the 8 sections that accept any theme block.

Setting	Type	Default	Options and range
Icon	Select	Truck	None Truck Refresh Package Map pin Clock Shield Lock Check Gift Leaf Globe Heart Star Home Tag Ruler Chat Mail
Custom icon Replaces the icon. Use a square image with a transparent background.	Image	—
Custom icon width Shown when Custom icon is set.	Range	24 px	16–48 px, step 4
Heading	Text	Complimentary delivery
Text	Inline rich text	On orders over $400
Link	Link	—

• Fact
  Starts with: empty

Facts

Used in: Featured product, Product and in the 8 sections that accept any theme block.

Accepts:

• Any theme block

Setting	Type	Default	Options and range
Short promises in one panel. Add a Fact block for each row.
Style	Select	Panel	Panel Plain
Color scheme Shown when Style is Panel.	Color scheme	Scheme 2
Lines between facts	Checkbox	On

• Facts
  Starts with: Fact, Fact

Icon with text

Used in: Featured product, Product and in the 8 sections that accept any theme block.

Setting	Type	Default	Options and range
Icon	Select	Truck	None Truck Refresh Package Map pin Clock Shield Lock Check Gift Leaf Globe Heart Star Home Tag Ruler Chat Mail
Custom icon Replaces the icon. Use a square image with a transparent background.	Image	—
Custom icon width Shown when Custom icon is set.	Range	32 px	16–64 px, step 4
Icon style	Select	Plain	Plain Circle
Heading	Text	Free returns within 30 days
Text	Inline rich text	Unused items in their original packaging
Link Makes the whole block a link.	Link	—
Layout	Select	Beside text	Beside text Above text

• Icon with text
  Starts with: empty

Inventory status

Used in: Featured product, Product and in the 8 sections that accept any theme block.

Setting	Type	Default	Options and range
Shows only for variants whose inventory Shopify tracks and that stop selling when out of stock.
Low stock threshold	Range	5	1–50, step 1
Show “In stock” Off: only low stock and sold out are shown.	Checkbox	Off
Show quantity	Select	When stock is low	Never When stock is low Always
Display	Select	Text	Text Text and bar
Show status dot	Checkbox	On

• Inventory status
  Starts with: empty

Pickup availability

Used in: Featured product, Product and in the 8 sections that accept any theme block.

Setting	Type	Default	Options and range
Shows whether the selected variant can be picked up, and at which locations. Set up local pickup in Shipping and delivery. With no pickup location, the block shows nothing.

• Pickup availability
  Starts with: empty

Popup

Used in: Featured product, Product and in the 8 sections that accept any theme block.

Setting	Type	Default	Options and range
Link label Leave blank to use the page title.	Text	Size guide
Dialog heading Leave blank to use the link label.	Text	—
Content	Select	Page	Page Text Video
Page Used when the content is a page.	Page	—
Text Shown when Content is Text.	Rich text	—
Video Shown when Content is Video.	Video	—
Style	Select	Link	Link Button
Icon	Select	Ruler	None Ruler Truck Refresh Leaf Play Gift Shield Chat

• Popup
  Starts with: empty

Product price

Used in: Featured product, Product, Quick view and in the 8 sections that accept any theme block.

Setting	Type	Default	Options and range
Size	Select	Large	Large Medium
Show compare-at price	Checkbox	On
Sale badge Shown when Show compare-at price is on.	Select	Percentage saved	None Sale Percentage saved Amount saved
Show “Sold out” label Shown beside the price when no variant can be bought.	Checkbox	On
Show tax and shipping note When prices include taxes, a tax note always shows.	Checkbox	On
Unit prices show automatically for variants that have one.

• Product price
  Starts with: empty

Product rating

Used in: Featured product, Product and in the 8 sections that accept any theme block.

Setting	Type	Default	Options and range
Shows the rating that a reviews app saves to the product’s reviews.rating metafield.
Text style	Select	Stars and score	Stars and score Stars Number
Show review count	Checkbox	On
Reviews link Where the reviews are on the page, such as #reviews. Leave blank for no link.	Text	—	Placeholder: “#reviews”

• Product rating
  Starts with: empty

Secure checkout

Used in: Featured product, Product and in the 8 sections that accept any theme block.

Setting	Type	Default	Options and range
Payment icons come from the payment methods enabled in Payments, so they always match your checkout.
Heading	Text	Secure checkout
Text	Inline rich text	Your payment details are encrypted and never stored.
Show lock icon	Checkbox	On
Show payment icons	Checkbox	On
Style	Select	Plain	Plain Panel

• Secure checkout
  Starts with: empty

Share

Used in: Featured product, Product and in the 8 sections that accept any theme block.

Setting	Type	Default	Options and range
Heading	Text	Share
Show copy link On phones, this button opens the device’s share options instead.	Checkbox	On
Networks
Networks	Select	Names	Names Icons
Facebook	Checkbox	On
X	Checkbox	On
Pinterest	Checkbox	On
WhatsApp	Checkbox	Off

• Share
  Starts with: empty

Product siblings

Used in: Featured product, Product, Quick view and in the 8 sections that accept any theme block.

Setting	Type	Default	Options and range
Shows the other colors of this product, each its own product. Set up the data in Theme settings › Product siblings.
Heading Leave empty to use “Color” in the store’s language.	Text	—
Swatches	Select	Swatch	Swatch Swatch and label Product image
Swatch size	Select	Medium	Small Medium Large
Swatch shape Shown when Swatches is not Product image.	Select	Circle	Circle Square Rounded
Show selected value	Checkbox	On
Layout “Single row” scrolls sideways when the swatches don’t fit.	Select	Wrap	Wrap Single row

• Product siblings — Category: Product
  Starts with: empty

SKU

Used in: Featured product, Product and in the 8 sections that accept any theme block.

Setting	Type	Default	Options and range
Show label	Checkbox	On

• SKU
  Starts with: empty

Specification

Used in: Specifications and in the 8 sections that accept any theme block.

Setting	Type	Default	Options and range
Label	Text	Material
Value Connect a metafield to fill it per product. Rows with no value are hidden.	Inline rich text	—

• Specification
  Starts with: empty

Specifications

Used in: Featured product, Product and in the 8 sections that accept any theme block.

Accepts:

• Specification

Setting	Type	Default	Options and range
Add a row for each detail. Connect a row’s value to a metafield to fill it per product; rows with no value are hidden.
Heading	Text	Specifications
Layout	Select	Two columns	Two columns Stacked Rows
Show dividers	Checkbox	On

• Specifications
  Starts with: Specification, Specification, Specification

Product title

Used in: Featured product, Product, Quick view and in the 8 sections that accept any theme block.

Setting	Type	Default	Options and range
Size	Select	Extra large	Extra large Large Medium
Uppercase	Checkbox	Off
The product title is always the page’s main heading (H1).

• Product title
  Starts with: empty

Variant picker

Used in: Featured product, Product, Quick view and in the 8 sections that accept any theme block.

Setting	Type	Default	Options and range
Picker style Options with swatches always show as buttons.	Select	Buttons	Buttons Dropdown
Swatches Swatches come from the option’s color and image values in the product’s category metafields.	Select	Swatch	Swatch Swatch and label Label only
Swatch shape Shown when Swatches is not Label only.	Select	Circle	Circle Square Rounded
Swatch size Shown when Swatches is not Label only.	Select	Medium	Small Medium Large
Show selected value	Checkbox	On
Hide options with one value The value is still selected. Useful when sibling products show the color.	Checkbox	On
Unavailable values	Select	Cross out	Cross out Hide
Size guide
Size guide page Opens in a dialog beside the option named below. Add a table to the page to show measurements.	Page	—
Show beside option The option names to show it beside, separated by commas — for example, “Size, Ring size”. Shown when Size guide page is set.	Text	Size
Link label Leave blank to use the page title. Shown when Size guide page is set.	Text	—
Measurements in Customers can switch the page’s table between centimeters and inches. Size columns (EU, US, UK) are never converted. Shown when Size guide page is set.	Select	Centimeters	Centimeters Inches Don’t convert

• Variant picker
  Starts with: empty

Vendor

Used in: Featured product, Product, Quick view and in the 8 sections that accept any theme block.

Setting	Type	Default	Options and range
Link to vendor collection	Checkbox	On
Text style	Select	Caption	Caption Body

• Vendor
  Starts with: empty