Product blocks

Product blocks make up the buy box on the product page and in the Featured product section. They always show the product of the section they're in: there's no product to choose in the block.

Product title

This item has no settings.

The product name. On the product page, it's the page's main heading (h1).

Vendor

This item has no settings.

Shows the vendor set on the product in your Shopify admin, in small, muted interface text, which follows Interface case. Hidden when the product has no vendor. The block isn't in the default template: add it where you want it, for example above the product title.

Rating

This item has no settings.

Shows the product's rating: five stars filled up to the score, the score, and the number of reviews in parentheses, for example "4.6 (12)". Screen readers hear the full sentence ("Rated 4.6 out of 5, from 12 reviews"). The block has no settings of its own; the default template places it under the product title.

The theme doesn't collect reviews. The block reads Shopify's standard product rating metafields, reviews.rating and reviews.rating_count, which a reviews app fills: check in your app's settings that it saves its ratings there. A product without a rating shows nothing and keeps no space, in the theme editor too. To show the same rating on product cards, see Show ratings on product cards in Theme settings > Product.

Price

This item has no settings.

The block has no settings of its own.

• When the product is on sale, the strikethrough price (compare-at price) shows next to the price.
• The unit price shows when the variant has one (for example, "$2.50 per 100 ml").
• When a subscription plan is selected, the subscription price shows and the one-time purchase price is struck through.
• The tax and shipping note under the price ("Tax included. Shipping calculated at checkout.") is set for the whole store with Show tax and shipping note in Theme settings > Product.

Variant picker

This item has no settings.

Each option shows as swatches, image thumbnails, text, boxes, or a dropdown, depending on its content and the Option style setting. A text or box option with more values than Switch to a dropdown above, in the same theme settings, turns into a dropdown (swatches are never affected). See Choosing variants.

Selling plan

This item has no settings.

Shows the purchase options for a product sold by subscription (selling plans created by a subscription app such as Shopify Subscriptions): "One-time purchase" and each plan with its price. The block only shows for products that have selling plans. "One-time purchase" isn't offered if the product requires a subscription.

Buy buttons

This item has no settings.

The quantity selector, the dynamic checkout buttons, and the buy bar on phones are set for the whole store, in Theme settings > Product: they apply to every product page, featured product, and quick add at once.

• The quantity selector sits above the Add to cart button and follows the variant's quantity rules (minimum, maximum, increment): the starting value is the minimum. Its minus button is unavailable at the minimum, and its plus button at the maximum.
• The Add to cart button spans the full width of the column. It shows "Adding" while the item is added, then opens the cart drawer or cart page depending on Theme settings > Cart.
• Dynamic checkout buttons (Shop Pay, Apple Pay, PayPal, and so on) depend on the payment methods you've turned on. They take the height and shape of the theme's controls. They're hidden for gift cards.
• For a gift card, the block adds the "Send as a gift" form. See Gift card.
• For a sold out variant, the block shows "This selection is sold out." and a Browse the collection button, which leads to all your products. To show the note alone, for example to leave the place to a stock alert app's block, uncheck Link to the collection when sold out in Theme settings > Product.
• The Shop Pay Installments message shows in this block when it's turned on.

Pickup availability

This item has no settings.

For stores that offer local pickup (SettingsShipping and deliveryLocal pickup). The block shows whether the variant can be picked up at the first pickup location ("Pickup available at ...", with the preparation time). If there are several pickup locations, a Check other stores link opens a drawer that lists each location, its availability, and its address. The block updates when the variant changes and doesn't show if pickup isn't available anywhere.

SKU

This item has no settings.

Shows the SKU of the selected variant, in small print. Hidden when the variant has no SKU.

Description

This item has no settings.

Shows the full product description, below a divider. Hidden when the description is empty. For a description collapsed to a few lines, use the Expandable text block connected to the product description instead, as in the default template.

Related products

Pieces you choose yourself, shown in the buy box: pick them in Products, and set how many appear with Number of products to show (2 to 10, 4 by default). The product being bought is never offered. Each piece shows as a compact row (a small photo, its name and its price) with a quick add button. The default heading is "Related products". Until you pick products, the block shows two stand-in rows, including on your online store.

Not to be confused with the Product recommendations section, whose related products Shopify calculates automatically.

Complementary products

Shows the complementary products you've paired with the product in Shopify's Search & Discovery app, in the same compact rows as related products, up to Number of products to show (2 to 10, 4 by default). The default heading is "Complementary products". The default template has this block at the end of the buy box. When the product has no complementary products, or without JavaScript, the block keeps no place on your online store; in the theme editor, it shows a stand-in row so you can find and select it. See Product recommendations to set up the pairings.

Cross-sell

One piece you choose in Product, offered as a compact row with a quick add button: a matching belt, a care kit. The default heading is "Pairs well with". Until you pick a product, the block shows a stand-in row, including on your online store.

Gift wrapping

Offers a gift wrap with the product: a checkbox with its price. Create the wrapping as a product of its own and choose it in Wrapping product; keep it out of your collections and search, so it's only bought here. The checkbox's label is the Text setting, "Add gift wrapping" by default, whatever the wrapping product is called; if you clear it, the wrapping product's title is used.

• When the shopper checks the box, the wrapping is added in the same press as the product, and shows under its item in the cart, with its price and its own Remove link. Removing the item removes its wrapping too.
• With Offer a gift message, a "Gift message" field (200 characters) shows under the checkbox. The message travels with the wrapping and shows under it in the cart.
• The box isn't offered for a gift card, when the wrapping is sold out, or if the wrapping product is the product itself. On a product with several variants, it needs JavaScript; without it, the product is added alone.
• Until you choose a wrapping product, the block shows a stand-in box with your Text, including on your online store.

Product group

A container that arranges several blocks in a column or a row inside the buy box. It comes in two presets: Product column and Product row.

Unlike the Group block, the product group accepts every theme block, including product blocks: for example, a Product row with the price on the left and the SKU on the right. App blocks can't be placed in it.