Skip to main content

Testing your theme for the Shopify Theme Store

Use this checklist to ensure that your theme meets the functional requirements for the Shopify Theme Store. The checklist doesn't comprehensively represent all of the requirements for the Theme Store, but it can help you to make sure that your theme addresses edge cases that the theme review team will test as a part of the review process.

To run these tests, you need to populate your store with data, and configure some additional features. To download this data and learn about the additional configurations you need to make, refer to Testing assets.

You should run these tests in both the theme editor and the storefront.


Add the following sections to the home page. After you add all of the sections, verify that they work properly.


Run the following tests on your header. For each of these tests, verify the following:

  • The store name or logo displays properly and is accessible
  • Header icons or links display properly and are accessible
  • The navigation functions properly, and navigation titles are fully visible

Run the following tests on your footer. For each of these tests, verify that footer text, icons, images are fully visible and functional.


Test the following sections in your theme:

Run the following tests on your announcement bar section. For each of these tests, verify the following:

  • Text and icons are fully visible
  • Any links function properly
  • Link styling indicates that the text is clickable

Run the following tests on your slideshow section.

Run the following tests on your featured product section. For each of these tests, verify the following:

  • Adding duplicate featured products doesn't break the section or the page
  • Customers can add different featured products to the cart

Run the following tests on your featured collection section. For each of these tests, verify the following:

  • All sections work as expected
  • Adding multiple featured collections doesn't break the section or the page

Run the following tests on your collection list section. For each of these tests, verify the following:

  • Collection titles are visible
  • Collections with no image display the first product in the collection, or the collection's title, in the image block
  • Adding multiple collection list sections doesn't break the section or the page

Run the following tests on your image with text section. For each of these tests, verify the following:

  • All text is completely visible
  • Varying image qualities and ratios are supportedImages must support varying image qualities and ratios
  • Adding multiple image with text sections doesn't break the section or the page

Run the following tests on your newsletter section. For each of these tests, verify the following:

  • All text is completely visible
  • The form outputs proper error and success messages

Run the following tests on your rich text section. For each of these tests, verify that all of the text is visible.

Run the following tests on your blog posts section. For each of these tests, verify the following:

  • All text is visible
  • The blog post grid supports varying image ratios

Add the following video types in a video section. For each of these tests, verify the following:

  • Adding multiple video sections doesn't break section or the page
  • Video controls are present and functional

If your theme has any additional sections then you need to test them as well. Run the tests that apply to your section. Verify the following:

  • Each section supports varying image qualities and ratios
  • All text is visible
  • Adding multiples of the same section doesn't break the section or the page

Test the following pages or elements in your theme:

Run the following tests on your password page. For each of these tests, verify the following:

  • Customers are able to access the store with a password
  • The store logo or name and the password message are fully visible

Anchor to Collection list pageCollection list page

Run the following tests on your collection list page. For each of these tests, verify the following:

  • Multiple collection image ratios are supported
  • A collection with no image displays the first product in that collection, or displays the collection's title in the image block

Run the following tests on your collection page. For each of these tests, verify the following:

  • All products in the collection are accessible
  • The collection can be sorted and filtered
  • Combining filter tags doesn't break the page
  • Product information in the product grid is fully visible

Run the following tests on your product page, on each of the product configurations outlined. For each of these tests, verify the following:

  • Customers can add a selected variant to the cart
  • Variant information changes dynamically when different variants are selected
  • Customers are prevented from adding more than the available quantity of items to the cart

Anchor to Product configurationsProduct configurations

Run the following tests on your blog page. For each of these tests, verify the following:

  • All blog posts in the collection are accessible
  • Multiple blog post image ratios are supported
  • Must support varying blog post image ratios
  • Blog post information must be visible. This includes the title, excerpt, author, date, and comment count
  • If available, blog filtering works as expected and combining filter tags doesn't break the page

Anchor to Blog post page (Article)Blog post page (Article)

Run the following tests on your blog post page.

Anchor to Cart page, modal, or drawerCart page, modal, or drawer

Run the following tests on your cart. For each of these tests, verify the following:

  • All products in the cart are fully visible
  • The customer must be able to update the product quantity
  • Automatic discounts must update dynamically

Run the following tests on your search page. For each of these tests, verify that search result attributes are fully visible.

Run the following tests on a page that uses the generic page template. For each of these tests, verify that page content is fully visible.

Anchor to Pages (contact form template)Pages (contact form template)

Run the following tests on a page that uses the contact form template. For each of these tests, verify that customers can send the merchant an email using the contact form.

Run the following tests on the gift card page. For each of these tests, verify that the gift card code and store name or logo is fully visible.



Test your local pickup banner in the following scenarios. Before you start, prepare your store to test local pickup.


Test unit prices in your theme. Before you start, prepare your store to test unit pricing.


Test rich media in your theme. Before you start, prepare your store to test rich media.


Test selling plans in your theme. Before you start, prepare your store to test selling plans.


Was this page helpful?