Contents

Blocks are the pieces inside a section. Drag them to reorder; use the eye icon to hide one without deleting it.

General theme blocks

These can be added to the Product, Featured product, Rich text, Section, Article and Footer sections.

BlockSettings
KickerText: a small accent line above a heading
HeadingText; Size: Extra large, Large (default) or Medium
TextText (rich text); Size: Large (default) or Body
ButtonButton label (default "Learn more"), Link, Style: Primary, Secondary or Text link
Collapsible rowHeading (default "Shipping"), Content (rich text), Open by default (shoppers can still close it). Connect a product, page or article metafield as a dynamic source to show content that changes per item, such as a care guide or size chart. Also used for each question in the FAQ section
Custom LiquidLiquid: app snippets or other Liquid code

App blocks from apps you install appear under Apps in the Add block list of the Product, Featured product, Section and Specs and fitment sections.

Product page blocks

These go in the Product section (the buy box). The default product template uses them in this order: Product metadata, Title, Price, Fitment check, Variant picker, Buy buttons, Inventory, Assurance, Back-in-stock request, Pickup availability, Description.

BlockWhat it showsSettings
Product metadataA "Part no." pill with the selected variant's SKU and a copy button, and the vendor as a link when turned onShow vendor in metadata (off)
Product vendorThe brand, linked to its productsnone
TitleThe product titlenone
PricePrice, compare-at price, savings, unit price and the tax noteShow tax note (on)
Fitment checkWhether the part fits the shopper's saved vehicle (chapter 6)Show how many vehicles were checked (on), "Ask us about fitment" link (leave empty to use the fitment help page from Theme settings)
Variant pickerOption buttons, swatches or dropdowns (chapter 7)none
Buy buttonsQuantity, add to cart, accelerated checkout, subscriptionsShow subscription options (on; appears when the product has subscription plans), Show quantity selector (on), Show accelerated checkout buttons (on; customers see the payment methods available on their device), Show Shop Pay Installments (on; appears when it's enabled on your store), Show sticky add-to-cart bar (on; product pages only; appears when the add-to-cart button scrolls out of view), Returns note (shown under the button; leave empty to hide)
InventoryThe stock line with a coloured dot, such as "In stock" or "Only 3 left"Low stock threshold (10, 1 to 40)
AssuranceThree short rows with icons, such as a fitment guarantee, returns and shippingRow 1 to 3 icon and Row 1 to 3 text. Edit the example promises to match your store's real terms
Back-in-stock requestAn email form shown when the selected variant is sold outHeading (default "Notify me when it's back"), Text. Requests are emailed to your store's sender address. Nothing is sent to shoppers automatically: reply when the stock is back
Pickup availabilityWhether the variant can be picked up at your locations (chapter 7)none
DescriptionThe product descriptionnone
Spec tableA specifications table (see below)as below
Product linkA "View product" link, for Featured productnone

Specs and fitment blocks

The Specs and fitment section sits under the buy box on the product template. Section settings: Kicker (default "Before you buy"), Heading (default "Specs and fitment") and Background (Alternate by default). Part details spans the full width; the Spec table and Fitment table sit side by side on desktop and stack on smaller screens.

Part details: up to three tiles, each shown only when the product has the data.

  1. Part number: the selected variant's SKU, large, with a Copy part number button, and the barcode under it.
  2. Replaces OEM numbers: chips made from product tags that start with oem:, and a "Cross-reference:" line from tags that start with xref: (chapter 6).
  3. Install: a difficulty gauge (1 Bolt-on, 2 Easy, 3 Moderate, 4 Advanced, 5 Workshop fit), the install time and an Install guide (PDF) link.

Settings: Show part number (on), Show barcode (on), OEM number tag prefix (default oem:), Cross-reference tag prefix (default xref:), Show install details (on). Install details come from these product metafields, which you create in Settings › Custom data › Products:

Name (your choice)Namespace and keyType
Install difficultycustom.install_difficultyInteger (validation: minimum 1, maximum 5)
Install timecustom.install_timeSingle line text, such as "About 2 hours with hand tools"
Install guidecustom.install_guideFile (a PDF)

Spec table: rows from product data you already keep in Shopify, plus your own rows. Settings: Heading (default "Specifications"), Spec row position (Above or Below product details), Show SKU (on), Show product type (on), Show vendor in spec table (on), Show weight (on), Show barcode (off), Show variant options (on). Add Spec row blocks inside it:

  • Label (such as "Rotor diameter").
  • Product metafield: the metafield's namespace and key, such as specs.rotor_diameter, from Settings › Custom data › Products. Lists of text, yes/no values, measurements and dates are formatted for the shopper's language. For a category metafield, such as shopify.color-pattern, each entry's label is shown.
  • Value: used when Product metafield is empty. A typed value shows on every product that uses this template; a dynamic source shows each product's own value. Rows with no value are hidden.
  • Unit: shown after the value, such as mm or Ah. Leave it empty for weight, volume and dimension metafields, which include their unit.

Spec rows update when the shopper picks another variant, and the same rows are used on the comparison page.

Fitment table: the list of vehicles the part fits (chapter 6). Heading (default "Vehicle fitment"), Rows before "Show all" (6, 4 to 20), Show a filter box on long lists (on).

Product recommendations

The product template has two Product recommendations sections. Settings: Kicker, Heading (default "Customers also bought"), Recommendation type (Related products are similar; Complementary products pair with this one), Products to show (4, 2 to 10) and Background. Complementary products are chosen by you in Shopify's Search & Discovery app (Product recommendations); related products are picked by Shopify automatically.

Article blocks

The Article section (blog post template) is built from blocks: Breadcrumb, Title, Byline (Show author, on), Featured image, Content, Tags and Share, plus the general theme blocks. Reorder or hide them as you like.