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
-
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.
Footer
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.
Country/region and language
-
Show country/region selector Checkbox
Shown only when the store sells to more than one country. Manage in Settings > Markets.
-
Show language selector Checkbox
Shown only when the store has more than one published language. Manage in Settings > Languages.
Social media
-
Show Follow on Shop Checkbox
Lets customers follow your store on the Shop app. Requires Shop Pay to be enabled.
-
Show social media icons Checkbox
Add links in Theme settings > Social media.
Blocks
Email signup One per section
-
Heading Text
-
Text Rich text
Subscribers are added to your customer list with the tag "newsletter" and "accepts marketing" enabled.
Menu
-
Heading Text
-
Menu 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
-
Enable search suggestions Checkbox
Shows product, collection, page, and article suggestions as shoppers type.
Country/region and language
-
Show country/region selector Checkbox
Shown only when the store sells to more than one country. Manage in Settings > Markets.
-
Show language selector Checkbox
Shown only when the store has more than one published language. Manage in Settings > Languages.
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.
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.
Featured product
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
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
-
Column 1 Text
-
Column 2 Text
-
Column 3 Text
Blocks
Row
-
Feature Text
Enter only accurate, verifiable values. Policy rows such as Warranty are optional: use your real terms or remove the row.
-
Column 1 value Text
-
Column 2 value Text
-
Column 3 value Text
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
-
Text Multi-line text
Blocks
Feature
-
Title Text
-
Text Multi-line text
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.
-
Text Multi-line text
Placeholder. Replace with your real returns window, warranty, or satisfaction promise. Only describe policies your store actually offers.
-
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
-
Text Rich text
-
Button label Text
Leave blank to use the default.
-
Alignment Dropdown
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
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.
UGC gallery
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
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
-
Text Multi-line text
Blocks
Item
-
Title Text
-
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.
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
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
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
Trust point 4
-
Text Text
Shopify checkout is encrypted by default. Edit the wording or leave blank to hide this point.
-
Icon Dropdown
Line item text
-
Label Text
-
Placeholder Text
-
Maximum characters Slider
-
Required Checkbox
Line item dropdown
-
Label Text
-
Options Text
Comma-separated list of choices.
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
Blocks
Question
-
Question Text
-
Answer Multi-line text
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
Blocks
Hotspot
-
Label Text
-
Text Multi-line text
-
Horizontal position Slider
-
Vertical position Slider
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.
-
Heading Text
Leave blank to use the default for the selected type.
-
Maximum products to show Slider
-
Columns on desktop Slider
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
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
Blocks
Spec row
-
Label Text
-
Value Text
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
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
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
-
Image height Dropdown
-
Show collection description Checkbox
Products
-
Enable filtering Checkbox
Customize filters with the Shopify Search & Discovery app.
-
Enable sorting Checkbox
-
Products per page Slider
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
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
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.
-
Enable sorting Checkbox
-
Products per page Slider
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
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.
Predictive search
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”.