Sections and blocks

Sections are the building blocks of each page. Blocks are the smaller pieces inside a section, like a single feature or question.

In the theme editor, choose Add section to add a section, drag sections to reorder them, and use the eye icon to hide one without losing its content. Most content sections hide themselves on your store when they’re empty.

Header and footer

These sections appear on every page. Edit them from the header or footer area of the theme editor.

Announcement bar

A slim bar above the header for one short message, with an optional link.

  • Can be added with Add section
  • Only in: header group
  • Included by default in: Header group

Settings

  • Text Text

    Default
    Add a short announcement
  • Link (optional) Link

Tips

  • Keep it to one line on mobile. About 40 to 60 characters fits most phones.
  • Only announce offers you actually run, such as a real free-shipping threshold.

The bottom of every page, with an optional brand row (your logo or brand name with your tagline), up to six blocks (email signup, menus, text) and a bottom bar for selectors, social icons, Follow on Shop, payment icons and copyright.

  • Only in: footer group
  • Included by default in: Footer group
  • Up to 6 blocks

Settings

Brand
  • Show brand tagline Checkbox

    Shows your logo or brand name with the tagline at the top of the footer. Set the text in Theme settings > Brand.

    Default
    On
Country/region and language
  • Show country/region selector Checkbox

    Shown only when the store sells to more than one country. Manage in Settings > Markets.

    Default
    On
  • Show language selector Checkbox

    Shown only when the store has more than one published language. Manage in Settings > Languages.

    Default
    On
Social media
  • Show Follow on Shop Checkbox

    Lets customers follow your store on the Shop app. Requires Shop Pay to be enabled.

    Default
    On
  • Show social media icons Checkbox

    Add links in Theme settings > Social media.

    Default
    On

Blocks

Email signup One per section
  • Heading Text

    Default
    Subscribe to our emails
  • Text Rich text

Subscribers are added to your customer list with the tag "newsletter" and "accepts marketing" enabled.

Menu
  • Heading Text

    Default
    Quick links
  • Menu Menu

    Default
    footer menu
Text
  • Heading Text

  • Text Rich text

Tips

  • The brand row appears when you’ve entered a brand tagline in Theme settings > Brand and “Show brand tagline” is on. Leave the tagline blank to hide it.
  • Social icons use the links in Theme settings > Social media. They’re hidden when no links are set.
  • Payment icons follow the payment methods enabled in your store. Turn them off in Theme settings > Footer.
  • Follow on Shop needs Shop Pay to be turned on for your store.

Header

Your logo or brand name, the main menu, search, account and cart buttons. On smaller screens the menu moves into an accessible slide-out drawer.

  • Only in: header group
  • Included by default in: Header group

Settings

  • Show search Checkbox

    Default
    On
  • Enable search suggestions Checkbox

    Shows product, collection, page, and article suggestions as shoppers type.

    Default
    On
Country/region and language
  • Show country/region selector Checkbox

    Shown only when the store sells to more than one country. Manage in Settings > Markets.

    Default
    Off
  • Show language selector Checkbox

    Shown only when the store has more than one published language. Manage in Settings > Languages.

    Default
    Off
Brand
  • Show brand tagline Checkbox

    Shown next to the logo on screens 990px and wider, and hidden on smaller screens to keep the header clear. Set the text in Theme settings > Brand.

    Default
    On

Tips

  • Choose the menu in Theme settings > Header. Menus support three levels, which show as dropdowns on desktop and expandable lists on mobile.
  • The logo and its width are set in Theme settings > Logo. Without a logo, the header shows the brand name.
  • The country/region and language selectors only appear when your store has more than one market or language.
  • Your brand tagline (Theme settings > Brand) appears next to the logo on screens 990px and wider. It’s hidden on smaller screens so it never crowds the menu, logo or cart, and long taglines are shortened to two lines. Turn it off with “Show brand tagline”.

Home page and promotions

Big, bold sections for introducing your brand and leading product. Add them to any page except the header and footer areas.

A complete, shoppable product on any page, with its gallery, price, variant picker and buy buttons.

  • Can be added with Add section
  • Not available in: header group, footer group
  • Included by default in: Home page

Settings

  • Product Product

Blocks

App blocks

Add blocks from installed apps that support theme app extensions.

Title One per section

No settings. Drag it to change where it appears.

Price One per section

No settings. Drag it to change where it appears.

Description One per section
  • Maximum words Slider

    Default
    30
    Range
    10–80
Buy buttons One per section

No settings. Drag it to change where it appears.

Text
  • Text Rich text

View details link One per section

No settings. Drag it to change where it appears.

Tips

  • Use the blocks to choose what shows and in what order. The “View details” link takes shoppers to the full product page.
  • It shows a placeholder in the editor until you pick a product.

Featured product band

A feature band that spotlights one product, with an image, text, a button and up to three short feature points.

  • Can be added with Add section
  • Not available in: header group, footer group
  • Included by default in: Home page

Settings

  • Collection Collection

    Uses the first product. Leave empty to use the theme setting Brand > Flagship collection.

  • Image Image

    Leave empty to use the product's featured image.

  • Eyebrow Text

  • Heading Text

  • Text Multi-line text

  • Button label Text

  • Feature 1 title Text

  • Feature 1 text Text

  • Feature 2 title Text

  • Feature 2 text Text

  • Feature 3 title Text

  • Feature 3 text Text

Tips

  • It uses Theme settings > Brand > Flagship product when set. Otherwise it uses the first product in the selected collection.
  • Feature points with a blank title are hidden.

Hero

A large opening banner with an eyebrow line, heading, text, two buttons and an image.

  • Can be added with Add section
  • Not available in: header group, footer group
  • Included by default in: Home page

Settings

  • Image Image

    Leave empty to use the featured image of the first product in Brand > Flagship collection.

  • Eyebrow Text

  • Heading Text

  • Text Multi-line text

  • Button label Text

  • Secondary button label Text

Tips

  • Leave the image empty to use the featured image of your flagship product.
  • The main button links to the flagship product (Theme settings > Brand > Flagship product). The secondary button links to the add-ons collection, or to all products.
  • Keep the heading short. Two short lines read best on mobile.

Storytelling and content

Flexible content sections that work on the home page, product templates and standard pages.

Add-ons grid

A grid of product cards from a collection, each linking to its product page. Good for accessories, refills and add-ons.

  • Can be added with Add section
  • Not available in: header group, footer group
  • Included by default in: Default product, Home page

Settings

  • Collection Collection

    Leave empty to use the theme setting Brand > Add-ons collection (also used by the cart drawer cross-sell).

  • Eyebrow Text

  • Heading Text

  • Text Multi-line text

Tips

  • Leave the collection empty to use Theme settings > Brand > Add-ons collection, which also feeds the cart drawer suggestions.
  • On a product page it automatically skips the product being viewed.

Comparison

A comparison table with up to three columns and one row per feature.

  • Can be added with Add section
  • Not available in: header group, footer group
  • Included by default in: Home page, Product (flagship)

Settings

  • Heading Text

    Default
    Compare
  • Column 1 Text

    Default
    Option A
  • Column 2 Text

    Default
    Option B
  • Column 3 Text

    Default
    Option C

Blocks

Row
  • Feature Text

    Enter only accurate, verifiable values. Policy rows such as Warranty are optional: use your real terms or remove the row.

    Default
    Feature
  • Column 1 value Text

    Default
    —
  • Column 2 value Text

    Default
    —
  • Column 3 value Text

    Default
    —

Tips

  • Keep values accurate and checkable. Policy rows such as warranty are optional, so use your real terms or remove the row.
  • On small screens the table scrolls sideways instead of squeezing the text.

Feature grid

A heading plus a grid of short feature or benefit cards.

  • Can be added with Add section
  • Not available in: header group, footer group
  • Included by default in: Home page, Product (flagship)

Settings

  • Eyebrow Text

  • Heading Text

    Default
    Why it matters
  • Text Multi-line text

Blocks

Feature
  • Title Text

    Default
    Feature
  • Text Multi-line text

    Default
    Short benefit description.

Tips

  • Three or six features make even rows on desktop.
  • The section hides itself when it has no heading and no features.

Guarantee

A short reassurance band about returns, warranty or satisfaction, with an optional button.

  • Can be added with Add section
  • Not available in: header group, footer group
  • Included by default in: Home page, Product (flagship)

Settings

  • Heading Text

    Optional. Leave the heading and text blank to hide this band.

    Default
    Returns and warranty
  • Text Multi-line text

    Placeholder. Replace with your real returns window, warranty, or satisfaction promise. Only describe policies your store actually offers.

    Default
    Returns window and warranty terms are listed in our store policies.
  • Button label Text

  • Button link Link

Tips

  • The default text is a placeholder. Replace it with your real policy, or clear the heading and text to hide the band.
  • Link the button to your refund or warranty policy page.

Logo list

A row of logos, for example retail partners or press mentions, with optional links.

  • Can be added with Add section
  • Not available in: header group, footer group

Settings

  • Heading Text

    Optional. For example, press mentions or retail partners. Only show logos you have permission to use.

Blocks

Logo
  • Image Image

  • Link Link

Tips

  • Only show logos you have permission to use.
  • Upload logos in SVG or transparent PNG. Single-color versions look best on the dark default color scheme.

Email signup

An email signup form. Subscribers are added to your customer list with email marketing accepted.

  • Can be added with Add section
  • Not available in: header group

Settings

  • Heading Text

    Default
    Subscribe to our emails
  • Text Rich text

    Default
    Be the first to hear about new products and offers.
  • Button label Text

    Leave blank to use the default.

  • Alignment Dropdown

    Default
    Center
    Choices
    Left, Center

Subscribers are added to your customer list with the tag "newsletter" and "accepts marketing" enabled.

Tips

  • Shoppers see a success message on the page after subscribing, with no extra app needed.
  • The footer also has an Email signup block, so you don’t need both on the same page.

Social proof

Customer quotes with an author line.

  • Can be added with Add section
  • Not available in: header group, footer group
  • Included by default in: Home page

Settings

  • Eyebrow Text

  • Heading Text

    Default
    What customers say

Blocks

Quote
  • Quote Multi-line text

    Only use real customer quotes you have permission to share. Blank quotes are hidden on the storefront.

  • Author Text

Tips

  • Only add real quotes you have permission to share. Blank quotes are hidden on your store and show a reminder in the editor.

An image gallery with captions, for customer or community photos.

  • Can be added with Add section
  • Not available in: header group, footer group

Settings

  • Heading Text

    Default
    In the wild

Blocks

Image
  • Image Image

  • Caption Text

Tips

  • Ask permission before posting customer photos, and credit them in the caption.
  • Add alt text to each image in Content > Files.

What's included

A checklist of what's in the box, with a title and short description per item.

  • Can be added with Add section
  • Not available in: header group, footer group
  • Included by default in: Product (flagship)

Settings

  • Heading Text

    Default
    What's included
  • Text Multi-line text

Blocks

Item
  • Title Text

    Default
    Included item
  • Text Multi-line text

Tips

  • List every physical item, including cables and tools. It cuts down on “is X included?” questions.

Product page

Sections built for product templates. Product information is the main section. The rest add detail around it.

Product information

The main product area, with the media gallery on one side and blocks you can reorder on the other.

  • Included by default in: Default product, Product (flagship)

Settings

  • Show sticky add-to-cart bar Checkbox

    Appears when the main add-to-cart button scrolls out of view. Requires a Buy buttons block.

    Default
    On

Blocks

App blocks

Add blocks from installed apps that support theme app extensions.

Title One per section

No settings. Drag it to change where it appears.

Price One per section

No settings. Drag it to change where it appears.

Description One per section

No settings. Drag it to change where it appears.

Buy buttons One per section

No settings. Drag it to change where it appears.

Trust strip One per section
  • Heading (optional) Text

Trust point 1
  • Text Text

    Free shipping threshold: enter your real offer, for example "Free shipping over [amount]". Only enter a policy your store actually offers. While blank, this point is hidden from shoppers and only a placeholder shows in the theme editor.

  • Icon Dropdown

    Default
    Shipping
    Choices
    Check, Shipping, Returns, Guarantee, Secure, Support, None
Trust point 2
  • Text Text

    Returns window: enter your real returns policy, for example "[number]-day returns". Only enter a policy your store actually offers. While blank, this point is hidden from shoppers and only a placeholder shows in the theme editor.

  • Icon Dropdown

    Default
    Returns
    Choices
    Check, Shipping, Returns, Guarantee, Secure, Support, None
Trust point 3
  • Text Text

    Warranty: enter your real warranty terms, for example "[length] warranty". Only enter a policy your store actually offers. While blank, this point is hidden from shoppers and only a placeholder shows in the theme editor.

  • Icon Dropdown

    Default
    Guarantee
    Choices
    Check, Shipping, Returns, Guarantee, Secure, Support, None
Trust point 4
  • Text Text

    Shopify checkout is encrypted by default. Edit the wording or leave blank to hide this point.

    Default
    Secure checkout
  • Icon Dropdown

    Default
    Secure
    Choices
    Check, Shipping, Returns, Guarantee, Secure, Support, None
Line item text
  • Label Text

    Default
    Custom text
  • Placeholder Text

  • Maximum characters Slider

    Default
    20
    Range
    0–100
  • Required Checkbox

    Default
    Off
Line item dropdown
  • Label Text

    Default
    Option
  • Options Text

    Comma-separated list of choices.

    Default
    Option 1, Option 2, Option 3
Text
  • Text Rich text

Custom Liquid
  • Liquid code Liquid code

    Add app snippets or other Liquid code to create advanced customizations.

Tips

  • Keep the Buy buttons block. Variant picker, quantity, add to cart, subscriptions, gift card recipient form and pickup availability all live in it.
  • Line item blocks add custom fields (like engraving text) to the order. Add them to a product template used only by products that need them.
  • Trust points are blank by default and hidden until you enter a real policy.
  • The sticky add-to-cart bar appears on scroll and uses the same form, so options and validation still apply.

Product FAQ

Expandable questions and answers about the product.

  • Can be added with Add section
  • Not available in: header group, footer group
  • Included by default in: FAQ page, Product (flagship)

Settings

  • Heading Text

    Default
    FAQ

Blocks

Question
  • Question Text

    Default
    Question?
  • Answer Multi-line text

    Default
    Answer.

Tips

  • Answers open and close without JavaScript, and screen readers announce the open or closed state.

Product hotspots

An image with clickable hotspot dots. Shoppers select a dot to read about that part of the product.

  • Can be added with Add section
  • Not available in: header group, footer group
  • Included by default in: Product (flagship)

Settings

  • Diagram image Image

    Leave empty to use the product's featured image.

  • Heading Text

    Default
    Product details

Blocks

Hotspot
  • Label Text

    Default
    Feature
  • Text Multi-line text

    Default
    Describe this feature.
  • Horizontal position Slider

    Default
    50%
    Range
    0–100%
  • Vertical position Slider

    Default
    50%
    Range
    0–100%

Tips

  • Set each hotspot’s position with the horizontal and vertical sliders. Preview on mobile, since the image gets smaller.
  • Hotspots without a label are hidden. Each dot has a large tap area, works with the keyboard and is named by its label for screen readers.

Product recommendations

Related or complementary products, loaded after the page so it doesn't slow the first view.

  • Can be added with Add section
  • Only on: product templates
  • Included by default in: Default product, Product (flagship)

Settings

  • Type Dropdown

    Related products are generated automatically. Complementary products are chosen in the Search & Discovery app.

    Default
    Related products
    Choices
    Related products, Complementary products
  • Heading Text

    Leave blank to use the default for the selected type.

  • Maximum products to show Slider

    Default
    4
    Range
    2–10
  • Columns on desktop Slider

    Default
    4
    Range
    2–5

Tips

  • Related products are chosen automatically by Shopify.
  • Complementary products are picked by you in the Shopify Search & Discovery app. The section stays hidden when there’s nothing to show.
  • Add the section twice to show both types, as the default product templates do.

Product reviews

A home for your reviews app's block, with optional hand-picked quotes.

  • Can be added with Add section
  • Not available in: header group, footer group
  • Included by default in: Default product, Product (flagship)

Settings

  • Heading Text

    Default
    Reviews

Blocks

App blocks

Add blocks from installed apps that support theme app extensions.

Quote
  • Quote Multi-line text

    Only use real customer quotes you have permission to share. Blank quotes are hidden on the storefront.

  • Author Text

Tips

  • Install a reviews app and add its block here. Until there’s an app block or a quote, the section only shows a hint in the editor.

Product specs

A two-column specifications table.

  • Can be added with Add section
  • Not available in: header group, footer group
  • Included by default in: Product (flagship)

Settings

  • Heading Text

    Default
    Specs

Blocks

Spec row
  • Label Text

    Default
    Spec
  • Value Text

    Default
    Value

Tips

  • Use a consistent unit style, for example “1.2 kg” everywhere.

Page templates

Each Shopify page type has one main section. It can't be removed, but you can add other sections above or below it.

404 page

The "page not found" page, with a link back to shopping.

  • Main section of its template
  • Included by default in: 404 page

Tips

  • Add a Featured product or Add-ons grid section below it to keep lost visitors browsing.

Blog post

A single blog post, with its image, author, date and content.

  • Main section of its template
  • Included by default in: Blog post

Settings

  • Content width Dropdown

    Default
    Normal
    Choices
    Narrow, Normal

Tips

  • Add alt text to the featured image of each post.

Blog posts

Lists the posts in a blog, with images, dates and excerpts.

  • Main section of its template
  • Included by default in: Blog

Settings

  • Content width Dropdown

    Default
    Normal
    Choices
    Narrow, Normal

Tips

  • Set an excerpt on each post for neat, even cards.

Cart

The full cart page, with product lines, quantity changes, discounts, an optional order note and the checkout button.

  • Main section of its template
  • Included by default in: Cart

Tips

  • Turn on order notes in Theme settings > Cart.

Collection products

A collection page with an optional banner (image and description), filters, sorting and a paginated product grid.

  • Main section of its template
  • Included by default in: Collection

Settings

Banner
  • Show collection image Checkbox

    Default
    On
  • Image height Dropdown

    Default
    Medium
    Choices
    Small, Medium, Large
  • Show collection description Checkbox

    Default
    On
Products
  • Enable filtering Checkbox

    Customize filters with the Shopify Search & Discovery app.

    Default
    On
  • Enable sorting Checkbox

    Default
    On
  • Products per page Slider

    Default
    24
    Range
    8–48

Tips

  • Set up filters in the Shopify Search & Discovery app. Turn filtering or sorting off here if you don’t need them.
  • The banner image comes from the collection’s image in Products > Collections.

Contact form

The page content followed by Shopify's contact form (name, email, phone, message).

  • Main section of its template
  • Included by default in: Contact page

Tips

  • Assign the “contact” template to your Contact page in Online Store > Pages. Messages go to your store’s sender email.

Collections list

Lists all your collections as cards.

  • Main section of its template
  • Included by default in: Collections list

Tips

  • Add an image to each collection in Products > Collections so every card has a picture.

Page

Shows the title and content of a standard page.

  • Main section of its template
  • Included by default in: FAQ page, Page

Settings

  • Content width Dropdown

    Default
    Normal
    Choices
    Narrow, Normal

Tips

  • Add sections such as Feature grid or Custom Liquid under it to build richer pages without code.

Password

The password page shown while your store is locked, with your password message and a password form.

  • Main section of its template
  • Included by default in: Password page

Tips

  • Edit the message in Online Store > Preferences > Password protection.

Search results with filters and sorting for products, plus matching pages and blog posts.

  • Main section of its template
  • Included by default in: Search

Settings

  • Enable filtering Checkbox

    Customize filters with the Shopify Search & Discovery app.

    Default
    On
  • Enable sorting Checkbox

    Default
    On
  • Products per page Slider

    Default
    24
    Range
    8–48

Tips

  • Search filters are also managed in the Search & Discovery app.

Apps and custom code

Containers for app blocks and your own code, available everywhere.

Apps

An empty container for app blocks, available on every template.

  • Can be added with Add section

Settings

  • Make section margins the same as theme Checkbox

    Default
    On

Blocks

App blocks

Add blocks from installed apps that support theme app extensions.

Tips

  • Use it for apps that add a block (reviews, wishlists, size guides) where the main product section isn’t the right place.

Custom Liquid

Paste Liquid or HTML for advanced custom content, such as an app snippet or an embed.

  • Can be added with Add section

Settings

  • Liquid code Liquid code

    Add app snippets or other Liquid code to create advanced customizations.

Tips

  • Code pasted here isn’t checked by the theme. Test it on a copy of your theme first.

Behind the scenes

Parts of the theme that power features elsewhere. You won't add these yourself, but it helps to know what they do.

Cart drawer

The slide-out cart that opens when a shopper adds a product. It's always part of the theme layout, so you don't add it yourself.

  • Built in

Tips

  • Suggestions come from Theme settings > Brand > Add-ons collection, with the heading from “Cart cross-sell heading”. Items already in the cart are hidden, and up to three show at once.

Pickup availability

Supplies the in-store pickup details on product pages. It works behind the scenes and doesn't appear in the editor.

  • Built in

Tips

  • Pickup shows only when at least one location offers local pickup and has the variant in stock. See the Product page guide.

Supplies the search suggestions shown as shoppers type. It works behind the scenes and doesn't appear in the editor.

  • Built in

Tips

  • Turn suggestions on or off in the Header section with “Enable search suggestions”.