# ABConvert - [ABConvert: Shopify A/B Testing Built for Revenue Growth](https://docs.abconvert.io/introduction.md): A/B test prices, shipping, checkout, and content on Shopify. Make data-driven decisions with full-funnel analytics and statistical confidence. - [Onboarding ABConvert](https://docs.abconvert.io/onboarding.md): Install ABConvert, walk through tutorials, and launch your first A/B test - [Idea Bank](https://docs.abconvert.io/idea-bank.md): Find your next A/B test based on what you want to improve in your Shopify store. - [Pricing Plans](https://docs.abconvert.io/configuration/pricing-plans.md): Find the plan that best fits your needs - [Billing Usage and Overage](https://docs.abconvert.io/configuration/billing-usage.md): Learn which orders ABConvert counts as billable orders and how ABConvert calculates overage. - [Annual Plans: Pay Yearly and Get Two Months Free](https://docs.abconvert.io/configuration/annual-plans.md): How ABConvert annual billing works: yearly pricing, monthly included orders, what happens when you run out, plan changes, and cancellation. - [Add Orders: Buy Extra Billable Orders](https://docs.abconvert.io/configuration/add-orders.md): On an annual plan, buy extra billable orders in packs of 1,000 when a month's included orders run out: prices, when they expire, and how they're used. - [Overview](https://docs.abconvert.io/experiments/overview.md): Understand what ABConvert tests have in common, then find a guide for the test type you want to run. - [Test lifecycle](https://docs.abconvert.io/experiments/lifecycle.md): The states a test moves through, and the key actions at each one. - [Schedule a test](https://docs.abconvert.io/experiments/schedule.md): Plan your testing, and ABConvert executes it for you. - [Price Test: Getting Started](https://docs.abconvert.io/experiments/price-test.md): A/B test product prices to identify the pricing strategy that drives the best business outcome. - [Shipping Test: Getting Started](https://docs.abconvert.io/experiments/shipping-test.md): A/B test shipping rates and free shipping thresholds to find the strategy that maximizes checkout conversion. - [Offer Test: Getting Started](https://docs.abconvert.io/experiments/offer-test.md): Run A/B tests on automatic discounts to measure their impact on revenue, average order value, and conversion. - [URL Redirect Test: Getting Started](https://docs.abconvert.io/experiments/url-redirect-test.md): A/B test different landing pages to identify the page design that drives the highest conversion rate. - [Template Test: Getting Started](https://docs.abconvert.io/experiments/template-test.md): A/B test Shopify page templates to find the layout that drives the highest conversion rate. - [Theme Test: Getting Started](https://docs.abconvert.io/experiments/theme-test.md): A/B test your entire Shopify theme to identify the design that drives the most revenue and conversions. - [Visual Editor Test: Getting Started](https://docs.abconvert.io/experiments/visual-editor-test.md): A/B test changes to the content and layout of your store pages, made in the store editor or the in-app editor, without touching theme code. - [Store Editor](https://docs.abconvert.io/experiments/visual-editor.md): Change what shoppers see on any page of your store, through your AI or by hand, without touching theme code. - [In-App Editor](https://docs.abconvert.io/experiments/in-app-editor.md): Build a test group's changes inside the ABConvert admin, with your store shown in a frame. - [Checkout test](https://docs.abconvert.io/experiments/checkout-test.md): A/B test changes to your Shopify checkout to see what lifts orders and revenue. - [Subscription test](https://docs.abconvert.io/experiments/subscription-test.md): Compare Recharge, Stay.AI, or SKIO subscription offers across products, including one-time purchase test groups. Measure first orders for every provider and later subscription outcomes with Recharge or SKIO. - [Combined Test: Getting Started](https://docs.abconvert.io/experiments/combined-test.md): A/B test multiple changes together in one test so each visitor sees one coherent experience. - [Custom Code](https://docs.abconvert.io/experiments/custom-code.md): Add JavaScript or CSS to a test group of any test, so a variant can change how the page behaves or looks without a theme edit. - [Overview](https://docs.abconvert.io/targeting/overview.md): Choose who enters a test and which pages it runs on. - [Audience Targeting](https://docs.abconvert.io/targeting/audience-targeting.md): Target only the visitors you want in the test. - [Custom JavaScript](https://docs.abconvert.io/targeting/custom-javascript.md): Write one JavaScript expression that runs on your storefront to decide whether a visitor enters a test. - [Page Targeting](https://docs.abconvert.io/targeting/page-targeting.md): Choose which pages a template or visual editor test runs on. - [Personalization](https://docs.abconvert.io/personalization/overview.md): Give each audience the best version of your store. Test to find the winner, then roll it out to the visitors it won for. - [Analytics Overview: Understanding Your A/B Test Results](https://docs.abconvert.io/analytics/overview.md): Learn how to read the Analytics dashboard for a test, from the result summary at the top to the detailed performance and breakdown tables. - [How to Interpret Analytics Results and Choose a Next Action](https://docs.abconvert.io/analytics/interpret-results.md): Turn a test result into a decision: roll out the change, keep Control, or test a different idea. - [Statistical Significance in A/B Testing Explained](https://docs.abconvert.io/analytics/statistical-significance.md): Learn how to read the Confidence number, p-values, and uplift ranges in your test results. - [Analytics Metrics: How ABConvert Groups and Calculates Them](https://docs.abconvert.io/analytics/metrics.md): See how ABConvert groups metrics, where the data comes from, and jump to detailed guides for traffic, conversion, revenue, profit, and discount metrics. - [Set Up Custom Events](https://docs.abconvert.io/analytics/custom-events.md): Create and verify custom events for storefront actions that Shopify's standard web pixel events do not cover. - [Traffic and Conversion Metrics](https://docs.abconvert.io/analytics/metrics-traffic-conversion.md): Understand how ABConvert derives visitor and session metrics, maps funnel steps to Shopify standard events, and calculates conversion and abandonment rates. - [Revenue and Profit Metrics](https://docs.abconvert.io/analytics/metrics-revenue-profit.md): Learn how ABConvert calculates revenue and profit metrics and how to use them for ecommerce decisions. - [Discount Metrics](https://docs.abconvert.io/analytics/metrics-discount.md): Understand where discount values come from in ABConvert and how to use discount metrics to evaluate offer test impact. - [Use Custom Events in Analytics](https://docs.abconvert.io/analytics/custom-event-results.md): Use custom events as visitor filters, session-based funnel steps, and descriptive trigger-rate metrics in test Analytics. - [Engagement Metrics: Measure How a Variant Affects a Page](https://docs.abconvert.io/analytics/engagement-metrics.md): Understand whether a variant makes a page or template more engaging: how often visitors click through, how often they bounce, and how long they actively stay. - [Product Groups: Analyze Test Results by Product](https://docs.abconvert.io/analytics/product-groups.md): Bring a product-level view to your test: filter the Analytics dashboard to a set of products and see how each one responded. - [App Settings: Configure ABConvert for Your Store](https://docs.abconvert.io/configuration/settings.md): Control how ABConvert runs on your store, from tracking scripts and order tagging to COGS configuration. - [Integrations](https://docs.abconvert.io/integrations/overview.md): Configure ABConvert with analytics, session replay, data warehouse, marketing, and subscription tools that already run on your Shopify storefront. - [Microsoft Clarity Integration](https://docs.abconvert.io/integrations/clarity.md): Tag Microsoft Clarity recordings, heatmaps, and dashboard sessions with the ABConvert test and test group a visitor sees. - [Hotjar Integration](https://docs.abconvert.io/integrations/hotjar.md): Send an ABConvert test and test-group attribute plus an assignment event to Hotjar sessions for recordings, heatmaps, and surveys. - [Contentsquare Integration](https://docs.abconvert.io/integrations/contentsquare.md): Add an ABConvert dynamic variable to each assigned Contentsquare session so you can segment journeys, zones, and replays by test group. - [Heatmap Integration: Filter Heatmaps and Recordings by Test Group](https://docs.abconvert.io/integrations/heatmap.md): Tag every Heatmap session with the visitor's ABConvert test and test group, so you can view heatmaps and recordings for one test group at a time. - [Heap integration](https://docs.abconvert.io/integrations/heap.md): Tag Heap storefront activity with ABConvert test groups to compare visitor behavior across your tests. - [Amplitude Integration](https://docs.abconvert.io/integrations/amplitude.md): Send a native Amplitude exposure event when an eligible visitor sees an ABConvert test group, then analyze behavior by exposure. - [Mixpanel Integration](https://docs.abconvert.io/integrations/mixpanel.md): Send a Mixpanel experiment exposure and a per-test super property when a visitor sees an eligible ABConvert test group. - [Segment Integration: Send Test Assignments to Segment](https://docs.abconvert.io/integrations/segment.md): Send an Experiment Viewed event to your Segment source each time a visitor enters a test, so every destination behind Segment can segment by test group. - [Klaviyo Integration: Test Groups in Klaviyo and Segments as Audiences](https://docs.abconvert.io/integrations/klaviyo.md): Send each visitor's test group to their Klaviyo profile, and target tests at the people in a Klaviyo segment. - [BigQuery Export](https://docs.abconvert.io/integrations/bigquery.md): ABConvert copies your test data into a BigQuery dataset you own, once a day, under a stable schema, so your data team can join test results with the rest of your warehouse. - [Recharge integration](https://docs.abconvert.io/integrations/recharge.md): Connect Recharge to compare subscription offers and track first purchases, renewals, and cancellations by test group. - [Stay.AI integration](https://docs.abconvert.io/integrations/stay.md): Connect Stay.AI to compare subscription plans, first orders, renewals, retention, and churn by test group. - [SKIO integration](https://docs.abconvert.io/integrations/skio.md): Connect SKIO to compare existing subscription plans and track verified renewals and cancellations by test group. - [Third-party analytics integrations](https://docs.abconvert.io/configuration/third-party-analytics.md): Send ABConvert test assignments to your existing analytics tools without duplicating their browser SDKs or storefront events. - [GA4 Integration: Track Tests in Google Analytics](https://docs.abconvert.io/configuration/ga4-integration.md): Connect ABConvert to GA4 to receive test impression events and analyze test group performance alongside your other Google Analytics data. - [Shopify Sidekick data extension](https://docs.abconvert.io/sidekick/data-extension.md): Ask Shopify Sidekick to find ABConvert tests, summarize results, explore audience breakdowns, and open detailed Analytics without leaving Shopify Admin. - [Drive ABConvert from Claude with MCP](https://docs.abconvert.io/mcp/overview.md): Run A/B tests by talking to Claude in plain English. ABConvert's Model Context Protocol (MCP) integration lets Claude Desktop, Claude Code, and other AI assistants create, launch, analyze, and end tests without leaving the chat. - [Connect an AI assistant to ABConvert in 5 minutes](https://docs.abconvert.io/mcp/quickstart.md): Connect Claude or another MCP client to ABConvert through Claude’s connector directory or with an API token, then run your first test prompt. - [Connect ABConvert to Claude](https://docs.abconvert.io/mcp/claude-connector.md): Find ABConvert in Claude’s connector directory and authorize it with a one-time connect code from your store. - [What Claude can do for you](https://docs.abconvert.io/mcp/tools.md): Every operation Claude can perform on your behalf, grouped by intent. You don't need to memorize tool names — Claude picks them based on what you ask. - [MCP troubleshooting](https://docs.abconvert.io/mcp/troubleshooting.md): Common errors and how to fix them. - [Security & token management](https://docs.abconvert.io/mcp/security.md): How API tokens and URL-only OAuth connectors work, and what protects your store by default. - [Subscription test tutorial](https://docs.abconvert.io/help/subscription-test-tutorial.md): Create and preview a Recharge, Stay.AI, or SKIO subscription test with a step-by-step screenshot guide. - [Frequently Asked Questions — ABConvert](https://docs.abconvert.io/help/faq.md): Answers to the most common questions about ABConvert: how tests work, plan requirements, traffic splitting, order attribution, and multi-market testing. - [Troubleshooting Common ABConvert Issues](https://docs.abconvert.io/help/troubleshooting.md): Step-by-step guides for the most common problems when running and analyzing your tests - [Data and Privacy: How ABConvert Handles Your Shoppers' Data](https://docs.abconvert.io/help/data-and-privacy.md): What ABConvert collects from your storefront, what it never collects, who else sees it, and how long it is kept. - [Changelog](https://docs.abconvert.io/changelog/overview.md): Recent updates, improvements, and fixes shipped to ABConvert. - [API overview](https://docs.abconvert.io/api-reference/overview.md): The ABConvert API is a REST API for creating tests, managing their lifecycle, and reading results. - [Authentication](https://docs.abconvert.io/api-reference/authentication.md): Authenticate every ABConvert API request with a bearer token scoped to one shop. - [List tests](https://docs.abconvert.io/api-reference/experiments/list-tests.md): Returns a cursor-paginated page of tests, and omits archived tests unless you pass `status=archived`. - [Create a test](https://docs.abconvert.io/api-reference/experiments/create-a-test.md): Creates a test in `draft`. Launching is a separate step: call [`POST /experiments/{id}/start`](/api-reference/lifecycle/launch-a-test). - [Retrieve a test](https://docs.abconvert.io/api-reference/experiments/retrieve-a-test.md): Returns one test by ID, with the full `changes` on every test group. - [Update a test](https://docs.abconvert.io/api-reference/experiments/update-a-test.md): Updates a test in place. Send only the fields you want to change: a field you leave out stays as it is. - [Launch a test](https://docs.abconvert.io/api-reference/lifecycle/launch-a-test.md): Launches a test. Use the same call from `draft` or from `preview`. - [Preview a test](https://docs.abconvert.io/api-reference/lifecycle/preview-a-test.md): Moves a `draft` test into preview. On a test that is already in `preview`, it returns 200 with a fresh set of preview URLs and changes nothing. - [Convert a test to draft](https://docs.abconvert.io/api-reference/lifecycle/convert-a-test-to-draft.md): Returns a test from `preview` to `draft`. Only a test in `preview` can revert; from any other status this returns 409 `invalid_status_transition`, with the actions you can take in `details.allowed_actions`. - [Pause a test](https://docs.abconvert.io/api-reference/lifecycle/pause-a-test.md): Pauses an `active` test. On a test that is already `paused`, it returns 200 and changes nothing. - [Resume a test](https://docs.abconvert.io/api-reference/lifecycle/resume-a-test.md): Resumes a `paused` test. On a test that is already `active`, it returns 200 and changes nothing. - [End a test](https://docs.abconvert.io/api-reference/lifecycle/end-a-test.md): Ends an `active` or `paused` test. The ended test keeps its final results snapshot. - [Archive a test](https://docs.abconvert.io/api-reference/lifecycle/archive-a-test.md): Archives a `draft`, `preview`, `failed`, or `ended` test. End an `active` or `paused` test first: archiving one of those returns 409 `invalid_status_transition`. - [Set the schedule window](https://docs.abconvert.io/api-reference/experiments/set-the-schedule-window.md): Sets the window the test runs in: it launches at `start_at` and ends at `end_at`. - [Clear the schedule window](https://docs.abconvert.io/api-reference/experiments/clear-the-schedule-window.md): Removes the schedule, so the test no longer starts or ends on its own. This call succeeds on a launched test: launch has already spent its `start_at`, so clearing the window only drops `end_at`, and the test then runs until you end it. The response carries `schedule: null`. - [Retrieve the results snapshot](https://docs.abconvert.io/api-reference/results/retrieve-the-results-snapshot.md): Returns the latest results for a test: the same numbers you see on that test's Analytics dashboard in the ABConvert admin, as of the last time they were computed. Beta. - [Create a custom result query](https://docs.abconvert.io/api-reference/results/create-a-custom-result-query.md): Creates a custom result query, or reuses one already computed. Beta. - [Retrieve a custom result query](https://docs.abconvert.io/api-reference/results/retrieve-a-custom-result-query.md): Returns a custom result query by id. Beta. - [Create an export job](https://docs.abconvert.io/api-reference/exports/create-an-export-job.md): Starts an export of the test's order-level data for a date range. The job runs asynchronously, so poll [`GET /exports/{id}`](/api-reference/exports/retrieve-an-export-job) until it completes, then fetch the file from the `url` that job carries. The cookbook's [order export](https://github.com/ABConv… - [Retrieve an export job](https://docs.abconvert.io/api-reference/exports/retrieve-an-export-job.md): Returns the job's current status. `url` holds the signed download link while the file is still available, which means the job is `completed` and `expires_at` is in the future. Once `expires_at` passes, the job stays `completed` and `url` goes null. Branch on `url`, not on `status`. - [Download an export file](https://docs.abconvert.io/api-reference/exports/download-an-export-file.md): Streams the finished export as CSV, one row per attributed order. `Experiment ID` carries the test's numeric ID and `Test Group` carries the test group's index, so a row joins back to `GET /v1/experiments/{id}`. Test group names live on the test, not in the file. - [JavaScript API](https://docs.abconvert.io/api-reference/browser-api.md): Use the JavaScript API to read a visitor's test group, price, shipping rates, cart offer, and assigned subscription plan on a live storefront page. - [JavaScript API examples](https://docs.abconvert.io/api-reference/browser-api-examples.md): Use the JavaScript API for four common jobs: send assignments to your analytics tools, and show a test price, a free shipping bar, or an offer banner on your storefront. - [JavaScript API reference](https://docs.abconvert.io/api-reference/browser-api-reference.md): Every global, method, event, and object on window.ABConvert. - [Headless SDK](https://docs.abconvert.io/headless-sdk/overview.md): Use the headless SDK to run ABConvert tests on a custom storefront built with Hydrogen, Next.js, or the Storefront API. - [Headless SDK on Next.js](https://docs.abconvert.io/headless-sdk/nextjs.md): Set up the ABConvert headless SDK on a Next.js App Router storefront in five steps. - [Headless SDK on Hydrogen](https://docs.abconvert.io/headless-sdk/hydrogen.md): Set up the ABConvert headless SDK on a Hydrogen storefront in five steps. - [Headless SDK on other stacks](https://docs.abconvert.io/headless-sdk/other-stacks.md): Set up the ABConvert headless SDK on any server that uses the Storefront API, in the browser only, or without React. - [Show test prices, shipping rates, and offers](https://docs.abconvert.io/headless-sdk/prices.md): Render the price, shipping rates, and offers that the visitor's test group gets. - [Connect the cart and checkout](https://docs.abconvert.io/headless-sdk/cart.md): Write ABConvert's cart attributes so Shopify checkout applies the test, including for express checkout buttons. - [URL redirect tests on a custom storefront](https://docs.abconvert.io/headless-sdk/url-redirects.md): Send each visitor to their test group's page from your server, before the original page renders. - [Read the visitor's test group](https://docs.abconvert.io/headless-sdk/test-groups.md): Read which test group a visitor is in, to keep your storefront consistent with a test or to send the test group to another tool. - [Feature tests](https://docs.abconvert.io/headless-sdk/feature-tests.md): Run a feature test to compare versions of a feature you build yourself, such as a new hero section or a different layout. - [Targeting on a custom storefront](https://docs.abconvert.io/headless-sdk/targeting.md): How ABConvert targeting works with the headless SDK, and which visitor details your storefront supplies. - [Tracking and cookies](https://docs.abconvert.io/headless-sdk/tracking.md): What the headless SDK tracks for your test results, what you track yourself, and which cookies it sets. - [Preview and check your integration](https://docs.abconvert.io/headless-sdk/preview.md): See one test group on your storefront, and confirm your integration applies a test all the way through checkout. - [Loading and failures](https://docs.abconvert.io/headless-sdk/loading.md): How the headless SDK loads your tests, how soon a change reaches your storefront, and what a visitor sees if loading fails. - [Next.js caching and CDN](https://docs.abconvert.io/headless-sdk/nextjs-caching.md): How the headless SDK keeps one cached copy per test group on Next.js, and how to fit it to your own middleware, product pages, revalidation, and CDN. - [Hydrogen full-page cache](https://docs.abconvert.io/headless-sdk/hydrogen-caching.md): Keep a route that Oxygen's full-page cache stores from serving one visitor's test group to everyone. - [Headless SDK reference](https://docs.abconvert.io/headless-sdk/reference.md): Every entry point, function, option, and object of the ABConvert headless SDK, with its arguments and what it returns. ## OpenAPI Specs - [openapi](/api-reference/openapi.yaml) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.