Page sections

Page sections are “canonical” sections which appear on online store pages. These page sections are used to create standardized templates for each type of page.

Every page type (such as product, collection, article, blog, or 404) has a corresponding page section which may contain customizable settings and blocks. This page section can't be removed from the page (or for pages that support master pages, their master page). Page sections must be implemented by the theme in order for content sections to be added to pages using the Online Store editor.

Page sections display the crucial content and messages associated with their page type. For example, the page section for a cart page consists of a cart form and any other relevant content.

Page sections are an alternative to theme templates, which previously contained content for specific pages and included separate section files. Online store pages can now implement either a page section or a theme template to display content.

Rules for page sections

  • For pages that support master pages (product, collection, custom and article) the page section is contained within the master page, otherwise on the page itself.

  • Page sections can't be removed or toggled off in the Online Store editor.

  • Page sections must define a name in their schema.

  • Within the schema tags, page sections can define all the properties of theme sections except for presets and max_blocks.

  • Page sections don't support the content schema property, which is specific to content sections.

  • A maximum of 12 blocks and 10 settings for each section or block can be defined in the section schema.

  • Page sections can't be included in Liquid files through the {% section %} Liquid tag or added to content_for_index.

  • The deprecated {% include %} Liquid tag is not supported in page sections.

  • Page sections don't support the {% javascript %} and {% stylesheet %} tags.

List of paths for page sections

Page sections are contained within a theme’s pages/ directory. The pages/ directory stores a Liquid file for each possible page type, and the filenames for these pages are standardized in the same manner as theme templates.

  • pages/404.liquid
  • pages/article.liquid
  • pages/blog.liquid
  • pages/cart.liquid
  • pages/collection.liquid
  • pages/customers/account.liquid
  • pages/customers/activate_account.liquid
  • pages/customers/addresses.liquid
  • pages/customers/login.liquid
  • pages/customers/order.liquid
  • pages/customers/register.liquid
  • pages/customers/reset_password.liquid
  • pages/gift_card.liquid
  • pages/list-collections.liquid
  • pages/page.liquid
  • pages/password.liquid
  • pages/product.liquid
  • pages/search.liquid