Navigation

Installation Guide

Last updated: May 15, 2026

Step 1: Install from the Shopify App Store

  1. Open the Simple Split Testing listing on the Shopify App Store
  2. Click Add app and install

You’ll land in the Simple Split Testing dashboard inside your Shopify admin, on the Split tests page.

Step 2: Enable the theme app embed

Variant assignment only runs when the Split Embed Script app embed is enabled in your theme.

  1. In Shopify admin, go to Online Store → Themes → Customize
  2. Open the App embeds panel in the left rail
  3. Toggle on Split Embed Script
  4. Save

The embed injects a small script into your store’s <head> on every page load. While no tests are active, the script short-circuits before any network call, so an installed-but-idle app has no measurable cost per page view.

Step 3: Confirm the web pixel is active

The web pixel forwards storefront events (page views, cart adds, orders, custom events) to the app so conversions can be counted. The app installs the pixel automatically on first install.

If something went wrong, a yellow “Web pixel isn’t active” banner appears at the top of every page in the app. Click Open Customer Events in the banner to activate it manually in Shopify admin, or reinstall the app to retry automatic setup.

The events the pixel forwards are derived from the standard event list plus anything you’ve defined under Custom events. You don’t pick events here.

Step 4: Create your first test

  1. From the Split tests page, click New
  2. Name the test
  3. Define two or more variants (control plus one or more challengers)
  4. Pick the primary KPI (conversion rate, AOV, sessions, or add-to-cart rate)
  5. Set a confidence level (90, 95, or 99 percent) and audience rules
  6. Click Save as draft

Step 5: Mark up your theme

Edit your theme code and add data-split-id and data-split-variant attributes to the elements you want to vary. Full reference: storefront markup.

Step 6: Preview

From the draft test, click Preview next to a variant to copy a signed preview URL. Open it in a new tab. A banner in the top right confirms preview mode. Verify each variant renders the way you expect. See preview links.

Step 7: Activate

Back on the test page, activate it. Visitors start getting bucketed immediately. Results stream into the test page within a few minutes once you have visitors.