Skip to content

Sections

Sections are full-width page components. Each lives in the sections/ directory and has its own schema with settings and block types. Many sections connect to metaobject data via dynamic source on product and collection templates — see Clusters for the pattern.


These render the main content for specific page types.

Section File Template(s) Description
Main Product main-product.liquid product.* PDP layout — gallery, form, blocks
Main Collection main-collection.liquid collection.* Product grid with editorial cards, filtering
Main Recipe Article main-recipe-article.liquid article.recipes Two-column recipe — gallery + ingredients/directions. Emits Recipe JSON-LD.
Main Fresh Press Article main-fresh-press-article.liquid article.fresh-press Fresh Press blog article layout
Main Article main-article.liquid article Default/fallback article layout
Main Page main-page.liquid page.* Two-column page layout
Blog Listing blog-listing.liquid blog.* Filterable blog — pills, search, featured hero, client-side pagination
Main Cart Items main-cart-items.liquid cart Full cart page — line items, promo, BNPL, gift note
Main Search main-search.liquid search Search results page
Main 404 main-404.liquid 404 404 page with glass SVG illustration
Main List Collections main-list-collections.liquid list-collections All collections page
Storefront Password storefront-password.liquid password Password page
Section File Description
Split Media Hero split-media-hero.liquid Static split-panel hero (1 slide), uses container--wide
Split Media Hero Carousel split-media-hero-carousel.liquid Splide fade carousel of split-panel hero slides with custom controls
Hero Collection hero-collection.liquid Collection page hero banner
Section File Cluster? Description
FAQs faqs.liquid faq_group → faq_item Accordion FAQ with FAQPage JSON-LD schema
Feature Steps feature-steps.liquid product_feature_section → product_feature_step Numbered feature steps with media
Social Slider social-slider.liquid slides → social_slide_item Horizontal scroll of social media images/videos
Testimonials testimonials.liquid — Splide carousel of testimonial cards
Featured Editorial featured-editorial.liquid product_featured_editorial Two-column editorial with primary + accent media
Split Feature Editorial split-feature-editorial.liquid — Text + secondary media split layout
Featured Recipes featured-recipes.liquid featured_articles 4-card recipe grid/scroll
Educators educators.liquid educator (list) Educator card grid
Text Image Split text-image-split.liquid text_image_split (list) Constrained/wide/full-bleed text+image
Photo Medley photo-medley.liquid photo_medley 3-image collage + text
Total Kitchen total-kitchen.liquid system_block → accessories Tabbed product system showcase with ARIA tabs
Comparison Table comparison-table.liquid comparison_specs → rows Product comparison grid
Richtext richtext.liquid — Rich text content block
Content Cards content-cards.liquid — Grid of linked image cards
Explore Cards explore-cards.liquid — Grid of explore/category cards
Gallery gallery.liquid — Image gallery grid
Related Products related-products.liquid — Product recommendations carousel
Collection Row collection-row.liquid — Horizontal product card row
Product Feature Carousel product-feature-carousel.liquid — Splide carousel of product feature cards
Split Feature split-feature.liquid — Two-column feature layout
Sticky Quick Add sticky-quick-add.liquid — Sticky bottom-bar ATC for PDP
Custom HTML custom-html.liquid — Raw HTML injection
Yotpo Reviews yotpo-reviews.liquid — Yotpo review widget container
Collection Filters collection-filters.liquid collection_filter_set Pills + sort + drawer filter UI
Section File Description
Header header.liquid Logo, desktop nav, mobile drawer with x-trap, inline search/geo panels
Footer footer.liquid Newsletter bar, nav grid, social icons, compliance nav, copyright
Announcement Bar announcement-bar.liquid Top-of-page announcement Splide carousel
Cart Drawer cart.liquid React mini-cart — settings, translations bridge, empty state blocks
Section File Description
Blog Search Results blog-search-results.liquid Section rendering target for blog JS search
Search Products Grid search-products-grid.liquid Search results product grid
Search Articles JSON search-articles-json.liquid JSON response for blog search API
AJAX Linked Variants (Swappable) ajax-product-linked-variants-swappable.liquid HTMX fragment for linked variant swaps
AJAX Linked Variants (Linkable) ajax-product-linked-variants-linkable.liquid HTMX fragment for linked variant links