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

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