Contents

Button, Collapsible row, Custom Liquid, Eyebrow, Heading and Text are general blocks: every section that accepts any theme block offers them, and so does the section Shopify creates when you generate a block in a new section. The other blocks work only in the sections listed beside them, and their files start with _ so that no other section offers them.

Back-in-stock request

File: blocks/_restock.liquid · Used in: Product

SettingTypeDefaultValuesNotes
"Heading"Text"Notify me when available"
"Text"Text"Leave your email and we'll write to you when it's back in stock."Requests are emailed to your store's sender address. Nothing is sent to shoppers automatically: reply when the stock is back.

Shown only while the selected variant is sold out. See Product page › Back-in-stock request.

File: blocks/_breadcrumb.liquid · Used in: Article

No settings. Shows the trail HOME / blog title / article title, the same breadcrumbs the other templates' sections show.

Button

File: blocks/button.liquid · Used in: Article, Featured product, Footer, Product, Rich text, Section (generated blocks)

SettingTypeDefaultValuesNotes
"Button label"Text"Learn more"
"Link"Link—Shown when "Button label" is set.

Buy buttons

File: blocks/_buy_buttons.liquid · Used in: Featured product, Product, Quick view

SettingTypeDefaultValuesNotes
"Show subscription options"CheckboxOnAppears when the product has subscription plans.
"Show quantity selector"CheckboxOn
"Show accelerated checkout buttons"CheckboxOnCustomers see the payment methods available on their device.
"Show Shop Pay Installments"CheckboxOnAppears when Shop Pay Installments is enabled on your store.
"Show sticky add-to-cart bar"CheckboxOnProduct pages only. Appears when the add-to-cart button scrolls out of view.
"Returns note"Text—Shown under the add-to-cart button. Leave empty to hide.

Byline

File: blocks/_byline.liquid · Used in: Article

SettingTypeDefaultValuesNotes
"Show author"CheckboxOn

Collapsible row

File: blocks/collapsible.liquid · Used in: Article, FAQ, Featured product, Footer, Product, Rich text, Section (generated blocks)

SettingTypeDefaultValuesNotes
"Heading"Text"Shipping"
"Content"Rich text—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.
"Open by default"CheckboxOffShoppers can still close it.

In the FAQ section each Collapsible row is one question. A new FAQ section's first question has "Open by default" on.

Content

File: blocks/_content.liquid · Used in: Article

No settings.

Custom Liquid

File: blocks/custom_liquid.liquid · Used in: Article, Featured product, Footer, Product, Rich text, Section (generated blocks)

SettingTypeDefaultValuesNotes
"Liquid"Liquid—With no output, shoppers see nothing and the theme editor shows a note in its place.

Description

File: blocks/_description.liquid · Used in: Featured product, Product

No settings.

Eyebrow

File: blocks/eyebrow.liquid · Used in: Article, Featured product, Footer, Product, Rich text, Section (generated blocks)

SettingTypeDefaultValuesNotes
"Text"Text"Eyebrow text"

File: blocks/_featured_image.liquid · Used in: Article

No settings.

Heading

File: blocks/heading.liquid · Used in: Article, Featured product, Footer, Product, Rich text, Section (generated blocks)

SettingTypeDefaultValuesNotes
"Text"Text"Heading"

Inventory

File: blocks/_inventory.liquid · Used in: Featured product, Product, Quick view

SettingTypeDefaultValuesNotes
"Low stock threshold"Range101 to 40, step 1

File: blocks/_menu.liquid · Used in: Footer

SettingTypeDefaultValuesNotes
"Heading"Text"Quick links"
"Menu"Menufooter

Newsletter

File: blocks/_newsletter.liquid · Used in: Footer

SettingTypeDefaultValuesNotes
"Heading"Text"Subscribe"
"Text"Text"Tell subscribers what they'll receive."
"Show Follow on Shop"CheckboxOnLets customers follow your store in the Shop app.

Pickup availability

File: blocks/_pickup.liquid · Used in: Product

No settings.

Price

File: blocks/_price.liquid · Used in: Featured product, Product, Quick view

SettingTypeDefaultValuesNotes
"Show tax note"CheckboxOn

File: blocks/_link.liquid · Used in: Featured product

No settings.

Product metadata

File: blocks/_meta.liquid · Used in: Product

SettingTypeDefaultValuesNotes
"Show vendor in metadata"CheckboxOffThe default product template turns it on.

Product vendor

File: blocks/_vendor.liquid · Used in: Featured product, Product

No settings.

Share

File: blocks/_share.liquid · Used in: Article

No settings.

Social media

File: blocks/_social.liquid · Used in: Footer

Add links in theme settings under Social media.

SettingTypeDefaultValuesNotes
"Heading"Text"Follow us"

Spec row

File: blocks/_spec_row.liquid · Used in: Spec table

SettingTypeDefaultValuesNotes
"Label"Text"Battery life"The row is hidden while it's empty.
"Product metafield"Text—The metafield's namespace and key, such as specs.battery_life, 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"Text—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, but lists and dates print unformatted. Rows with no value are hidden.
"Unit"Text—Shown after the value, such as mAh or h. Leave it empty for weight, volume and dimension metafields, which include their unit.

See Product page › Rows from metafields.

Spec table

File: blocks/_spec_table.liquid · Used in: Product, Compare

Rows come from the product data you already keep in Shopify. Add Spec row blocks to show product metafields.

Blocks: Spec row

SettingTypeDefaultValuesNotes
"Heading"Text"Specifications"
"Spec row position"Select"Above product details""Above product details", "Below product details"
"Show SKU"CheckboxOn
"Show product type"CheckboxOn
"Show vendor in spec table"CheckboxOn
"Show weight"CheckboxOn
"Show barcode"CheckboxOff
"Show variant options"CheckboxOn

Tags

File: blocks/_tags.liquid · Used in: Article

No settings.

Text

File: blocks/text.liquid · Used in: Article, Featured product, Footer, Product, Rich text, Section (generated blocks)

SettingTypeDefaultValuesNotes
"Text"Rich text—

Text column

File: blocks/_footer_text.liquid · Used in: Footer

SettingTypeDefaultValuesNotes
"Heading"Text"Heading"
"Text"Rich text—

Title

File: blocks/_title.liquid · Used in: Article, Featured product, Product

No settings.

Variant picker

File: blocks/_variant_picker.liquid · Used in: Featured product, Product, Quick view

No settings.

See also