Theme connection
The ABConvert unified script must be activated in your theme for experiments to run. This app embed loads the tracking and experiment logic on every page of your storefront. You can check connection status or change methods here.
Check status or switch methods here
Connect method 1: Theme embed app (recommended)
- Click Change method
- Choose Use app embed

Choose use app embed to connect
- Follow the steps to enable in Shopify theme editor and click Verify status to check

Follow the steps to enable ABConvert app in your theme
Connect method 2: Manual installation (for edge cases)
If your theme has a unique pattern or needs special configuration for better performance, you can install the script manually by adding a code snippet to your theme’stheme.liquid file. This method requires manual management to your theme files, only change to this method when needed.
Steps for manual installation:
- Click Change method
- Choose Add script to theme code

Choose add script to theme code to connect
- Follow the steps to add scripts to your Shopify theme.liquid file

Follow the steps to add script to your theme code
theme.liquid file.
WebPixel status
ABConvert uses a Shopify web pixel to track visitor events — page views, add-to-cart, checkout — with high accuracy. The web pixel is required for accurate analytics. Without it, ABConvert cannot collect and show experiment data correctly in analytics dashboard. If the web pixel is not enabled, please create Webpixel before start a test. If it becomes misconfigured, use the Reset option to recreate it.
Make sure the WebPixel is enabled
Carrier service
Carrier service configuration is required for shipping rate experiments. When a carrier service is registered, ABConvert intercepts Shopify’s shipping rate requests and returns the test rates for visitors in the experiment group. The Settings page shows whether a carrier service is currently configured. You can delete the carrier service from this page if you no longer need shipping tests.
Before running shipping test, check if the carrier service is registered
Order tag
ABConvert can automatically tag orders with experiment data, making it easy to segment orders by test group in your Shopify admin or in reports exported from ABConvert.
Order tag status

Configure order tags for each test type
Price test method
ABConvert evaluates your store during setup and assigns the optimal price test method. Currently, you cannot switch your method on your own, and all stores will be using Shopify function by default.
Check your price test method
Order outlier filter
The order outlier filter excludes unusually large orders from your Analytics dashboard, preventing them from skewing your experiment results.
Order outlier filter
Maximum revenue per order
Set a dollar threshold (e.g., $500). Any order above this amount is excluded from analytics. Use this when you know the upper bound of typical orders for your store.Z-score exclusion
Define a threshold between 1 and 5 (typical range: 2 to 4). Higher values keep more orders; lower values exclude more outliers. A threshold of 3 excludes orders more than 3 standard deviations from the mean.COGS settings
ABConvert uses your COGS (cost of goods sold) data to calculate profit metrics in analytics, including Profit per Visitor, Profit Uplift, and other profit-based comparisons.
COGS setup

Configure COGS setup
- Automatic mode: Sync product costs directly from Shopify. Choose daily sync frequency if your costs change often.
- Manual mode: Upload a CSV file with product costs for more control
- Set your average shipping or fulfillment cost per order
- Configure payment processing fees as percentage + fixed amount (e.g., 2.9% + $0.30)
- Override base product costs by quantity tier for wholesale or bulk order scenarios
- Define cost breaks at different quantity thresholds
Product groups
Product groups are reusable sets of products you can apply as a filter on a test’s Analytics dashboard. Build one from a collection, tag, product type, or a hand-picked list. Click Manage Product Groups to create and edit them. See Product Groups for how to use them in analytics.GA4 Measurement ID
Enter your Google Analytics 4 Measurement ID here to connect ABConvert to your GA4 property. When configured, ABConvert fires a custom event in GA4 each time a visitor is assigned to an experiment, letting you analyze experiment data alongside your other GA4 metrics. See GA4 Integration for setup instructions.Settings FAQs
Do I need to keep the ABConvert app embed turned on?
Do I need to keep the ABConvert app embed turned on?
What should I do after changing or publishing a new theme?
What should I do after changing or publishing a new theme?
What happens if ABConvert is not connected?
What happens if ABConvert is not connected?
What should I do if my test feels slower or I notice flickering?
What should I do if my test feels slower or I notice flickering?