We're constantly trying to improve your support experience, and your feedback is extremely valuable to us.

Please take a moment to tell us about your experience today.
Sign up for future Help Center user research studies.

Content sections

Content sections are customizable page elements, such as a slideshow or gallery, which can be added to the pages of an online store. These section files are located in the content/ directory of themes.

Content sections can be added to master pages and sections-enabled pages through the Online Store editor. The Online Store editor can also be used to adjust the positions of content sections.

Content sections are not standardized and are optional to be implemented by the theme. However, for a theme to be able to render content sections added to an online store with a different theme, it must have at least one content section accepting all content types.

Rules for content sections

  • Content sections must define a name in their schema.

  • Content sections must follow the rules of the Content Schema through their content property.

  • Within the schema tags, content sections can define all the properties of theme sections except for default and max_blocks. blocks may only defined when content is set to false.

  • Content sections have a built-in title text setting, which can be accessed in Liquid via section.title. It's not possible to opt-out of this setting.

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

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

  • The {% include %} Liquid tag is not supported in content sections. An alternative functionality will be provided in the near future.

The content schema property

Content sections are required to define a content property in their schema. The content property accepts a range of standardized values for the different types of section content and is a new method for defining settings and blocks rather than the existing settings and blocks properties.

Learn more about the content property in the Content Schema documentation.

The pages schema property

The pages schema property defines which types of page or master page the content section can be added to. If a pages field is not defined, the section can be added to all pages and master pages.

This example demonstrates a section that can be added only to product and collection pages:

{% schema %}
  {
    "pages": ["product", "collection"]
  }
{% endschema %}

The section Liquid object

The section Liquid object of content sections has the following additional properties:

  • content: more information in the Content Schema documention.

  • title: returns the title of the section, configured by the merchant in the Shopify admin.

Ready to start selling with Shopify?

Try it free