Blocks are reusable components that slot into sections. All blocks live in the blocks/ directory and are referenced by their filename (without .liquid). Blocks can be rendered as theme blocks (via {% content_for 'blocks' %}) or as static blocks (via {% content_for 'block', type: 'name', id: 'unique-id' %}). See Block Architecture for the full pattern.
These are the universal building blocks used across most sections.
| Block |
File |
Usage |
Description |
| Title |
title.liquid |
Static |
Heading with configurable level, style, alignment |
| Buttons |
buttons.liquid |
Static |
Button group with independent mobile/desktop gap + direction |
| Button |
button.liquid |
Theme (child of buttons) |
Individual button with style, size (mobile/desktop), arrow |
| Tag |
tag.liquid |
Static |
Pill or inline tag text |
| Richtext |
richtext.liquid |
Static/Theme |
Rich text block with RTE class |
| Custom HTML |
custom-html.liquid |
Theme |
Raw HTML injection |
| Media |
media.liquid |
Theme |
Image or video with aspect ratio control |
| Divider |
divider.liquid |
Theme |
Horizontal rule with spacing |
| Text |
text.liquid |
Theme |
Simple text block |
| Block |
File |
Description |
| Product Title |
product-title.liquid |
Product title with breadcrumb |
| Product Price |
product-price.liquid |
Price with compare-at, sale badge, aria-live |
| Product Variant Options |
product-variant-options.liquid |
Color swatches, plug type swatches, pill options |
| Product Form Submit |
product-form-submit.liquid |
ATC button with quantity controls, Shop Pay |
| Product Stock Message |
product-stock-message.liquid |
In stock / out of stock with AfterShip EDD, digital delivery |
| Product Compatibility |
product-compatibility.liquid |
Works-with product thumbnails |
| Product Trust Badges |
product-trust-badges.liquid |
Trust badge icons from metaobject |
| Product Certification Image |
product-certification-image.liquid |
Certification badge image |
| Bundle Checkbox |
bundle-checkbox.liquid |
Metaobject-driven bundle add-on cards |
| Bundle Group |
bundle-group.liquid |
Interactive bundle group with swatch/inline items |
| Promo Selector |
promo-selector.liquid |
Free gift dropdown picker |
| Accordion |
accordion.liquid |
PDP accordion from metaobject cluster |
| Block |
File |
Description |
| Product Card |
product-card.liquid |
Product card for grids and carousels |
| Product Feature Card |
product-feature-card.liquid |
Large product card with hover video, tag, CTA |
| Collection Card |
collection-card.liquid |
Collection link card |
| Editorial Card |
editorial-card.liquid |
Collection editorial card (image/video) |
| Cart Product |
cart-product.liquid |
Product recommendation card for cart page |
| Nav Pill |
nav-pill.liquid |
Collection filter pill |
| Filter Price |
filter-price.liquid |
Price range filter |
| Featured Collection |
featured-collection.liquid |
Collection showcase block |
| Block |
File |
Description |
| Content Card |
content-card.liquid |
Linked image card with title/body |
| Explore Card |
explore-card.liquid |
Category card with circle-arrow CTA |
| Educator Card |
educator-card.liquid |
Educator bio card |
| FAQ Item |
faq-item.liquid |
Single FAQ accordion item |
| Accordion Item |
accordion-item.liquid |
Single accordion item (child of accordion block) |
| Kitchen Tab |
kitchen-tab.liquid |
Total Kitchen tab panel with hero + accessory carousel |
| Testimonial |
testimonial.liquid |
Testimonial carousel slide |
| Social Slide |
social-slide.liquid |
Social media slide (image or video) |
| Gallery Image |
gallery-image.liquid |
Gallery image entry |
| List |
list.liquid |
Bullet list block |
| List Item |
list_item.liquid |
Individual list item |
| Embed |
embed.liquid |
YouTube/Vimeo embed |
| Trust Badge Item |
trust-badge-item.liquid |
Individual trust badge |
| Trust Badges |
trust-badges.liquid |
Trust badge group |
| Quick Link Item |
quick-link-item.liquid |
Quick link entry |
| Quick Links List |
quick-links-list.liquid |
Quick links wrapper |
| Split Media Hero Slide |
split-media-hero-slide.liquid |
Hero carousel slide with split panels |
| Block |
File |
Description |
| Header Meganav |
header-meganav.liquid |
Mega navigation dropdown trigger |
| Header Meganav Menu |
header-meganav-menu.liquid |
Mega nav column (link list) |
| Header Nav Link |
header-nav-link.liquid |
Simple nav dropdown link |
| Header Featured Item |
header-featured-item.liquid |
Featured product/article card in meganav |
| Header Featured Products |
header-featured-products.liquid |
Featured items container |
| Header Content Area (Left) |
header-content-area-left.liquid |
Left nav content zone |
| Header Content Area (Right) |
header-content-area-right.liquid |
Right nav content zone |
| Header Actions |
header-actions.liquid |
Utility icon tray |
| Header Cart Icon |
header-cart-icon.liquid |
Cart button with badge count |
| Header Search Toggle |
header-search-toggle.liquid |
Search icon toggle |
| Header Account Icon |
header-account-icon.liquid |
Account icon (Shopify account component) |
| Header Geolocation Icon |
header-geolocation-icon.liquid |
Globe icon → geolocation drawer |
| Block |
File |
Description |
| Footer Navigation |
footer-navigation.liquid |
Accordion nav column (mobile) / open list (desktop) |
| Footer Newsletter |
footer-newsletter.liquid |
Email signup form bridging to Klaviyo |
| Footer Social Row |
footer-social-row.liquid |
Social media icon links |
| Footer Legal |
footer-legal.liquid |
Legal/policy link nav |
| Footer Contact |
footer-contact.liquid |
Contact info block (currently unused) |
| Footer Menu Group |
footer-menu-group.liquid |
Legacy menu group (unused) |
These exist for backwards compatibility with older templates or content.
| Block |
File |
Description |
| Richtext Legacy |
richtext-legacy.liquid |
Older richtext format |
| Title Legacy |
title-legacy.liquid |
Older title format |
| Excerpt Legacy |
excerpt-legacy.liquid |
Article excerpt (legacy) |
| Custom HTML Legacy |
custom-html-legacy.liquid |
Older HTML block |
| Content |
content.liquid |
Generic content block |
| Contact Form Fields |
contact-form-fields.liquid |
Contact form field set |