Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.abconvert.io/llms.txt

Use this file to discover all available pages before exploring further.

​
What is a template test?

A template test lets you assign different Shopify theme templates to different groups of visitors for the same product, collection, or page. This is the best test type for structural layout changes, reordering Shopify sections, or testing different third-party app block placements — all built natively within the Shopify Theme Editor.

​
Template test use cases

  • Test product page layouts: Compare a traditional two-column product layout against a modern long-form storytelling template.
  • Test section order: See if moving customer reviews and trust badges higher on the page increases your add-to-cart rate.
  • Test app block placements: Test whether placing an upsell app above the add-to-cart button performs better than placing it below the product description.
  • Test distinct visual styles: Test a completely different color scheme, typography, or styling for a specific promotional collection page.

​
Set up a template test

1

Create your alternative templates in Shopify

Before creating a test in ABConvert, open the Shopify Theme Editor for your live theme. Create the alternative templates (e.g., a new product template called product.variant-b) and design the layout and sections for your test.
2

Create a new template test

In the ABConvert dashboard, click Create New Test and select Template Test.
3

Add basic information and configure traffic split

Enter a descriptive name for your experiment, write a clear hypothesis, and select your primary success metric. By default, traffic is split evenly between the Control and Variant groups. You can adjust the traffic allocation or add additional variants.
4

Configure your audience

Define which visitors should enter the experiment using audience targeting and traffic allocation rules. Read more in the Audience targeting guide.
5

Select your control and variant templates

Choose the specific product, collection, or page templates you want to test. You can choose from all template types: Homepage, Collections, Products, Pages, Cart, Blogs, Articles, Search.
Clean Shot 2026 05 26 At 14 20 50@2x
Use Compare variants to preview and compare each group in desktop or mobile view.
Clean Shot 2026 05 26 At 14 29 49@2x
Clean Shot 2026 05 26 At 14 34 47@2x
6

Review and launch

Review your full experiment configuration. We recommend using Preview test to verify that the correct template variations are loading for each group before launching. When everything looks correct, click Launch test.

​
Template test FAQs

No. You only need to create a new template within your existing active theme (for example, a new product template called product.test). You do not need to publish a completely separate theme.
ABConvert pulls templates from your current live theme. Make sure the original template exists in your live theme, not in an unpublished draft theme. If you just created the template, try refreshing the ABConvert app to sync the latest templates from Shopify.
No. ABConvert can only assign templates that exist within your currently active Shopify theme. If you want to test an entirely different theme, run a Theme Test instead.
1. Create your alternate homepage templateShopify doesn’t allow you to add multiple homepage templates directly in the Theme Editor, but ABConvert makes it easy.
  1. In ABConvert, go to Create new test > Template test
  2. In the Create variants section:
    • Set your current homepage template as the original
    • Click Create a duplicate to generate a variant template
2. Edit your alternate homepage templateOnce the variant template is created:
  1. Click Edit in Shopify next to the variant
  2. This opens the template inside Shopify’s Theme Editor
  3. Make your design changes, then click Save
3. Review and launchReview your settings and click Launch test to start your homepage test.
Currently, there is no “select template” option for the home page. Due to a Shopify’s constraint, if you end a successful template test on the homepage, you cannot directly apply the winning template.To apply the winning design manually: open the Theme Editor, navigate to the Home page, and update the live template to match your winning variant.
Method 1: Use advanced conditionsThis method is ideal if you’re targeting only a few specific products.
  1. Create a new template test
  2. Go to Advanced settings
  3. Select the second radio button: Yes, only include the conditions below
  4. Add a condition:
    • Choose Page URL
    • Choose matches exactly
    • Enter the product page relative path, for example /products/my-cool-product
  5. Repeat for each additional product page you want to include
Screenshot 2026 05 20 At 16 49 04
Method 2: Duplicate the original templateIf you want to run the test on a large group of products, adding URL conditions one by one is time-consuming. Instead, use Shopify’s template assignment to target entire product groups.
  1. In your Shopify theme editor, duplicate your current product template
  2. Name it something like product-template-a
  3. Assign this duplicated template to all the products you want included in the test (for example, all lamp products)
  4. In ABConvert, open your test setup and select:
    • Original template: the duplicated product-template-a you just assigned
    • Variant template: the new template you want to test
In this setup, only products using product-template-a will be included in the test.