Liquid file requirements for themes submitted to Shopify's Theme Store

If Shopify's Themes team approves your theme designs for further development, follow this checklist of template-level requirements. This is the same checklist that Shopify's Themes team will use to review your theme.

This checklist can be printed or downloaded as a PDF file:

General theme requirements

  • {{ 'option_selection.js' | shopify_asset_url | script_tag }}

Demo stores

Checkout pages

Search engine optimization

Accessibility

  • You can check for valid HTML using the W3C Markup Validator.

  • The colour contrast ratio should be as close to 4.5 as possible.

Recommendations

Section requirements

  • When a merchant changes the title or header, the name of the section will update to show the new title. This makes it easier for merchants to keep track of different sections.

JavaScript

Template file requirements

index.liquid

The index.liquid template of your theme must meet the following conditions:

product.liquid

The product.liquid template of your theme must meet the following conditions:

collection.liquid

The collection.liquid template of your theme must meet the following conditions:

  • For example, from product.price_min to product.price_max.

cart.liquid

The cart.liquid template of your theme must meet the following conditions:

blog.liquid

The blog.liquid template of your theme must meet the following conditions:

article.liquid

The article.liquid template of your theme must meet the following conditions:

page.liquid

The page.liquid template of your theme must meet the following conditions:

list-collections.liquid

The list-collections.liquid template of your theme must meet the following condition:

search.liquid

The search.liquid template of your theme must meet the following conditions:

404.liquid

The 404.liquid template of your theme must meet the following conditions:

gift-card.liquid

The gift_card.liquid template of your theme must meet the following conditions:

customers/account.liquid

The customers/account.liquid template of your theme must meet the following conditions:

customers/activate_account.liquid

The customers/activate_account.liquid template of your theme must meet the following conditions:

customers/addresses.liquid

The customers/addresses.liquid template of your theme must meet the following conditions:

customers/login.liquid

The customers/login.liquid template of your theme must meet the following conditions:

customers/order.liquid

The customers/order.liquid template of your theme must meet the following conditions:

customers/register.liquid

The customers/register.liquid template of your theme must meet the following conditions:

customers/reset_password.liquid

The customers/reset_password.liquid template of your theme must meet the following condition:

password.liquid

The password.liquid template must:

The password page must include:

settings_schema.json

The settings_schema.json file of your theme controls the customization options available to merchants on the Customize theme page. The settings_schema.json file must meet the following conditions:

theme.liquid (layout file)

The theme.liquid template of your theme must meet the following conditions:

Want to discuss this page?

Visit the Shopify Community