--- title: Testing your theme for the Shopify Theme Store description: Test your theme to make sure that it meets Shopify Theme Store requirements. source_url: html: 'https://shopify.dev/docs/storefronts/themes/store/test-theme/checklist' md: 'https://shopify.dev/docs/storefronts/themes/store/test-theme/checklist.md' --- ExpandOn this page * [1.​Home page](https://shopify.dev/docs/storefronts/themes/store/test-theme/checklist.md#1-home-page) * [2.​Header](https://shopify.dev/docs/storefronts/themes/store/test-theme/checklist.md#2-header) * [3.​Footer](https://shopify.dev/docs/storefronts/themes/store/test-theme/checklist.md#3-footer) * [4.​Sections](https://shopify.dev/docs/storefronts/themes/store/test-theme/checklist.md#4-sections) * [5.​Pages](https://shopify.dev/docs/storefronts/themes/store/test-theme/checklist.md#5-pages) * [6.​Link sharing](https://shopify.dev/docs/storefronts/themes/store/test-theme/checklist.md#6-link-sharing) * [7.​Local pickup](https://shopify.dev/docs/storefronts/themes/store/test-theme/checklist.md#7-local-pickup) * [8.​Unit pricing](https://shopify.dev/docs/storefronts/themes/store/test-theme/checklist.md#8-unit-pricing) * [9.​Rich media](https://shopify.dev/docs/storefronts/themes/store/test-theme/checklist.md#9-rich-media) * [10.​Selling plans](https://shopify.dev/docs/storefronts/themes/store/test-theme/checklist.md#10-selling-plans) # 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](https://shopify.dev/docs/storefronts/themes/store/test-theme/assets). You should run these tests in both the theme editor and the storefront. *** ## 1.​Home page Add the following sections to the home page. After you add all of the sections, verify that they work properly. Three slideshowsFive featured products, three of which are the same productThree different featured collectionsOne collection listThree image with textOne newsletterOne rich textOne blog postTwo video (if applicable)Add additional sections until the homepage has 25 sections *** ## 2.​Header 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 Add logo fallback text:Long store name (30-40 characters, no spaces)Add a logo:Test different aspect ratios in portrait and landscape mode:16:94:33:21:1Transparent background on PNG imageLogo scalingDifferent positions and alignments (if applicable)Add navigation:Long navigation menu (10+ menu items)Single-level navigationTwo-level nested navigationThree-level nested navigationLong level one menu item titles (30-60 characters)Long level two menu item titles (30-60 characters)Long level three menu item titles (30-60 characters)Mega menu (if applicable) *** ## 3.​Footer Run the following tests on your footer. For each of these tests, verify that footer text, icons, images are fully visible and functional. Add five columns or blocks, or the maximum number of blocksAdd multiple menusAdd a long navigation menu (10+ menu items)Add menu items with long titles (30-60 characters)Add all social linksIf your footer has a newsletter form, then test the following:Input form textSubmit the formTest error detection and handlingTest the submission success message *** ## 4.​Sections Test the following sections in your theme: * [Announcement bar](#announcement-bar) * [Slideshow](#slideshow) * [Featured product](#featured-product) * [Featured collection](#featured-collection) * [Collection list](#collection-list) * [Image with text](#image-with-text) * [Newsletter](#newsletter) * [Rich text](#rich-text) * [Blog posts](#blog-posts) * [Video](#video) * [Any sections unique to your theme](#unique-sections) ### Announcement bar 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 If the text input is plain text, then add 60-100 characters of text, or the maximum character limitIf the text input is rich text, then add the following text:Text with a single line breakText with two line breaksText with three line breaksA paragraph (40-50 words)Add links:An internal linkAn external linkLink opens in the same windowLink opens in a new window ### Slideshow Run the following tests on your slideshow section. Add three slideshow sectionsAdd the maximum number of slides. If there's no limit, then add 10 slides.Test the following image sizes:2048px for retina displays1024px for standard widescreen displaysTest the following aspect ratios using 72ppi, portrait, and landscape:16:94:33:21:1Add video (if applicable)Add text:A headingA subheading (60 characters)A descriptionIf the text input is a plain single line text, then add 60-100 characters of textIf the text input is rich text, then add the following text:Text with a single line break (60-100 characters)Text with two line breaksText with three line breaksA paragraph (40-50 words)Add links:An internal linkAn external linkLink opens in the same windowLink opens in a new windowLink styling indicates that the text is clickableAdd button text:A single word label (30 characters, no spacing)A multiple word label (30 characters)Add button links:Internal linkExternal linkLink opens in the same windowLink opens in a new windowTest autoplay behavior:If multiple slideshows have autoplay enabled, then each slideshow autoplays as expectedSlideshow controls work as expected when slideshow is on autoplay ### Featured product 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 Add five featured product sections, three of which are the same productSelect different variants for one of the duplicated productsAdd one of the duplicated products to the cartPerform tests from the [product page checklist](#product-page) ### Featured collection 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 Add three featured collection sections, using collections of varying sizesPerform tests from the [collection page checklist](#collection-page) ### Collection list 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 Add the maximum number of collections. If there's no limit, then add 10 collections.Add a collection with a long titleAdd a collection with a single word title (30 characters, no spacing)Add a collection with a multi-word title (30 characters)Add collections where the collection images have different aspect ratios, in portrait and landscape orientations16:94:33:21:1Add one collection with no featured collection image ### Image with text 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 Add three image with text sectionsAdd text:A headingA subheading (60 characters)A descriptionIf the text input is a plain single line text, then add 60-100 characters of textIf the text input is rich text, then add the following text:Text with a single line break (60-100 characters)Text with two line breaksText with three line breaksA paragraph (40-50 words)Add links:An internal linkAn external linkLink opens in the same windowLink opens in a new windowLink styling indicates that the text is clickableTest the following image sizes:2048px for retina displays1024px for standard widescreenTest the following aspect ratios using 72ppi, portrait, and landscape:16:94:33:21:1 ### Newsletter 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 Test the following parts of the newsletter form:Input form textSubmit the formTest error detection and handlingTest the submission success messageAdd a description:If the text input is a plain single line text, then add 60-100 characters of textIf the text input is rich text, then add the following text:Text with a single line break (60-100 characters)Text with two line breaksText with three line breaksA paragraph (40-50 words)Add links:An internal linkAn external linkLink opens in the same windowLink opens in a new windowLink styling indicates that the text is clickable ### Rich text Run the following tests on your rich text section. For each of these tests, verify that all of the text is visible. Add a headingAdd a subheading (60 characters)Add a descriptionAdd multiple paragraphs (minimum 1000 characters)Add links:Internal linkAn external linkLink opens in the same windowLink opens in a new windowLink styling indicates that the text is clickable ### Blog posts 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 blog posts with different image aspect ratios:16:94:33:21:1Add a blog post with a long titleAdd a blog post with a single word title (30 characters, no spacing)Add a blog post with a multi-word title (30 characters) ### Video 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 Add a YouTube videoAdd a Vimeo videoAdd an MP4 video (if applicable) ### Unique sections 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 Add 2-3 instances of the same sectionAdd text:A headingA subheading (60 characters)A descriptionIf the text input is a plain single line text, then add 60-100 characters of textIf the text input is rich text, then add the following text:Text with a single line break (60-100 characters)Text with two line breaksText with three line breaksA paragraph (40-50 words)Add links:An internal linkAn external linkLink opens in the same windowLink opens in a new windowLink styling indicates that the text is clickableTest the following image sizes:2048px for retina displays1024px for standard widescreenTest the following aspect ratios using 72ppi, portrait, and landscape:16:94:33:21:1 *** ## 5.​Pages Test the following pages or elements in your theme: * [Password page](#password-page) * [Collection list page](#collection-list-page) * [Collection page](#collection-page) * [Product page](#product-page) * [Blog page](#blog-page) * [Blog post/article page](#blog-post-page-article) * [Cart](#cart-page-modal-or-drawer) * [Search page](#search-page) * [Pages](#pages) * [Page with a contact form](#pages-contact-form-template) * [Gift card page](#gift-card-page) ### Password page 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 Add logo fallback text:Long store name (30-40 characters, no spaces)Long store name with hyphensAdd a logo:Test the following logo aspect ratios using portrait and landscape:16:94:33:21:1Transparent background on PNG imageLogo scales appropriatelyTest the password form:Fill the email fieldSubmit the formTest error detection and handlingTest the submission success messageAdd a password message (500+ characters)Add different sized background images, if applicable:2048px for retina displays1024px for standard widescreenTest the following aspect ratios using portrait and landscape:16:94:33:21:1 ### Collection 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 Add a collection with a long titleAdd a collection with a single word title (30 characters, no spacing)Add a collection with a multi-word title (30 characters)Test the following aspect ratios using portrait and landscape:16:94:33:21:1Add a collection with no featured collection image ### Collection page 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 Test group filtering (if applicable)Add a single word tag (30 characters, no spacing)Add a long list of tags (20+ tags)Verify that only a limited number of products are displayed on initial loadTest pagination (if applicable)Pagination truncates on a collection with five or more pagesTest **View more** button (if applicable)Test infinite scrolling (if applicable)Add a product title:A single word title (30 characters, no spacing)A multi-word title (30-60 characters)Add a product vendor:A single word vendor (30 characters, no spacing)A multi-word vendor (30-60 characters)Test the way the grid responds to images of different aspect ratios, using portrait and landscape:16:94:33:21:1If the collection page has an **Add to cart** button, verify that it's replaced or disabled when a sold out or unavailable variant is selected.Verify that the sold out message or badge is displayed when applicable. ### Product page 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 #### Product configurations Single product (no variants)On sale productProduct with one optionProduct with more than 1 option with different variant quantity inventories (out of stock variant, unavailable variant).Product with three optionsProduct with 100 variantsProduct with no imageProduct with varying product media (image, vidoe, 3D model. AR, MP4)Product with unit price #### Tests Add a product title:A single word title (30 characters, no spacing)A multi-word title (30-60 characters)Verify that when variants are selected from drop-down menus, product details are updated dynamically:Variant pricesVariant mediaVariant SKUAction buttons (disable **Add to cart** and accelerated checkout buttons on sold out and unavailable variants)Variant selectors (cross out or disable sold out and unavailable variants)Unit price[Shop Pay Installments banner](https://shopify.dev/docs/storefronts/themes/store/test-theme/assets#shop-pay-installments)\ [Local pickup banner](#7-local-pickup)Inventory quantity (if applicable)Product imagesNo imageTest the following aspect ratios using portrait and landscape:16:94:33:21:1PNG imageImage zoom (if applicable)Color swatches (if applicable)Option to disable swatchesClear instruction on how to upload custom swatchesProduct descriptionAdd multiple paragraphs (minimum 1000 characters)Add links:Internal linkExternal linkLink opens in the same windowLink opens in a new windowLink styling indicates that the text is clickableAdd images (images must display as they appear in the rich text editor)Verify that an error message appears when customers try to add more than the available quantity of items to the cart ### Blog page 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 Test the way the grid responds to blog images of different aspect ratios, using portrait and landscape:16:94:33:21:1Test blog filtering (if applicable):Filter by a single-word tag (30 characters, no spacing)Filter by a long list of tags (20+ tags)Test a blog with many posts:Test pagination (if applicable)Verify that only five pages show on initial loadTest the **View more** button (if applicable)Test infinite scrolling (if applicable) ### Blog post page (Article) Run the following tests on your blog post page. Add blog post content:Add multiple paragraphs (minimum 1000 characters)Add links:Internal linkExternal linkLink opens in the same windowLink opens in a new windowLink styling indicates that the text is clickableAdd images (images must display as they appear in the rich text editor)Add comments:Input comment textSubmit the formTest error detection and handlingTest the submission success messageVerify that comments over a certain limit are paginatedTest the following blog post image aspect ratios using portrait and landscape:16:94:33:21:1 ### Cart 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 Add enough products to the cart to trigger scrollingSetting 0 for quantity should remove the productVerify that an error message appears when customers try to add more than the available quantity of items to the cartAutomatic discountCart notes ### Search page Run the following tests on your search page. For each of these tests, verify that search result attributes are fully visible. Verify that the number of results displayed on first load is limitedTest pagination (if applicable)Pagination truncates on search results with five or more pagesTest the **View more** button (if applicable)Test infinite scrolling (if applicable)Test filtering (if applicable)Test both list and grid view (if applicable)Test error detection and handling, for example, when no results are found ### Pages 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. Add a page title:A single word title (30 characters, no spacing)A multi-word title (30-60 characters)Add multiple paragraphs (minimum 3000 characters)Add links:Internal linkExternal linkLink opens in the same windowLink opens in a new windowLink styling indicates that the text is clickableAdd image—must display imagery as inputted in the RTERepeat testing for all existing product templates ### 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. Input textTest mandatory fields, such as the message fieldSubmit the formTest error detection and handlingTest the submission success message ### Gift card page 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. Add logo fallback text:Long store name (30-40 characters, no spaces)Long store name with hyphensAdd a logo:Test the following logo aspect ratios using portrait and landscape:16:94:33:21:1Transparent background on PNG imageLogo scales appropriatelyVarying positions/alignments (if applicable)Gift card code must not be cut off *** ## 6.​Link sharing Share a link to the store where you're testing your theme on various social media platforms. Verify that the sharing image appears. You can use tools like the [Facebook sharing debugger](https://developers.facebook.com/tools/debug/) and the [Twitter card validator](https://cards-dev.twitter.com/validator) to perform this test. *** ## 7.​Local pickup Test your local pickup banner in the following scenarios. Before you start, [prepare your store to test local pickup](https://shopify.dev/docs/storefronts/themes/store/test-theme/assets). **Variant 1** - available for pickup at five locations: Verify that the pickup banner appears ![](https://cdn.shopify.com/s/files/1/0548/7057/3112/files/21-04-70y89-qya2s.png?v=1617725022) When you click **Check availability at other stores**, verify that all locations are visible, and that you can scroll to see all location information **Variant 2** - available for pickup at only one location:Verify that the pickup banner appears Verify that the **Check availability at other stores** text is updated to **View store information** ![](https://cdn.shopify.com/s/files/1/0548/7057/3112/files/21-04-76ddj-srkun.png?v=1617725882)**Variant 3** - available for pickup at only two locations, and sold out one of those locations:Verify that the pickup banner appears, and indicates that the item is available or unavailable at one of the locations. Verify that the **Check availability at other stores** link is present ![](https://cdn.shopify.com/s/files/1/0548/7057/3112/files/21-04-nrv48-b86yx.png?v=1617726309) Verify that clicking on **Check availability at other stores** brings up only two locations ![](https://cdn.shopify.com/s/files/1/0548/7057/3112/files/21-04-z25uz-m131m.png?v=1617726500)**Variant 4** - only available at a location that doesn't offer pickup:Verify that the pickup banner is removed**Variant 5** - sold out at all locations:Verify that the pickup banner is removedVerify that the **Add to cart** button is changed to **Sold out**Ensure the pickup banner changes dynamically when a new variant is selected *** ## 8.​Unit pricing Test unit prices in your theme. Before you start, [prepare your store to test unit pricing](https://shopify.dev/docs/storefronts/themes/store/test-theme/assets). Verify that unit prices change dynamically on variant changeVerify that unit prices appear in the following locations:Product pageCollection page product cardsCart drawer, page, or popupCustomer order page *** ## 9.​Rich media Test rich media in your theme. Before you start, [prepare your store to test rich media](https://shopify.dev/docs/storefronts/themes/store/test-theme/assets). Verify 3D/AR behavior: Verify that you can view and move 3d models on desktop and mobile devices Verify that the **View in your space** button appears on mobile devices Verify that can view both AR objects on mobile devices Verify video behavior (YouTube, Vimeo, MP4):Verify that video controls are accessibleVerify that you can mute and unmute videosVerify that you can play and pause videosVerify that variant display when the associated variant is selectedVerify that rich media types don't break the product card layout of the collection page:YouTubeVimeoMP43D models *** ## 10.​Selling plans Test selling plans in your theme. Before you start, [prepare your store to test selling plans](https://shopify.dev/docs/storefronts/themes/store/test-theme/assets). Applied selling plans appear on the cart pageApplied selling plans appear on the customer order page *** * [1.​Home page](https://shopify.dev/docs/storefronts/themes/store/test-theme/checklist.md#1-home-page) * [2.​Header](https://shopify.dev/docs/storefronts/themes/store/test-theme/checklist.md#2-header) * [3.​Footer](https://shopify.dev/docs/storefronts/themes/store/test-theme/checklist.md#3-footer) * [4.​Sections](https://shopify.dev/docs/storefronts/themes/store/test-theme/checklist.md#4-sections) * [5.​Pages](https://shopify.dev/docs/storefronts/themes/store/test-theme/checklist.md#5-pages) * [6.​Link sharing](https://shopify.dev/docs/storefronts/themes/store/test-theme/checklist.md#6-link-sharing) * [7.​Local pickup](https://shopify.dev/docs/storefronts/themes/store/test-theme/checklist.md#7-local-pickup) * [8.​Unit pricing](https://shopify.dev/docs/storefronts/themes/store/test-theme/checklist.md#8-unit-pricing) * [9.​Rich media](https://shopify.dev/docs/storefronts/themes/store/test-theme/checklist.md#9-rich-media) * [10.​Selling plans](https://shopify.dev/docs/storefronts/themes/store/test-theme/checklist.md#10-selling-plans)