> ## 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.

# Checkout test

> A/B test changes to your Shopify checkout to see what lifts orders and revenue.

A checkout test splits your visitors into test groups, shows each test group a different checkout, and measures which completes more orders. You decide what every test group sees, and ABConvert compares the results.

> [!NOTE]
>
> Checkout tests are available on all ABConvert plans. Delivery and Payment changes work on any Shopify plan. Content, Cart, and Upsell changes on the Checkout page require **Shopify Plus**. [Thank you page](#thank-you-page) and [Order status page](#order-status-page) blocks work on every Shopify plan except **Shopify Starter**.

## When to use it

Use a checkout test to prove a change lifts orders or revenue before rolling it out:

* **Raise order value with an upsell.** Show a product recommendation inside checkout and compare average order value against Control.
* **Win more orders with reassurance.** Add trust badges, a guarantee banner, or payment icons, and measure whether more visitors finish.
* **Guide shipping choice.** Rename or reorder shipping options to make a faster option clearer.
* **Streamline payment methods.** Hide, rename, or reorder payment methods and measure the effect on completed checkouts.

## When NOT to use it

Checkout tests change only what visitors see *at checkout*. If your change happens earlier, use the test built for that surface:

* **Testing a product's price?** Use a [price test](https://docs.abconvert.io/experiments/price-test.md). Checkout tests don't change the price shoppers pay.
* **Testing a discount or promotion?** Use an [offer test](https://docs.abconvert.io/experiments/offer-test.md). A checkout test can rename a payment method but can't discount it.
* **Testing subscription plans?** Use a [subscription test](https://docs.abconvert.io/experiments/subscription-test.md) to assign a Recharge, Stay.AI, or SKIO plan to each test group on a product page.
* **Testing a landing or product page?** Use a [URL redirect test](https://docs.abconvert.io/experiments/url-redirect-test.md), a [template test](https://docs.abconvert.io/experiments/template-test.md), or a [visual editor test](https://docs.abconvert.io/experiments/visual-editor-test.md). Checkout tests don't touch the pages leading up to checkout.

## What you can change

A checkout test can modify eight things. Combine several in one variant, and give each variant its own set.

| Category | What it changes |
| - | - |
| **Delivery** | Which shipping options shoppers see at checkout and how they're labeled. |
| **Payment** | Which payment methods shoppers see and how they're labeled. |
| **Content** | Adds visual blocks (banners, trust badges, benefits, images) that build confidence. |
| **Cart** | Whether shoppers can edit cart lines at checkout: change product variant, quantity, or remove items. |
| **Upsell** | Recommends extra products at checkout so shoppers add them without leaving the page. |
| **[Post-purchase offer](#post-purchase-offers)** | Offers one product on the page after payment, at one discount or a choice of quantities, added to the order in one click. |
| **[Thank you page](#thank-you-page)** | Adds a heading, banner, button, benefit list, image, or [next-order discount](#next-order-discount) to the page buyers see after they place the order. |
| **[Order status page](#order-status-page)** | Adds the same blocks to the page buyers open later to check on their order. |

## Set up a checkout test

**1. Add basic information**

Choose the **Checkout** type, name the test, set a hypothesis, pick your primary metric, and add the variants to test against Control.

**2. Set targeting**

Decide who enters the test and how much traffic it gets. See [Targeting](https://docs.abconvert.io/targeting/overview.md).

**3. Add modifications and preview as you build**

Open the **Compose checkout** editor for a test group, click **Add change**, pick a category, and configure it.

A live preview on the right updates as you build, and the tabs at the top switch which test group you're previewing. It's an approximation of your checkout; confirm the real thing on your storefront before launch (see [Preview on your storefront](#preview-on-your-storefront)).

![Compose checkout editor showing a live preview with Added badges on an upsell block and a trust badge](https://mintcdn.com/abconvert/AyyrFayJ3WDTY1DM/images/checkout-test-compose-preview.jpeg?fit=max\&auto=format\&n=AyyrFayJ3WDTY1DM\&q=85\&s=c6b20de6f8ea8496578561591ee6fedd)

Compose checkout editor with live preview.

Two toggles help while you build:

* **Show diff markers** flags how the test group differs from the original checkout page: **Added** and **Modified** blocks get a solid ring, **Hidden** ones a dashed ring.
* **Desktop / Mobile** switches the viewport.

> [!NOTE]
>
> Check the **Mobile** viewport too. Most checkout traffic is on mobile, and the desktop and mobile views can differ, so a block that looks right on one may not on the other.

![Compose checkout preview in the mobile viewport with a collapsed order summary bar](https://mintcdn.com/abconvert/AyyrFayJ3WDTY1DM/images/checkout-test-compose-preview-mobile.png?fit=max\&auto=format\&n=AyyrFayJ3WDTY1DM\&q=85\&s=2f0a1ee3187981ce45cd9db2f2095576)

Mobile viewport preview.

**4. Save and add your blocks**

Click **Save**. ABConvert shows a card listing the blocks to add in the Shopify checkout editor. See [Add your blocks](#add-your-blocks-in-the-checkout-editor).

**5. Preview and launch**

Preview every test group on your storefront to confirm each renders correctly, then click **Launch test**. See [Preview on your storefront](#preview-on-your-storefront).

## Post-purchase offers

A post-purchase offer shows one product after the buyer pays, and they add it to the same order without entering payment details again. Use it to answer "does this offer make more money than showing nothing, and at what discount?"

For example, a buyer pays for the blue snowboard, then sees a wax kit:

* **Control:** no offer
* **Variant A:** wax kit at 15% off
* **Variant B:** wax kit at 25% off

Ask your AI assistant through [MCP](https://docs.abconvert.io/mcp/overview.md), or add the offer on the Post-purchase page of the composer.

> "Create a checkout test on my store with no offer for Control, and the wax kit at 15% off after payment for Variant A, split 50/50."

To offer it only on some orders, add cart conditions to the offer, the same ones checkout blocks use: the products, collections, quantities, item count, or subtotal of the order the buyer just paid for, or whether it includes a subscription. A buyer whose order matches none of them gets no offer, and is still counted in their test group.

Two things read differently from checkout, because the offer only sees the paid order:

* **Subtotal is what the buyer paid for the items, after line discounts.** At checkout, a block's subtotal is measured before discounts.
* **Every line of the order counts,** including a free gift or paid add-on that a checkout block added. At checkout, blocks leave those lines out.

Post-purchase offers work on every Shopify plan. Selecting ABConvert as your post-purchase app in Shopify's checkout settings replaces any other app using that page, because Shopify allows one.

A few limits come from Shopify:

* **Not every order can show an offer.** Shopify shows the page for credit card orders on the Online Store channel. Wallets such as Apple Pay and Google Pay, installment plans, and gift cards skip it.
* **Orders wait for the buyer.** Shopify holds fulfillment for up to one hour, or until the buyer finishes the page.
* **Shopify owns the buttons and totals.** You set the product variant, the percentage off or quantity tiers, the heading, and the description. Shopify calculates the taxes, shipping, and total the buyer pays.

Only one app can use Shopify's post-purchase page. If another app takes it while your test runs, buyers stop seeing the offer and the test page warns you until you select ABConvert again.

If a test changes only this page, ABConvert counts a buyer when they reach the payment step, in every test group, so the report compares revenue per buyer who got that far. If it also changes checkout, ABConvert counts visitors from checkout entry, because checkout changes can affect who buys. Revenue includes accepted offers in both cases, and each test group's buyers stay in the same test group on both pages.

Decide on [profit per visitor](https://docs.abconvert.io/analytics/metrics-revenue-profit.md). A bigger discount can raise revenue and still lower profit, and only profit shows that, so set the offered product's cost in [COGS settings](https://docs.abconvert.io/configuration/settings.md#cogs-settings) first. Average order value is where an offer shows up. Conversion rate barely moves, because every buyer counted has already paid.

### Quantity break

A quantity break offers the same product variant at 2 or 3 quantities, each with its own percentage off, and the buyer picks one. Use it to answer "does asking for more units after payment make more money than one discounted unit?"

* **Control:** no offer
* **Variant A:** 1 wax kit at 15% off
* **Variant B:** 1 wax kit at 10% off, 2 at 15% off, or 3 at 20% off, with 2 selected when the page opens

> "Create a checkout test on my store with no offer for Control, 1 wax kit at 15% off after payment for Variant A, and a quantity break for Variant B: 1 at 10% off, 2 at 15% off, 3 at 20% off, with 2 preselected. Split it evenly."

Quantities go from 1 to 10 and go up from tier to tier. The discount stays the same or goes up, so you can test the quantity alone at one discount. If the buyer picks more than you have in stock, Shopify charges nothing, and the page offers the smaller quantities instead.

## Thank you page

The Thank you page is the page a buyer sees right after placing the order. Add blocks there to test what a buyer reads once they have paid, such as care tips, a link to your guides, or a reason to come back.

For example, after a buyer orders the blue snowboard:

* **Control:** Shopify's default Thank you page
* **Variant A:** a banner that says "Wax your board before the first ride", with a button to your waxing guide

Ask your AI assistant through [MCP](https://docs.abconvert.io/mcp/overview.md), or add the blocks yourself on the Thank you page of the test.

> "In my checkout test, add a banner to the Thank you page for Variant A that says 'Wax your board before the first ride', with a button to my waxing guide."

The Thank you page can only show things, so it takes six blocks: Heading, Banner, Button, Benefit list, Image, and [Next-order discount](#next-order-discount). Blocks that change the cart or the order, such as an upsell or a paid add-on, stay on the Checkout page. A next-order discount goes only on the Thank you page or the [Order status page](#order-status-page).

The buyer has already paid when they see this page, so a Thank you block can't change the order it follows. Results still compare [revenue per visitor](https://docs.abconvert.io/analytics/metrics-revenue-profit.md), and a Thank you block moves it only through orders the same visitor places again while the test runs. Plan to run a Thank you test longer than a test that changes checkout.

A Thank you block goes in one of six placements, the places Shopify's checkout editor lets an app block sit on that page:

| Section | Placement |
| - | - |
| Main | Below confirmation, Below order status, Below order details |
| Order summary | Above cart, Below cart, Below total |

To place a Thank you block, open the checkout editor, choose **Thank you** in the page menu at the top of the editor, and add an **ABConvert Checkout Block** at the block's placement. Paste its Block ID, which starts with `thank-you`, as in [Add your blocks](#add-your-blocks-in-the-checkout-editor).

### Next-order discount

A next-order discount gives the buyer a code for their next order on the Thank you or Order status page: the code to copy, and up to 3 products to come back for. A product opens on your store with the code already applied. Use it to answer "does a reason to come back bring more repeat orders, and at what discount?"

For example, after a buyer orders the blue snowboard:

* **Control:** Shopify's default Thank you page
* **Variant A:** `THANKS10` for 10% off the next order, with the wax kit and the board bag
* **Variant B:** `THANKS20` for 20% off the next order, with the same products

> "In my checkout test, add a next-order discount to the Thank you page: 10% off with code THANKS10 for Variant A and 20% off with code THANKS20 for Variant B, once per customer, showing the wax kit and the board bag."

ABConvert creates the Shopify discount for each [test group](https://docs.abconvert.io/experiments/overview.md#2-test-groups-and-traffic-allocation) when you [preview](https://docs.abconvert.io/experiments/lifecycle.md#preview-before-you-launch) or launch the test, and you find it under **Discounts** in your Shopify admin, named after the test ID and the test group. The code works only while the test is in Preview or running: [pausing](https://docs.abconvert.io/experiments/lifecycle.md#pause-a-live-test) or ending the test turns it off, and resuming turns it back on. ABConvert never deletes it. It has no end date, and it combines with shipping discounts only.

While the test is in Preview, you can still change the discount's amount, minimum order and one use per customer, and ABConvert updates the code in Shopify when you save. Once you launch, buyers may already hold the code, so its terms stay as they are: to offer different terms, use a new code.

Each test group with a next-order discount needs its own code, one that no other discount in your store uses. If another discount already uses the code, the test doesn't launch until you pick another one.

You can also show a code you already have in Shopify. It must be active when you launch. ABConvert shows it but never changes it, so it keeps working by its own terms after the test ends.

Results come only from orders the same visitor places again while the test runs, so a next-order discount test needs to run longer than a test that changes checkout. Give buyers time to come back before you [read the results](https://docs.abconvert.io/analytics/interpret-results.md).

To see how many buyers opened a product from the block, look at visits in Shopify's sessions report by their UTM tags:

| Tag | Value |
| - | - |
| `utm_source` | `abconvert` |
| `utm_campaign` | The test ID |
| `utm_content` | The test group name |

## Order status page

The Order status page is the page a buyer opens after the order, from the confirmation email, a text, the Shop app or their account, to check on it. Add blocks there to test what a returning buyer reads while they wait for delivery, such as a setup guide or a reason to order again.

For example, for buyers of the blue snowboard:

* **Control:** Shopify's default Order status page
* **Variant A:** a banner that says "Your board ships this week. Here's how to wax it", with a button to your waxing guide

Ask your AI assistant through [MCP](https://docs.abconvert.io/mcp/overview.md), or add the blocks yourself on the Order status page of the test.

> "In my checkout test, add a banner to the Order status page for Variant A that says 'Your board ships this week. Here's how to wax it', with a button to my waxing guide."

It takes the same six blocks as the [Thank you page](#thank-you-page), with the same settings, and they show on every visit. Results read the same way: the block moves [revenue per visitor](https://docs.abconvert.io/analytics/metrics-revenue-profit.md) only through orders the same visitor places again while the test runs.

Shopify shows app blocks on the Order status page only for stores on new customer accounts. On legacy customer accounts the test still runs, but buyers don't see its Order status blocks.

An Order status block goes in one of seven placements, the places Shopify's checkout editor lets an app block sit on that page, all in its Main section:

| Placement | Where it shows |
| - | - |
| Above page header | Above the order number and Buy again |
| Above order status | Above the delivery updates |
| Above items, Below items, Below total | In the order summary |
| Above order details, Below order details | Around the contact, shipping and payment details |

To place an Order status block, open the checkout editor, choose **Order status** in the page menu at the top of the editor, and add an **ABConvert Checkout Block** at the block's placement. Paste its Block ID, which starts with `order-status`, as in [Add your blocks](#add-your-blocks-in-the-checkout-editor).

## Add your blocks in the checkout editor

> [!NOTE]
>
> Add the listed blocks exactly where ABConvert shows them, or your test won't render.

<video autoPlay muted loop playsInline controls src="https://mintcdn.com/abconvert/wlyz9DNrAG0gOR0e/images/checkout-test-editor-block-id.mp4?fit=max&auto=format&n=wlyz9DNrAG0gOR0e&q=85&s=a3cca9356583703c39b1e7697831ed3c" />

Adding ABConvert blocks and pasting Block IDs in the checkout editor.

Content, Cart, and Upsell changes render through ABConvert blocks you place in Shopify's checkout editor. (Delivery and Payment changes apply automatically, with no block to add.) After you save, the **Add your blocks** card lists two kinds of block:

* **ABConvert Checkout Block** renders your Content and Upsell changes. Add one at each placement the card lists.
* **ABConvert Cart Control** renders your Cart changes. Add one in **Order summary**.

> [tab] ABConvert Checkout Block
>
> ![Add your blocks card with the ABConvert Checkout Block highlighted, its Block ID and Copy ID button, and the editor guide spotlighting where the block renders](https://mintcdn.com/abconvert/wlyz9DNrAG0gOR0e/images/checkout-test-add-blocks-checkout-block.png?fit=max\&auto=format\&n=wlyz9DNrAG0gOR0e\&q=85\&s=1d539db8ed4a7d7e96ce323e65a7fff0)
>
> Placement guide for the ABConvert Checkout Block.

> [tab] ABConvert Cart Control
>
> ![Add your blocks card with the ABConvert Cart Control highlighted, its Mark as added toggle, and the editor guide spotlighting the cart lines in Order summary](https://mintcdn.com/abconvert/wlyz9DNrAG0gOR0e/images/checkout-test-add-blocks-cart-control.png?fit=max\&auto=format\&n=wlyz9DNrAG0gOR0e\&q=85\&s=b6b2c2b95c0ebd5c0cb5391a4534c774)
>
> Placement guide for the ABConvert Cart Control.

**What a Block ID is.** Each Checkout Block placement has a short code like `before-contact-bpa`. It links a block you add in Shopify's checkout editor back to the changes you configured for that spot in ABConvert. You paste the Block ID into the block's settings so ABConvert knows what to render there. Each Block ID belongs to exactly one placement.

**1. Open the Shopify checkout editor**

Click **Open checkout editor** on the card. It opens the editor in a new tab, jumped to the **Apps** tab, so ABConvert stays open beside it.

**2. Place a Checkout Block and paste its Block ID**

Click **Add app block**, open **ABConvert Checkout Test**, and add an **ABConvert Checkout Block** at each placement the card lists. Then paste that placement's **Block ID** into the block's **Block ID** field in the checkout editor's settings panel.

**3. Keep each block in Shop Pay**

In each block's checkout behavior settings, keep **Include block in Shop Pay** on. Shoppers who pay with Shop Pay do not see a block with this setting off.

**4. Add the Cart Control block (if you test Cart modifications)**

Add **ABConvert Cart Control** in the **Order summary** section. It has no Block ID and renders its controls on each cart line automatically.

**5. Save, then check each placement off in ABConvert**

Click **Save** in the checkout editor (blocks aren't applied until you save), then return to ABConvert and check off each placement on the card.

### Check each test group renders in the editor

While you're in the checkout editor, each ABConvert block shows a **Preview** header with its Block ID and a **Variant** dropdown. Switch the dropdown to render each test group's content and confirm your blocks land in the right spot. If a test group has no change for a block, it shows a **Block hidden** banner.

![ABConvert Checkout Block Preview header with a Variant dropdown showing Control and Variant A](https://mintcdn.com/abconvert/AyyrFayJ3WDTY1DM/images/checkout-test-variant-switcher.png?fit=max\&auto=format\&n=AyyrFayJ3WDTY1DM\&q=85\&s=98859b2d7d8abf6daff4a895584bc60b)

The Variant dropdown in a block Preview header.

> [!TIP]
>
> If you change changes in ABConvert while the checkout editor is open, refresh the editor to load the latest version.

## Preview on your storefront

Before launching, walk the full shopper path to checkout on your real storefront, as any test group you choose. This is the standard pre-launch preview for every ABConvert test type. See [Preview before you launch](https://docs.abconvert.io/experiments/lifecycle.md#preview-before-you-launch).

1. In the **Preview Test** card on the review step, click **Open**.
2. An **ABConvert Preview** widget appears. Choose the test group you want to walk through as.
3. Browse to your cart and checkout. The blocks render the same way a real shopper would see them.

![Storefront homepage with the ABConvert Preview widget showing the checkout test groups Control and Variant A at a 50/50 split](https://mintcdn.com/abconvert/AyyrFayJ3WDTY1DM/images/checkout-test-live-preview.gif?s=fe21efe50e61942197149e5e4be480cf)

The storefront preview flow.

> [!NOTE]
>
> Preview is only visible to you. Real shoppers never see the test while it's in Preview.

## Reading your results

Open the [Analytics dashboard](https://docs.abconvert.io/analytics/overview.md) to compare Control against each variant. ABConvert tracks the checkout funnel step by step, so you can see where each variant drops off. You can also add [custom funnel steps](https://docs.abconvert.io/analytics/overview.md#custom-funnel-steps) to measure stages specific to your checkout.

![Session-based conversion funnel comparing Control and Variant A across sessions, added to cart, reached checkout, submitted payment, and completed checkout](https://mintcdn.com/abconvert/AyyrFayJ3WDTY1DM/images/checkout-test-results.png?fit=max\&auto=format\&n=AyyrFayJ3WDTY1DM\&q=85\&s=4f4e626a9dcbd3a0da9081af5e80cd09)

The session-based conversion funnel.

| Metric | What it tells you |
| - | - |
| **Conversion rate** | Share of visitors who complete the order. The primary signal for most checkout tests. |
| **Order count** | Completed orders credited to each variant. |
| **Revenue** | Total revenue from each variant's completed orders. |
| **Average order value** | Revenue divided by order count, useful for upsell or shipping tests. |

For full definitions and how significance is calculated, see [Metrics](https://docs.abconvert.io/analytics/metrics.md).

A visitor [experiences the test](https://docs.abconvert.io/analytics/overview.md) in every test group alike when they start checkout, when a placement for the test's block shows in Shop Pay, or when they press an express checkout button such as Shop Pay or Apple Pay on a test that changes shipping options. Pressing the button counts even if they close it without paying.

> [!TIP]
>
> Checkout tests often reach significance faster than storefront tests, because only high-intent visitors who reach checkout are counted.

## Common mistakes

> [!WARNING]
>
> Launching without adding the blocks in the checkout editor. Your variants render nothing. Complete [Add your blocks](#add-your-blocks-in-the-checkout-editor) first.

* **Turning off Include block in Shop Pay.** Shoppers who pay with Shop Pay do not see the block, so your results describe only the shoppers who use the regular checkout page. Keep it on for each block in the checkout editor.
* **Pasting a Block ID into the wrong placement.** Block IDs are placement-specific, so a mismatched ID renders the wrong content or nothing. A Block ID that starts with `thank-you` belongs on the [Thank you page](#thank-you-page), and one that starts with `order-status` on the [Order status page](#order-status-page), not the Checkout page.
* **Reusing a code you already have for a new next-order discount.** ABConvert creates a new discount for each test group, so a code that another discount in your store uses stops the launch. Pick a new code, or set the block to show your existing code. See [Next-order discount](#next-order-discount).
* **Ending a next-order discount test the week the codes go out.** Buyers need time to come back and order. Plan for a test that runs well past your usual repeat-order time.
* **Forgetting the ABConvert Cart Control block.** Cart changes only appear if the block is added in **Order summary**.
* **Not previewing every test group.** Checking only one test group hides a broken placement in another. Preview them all before launching.

## Checkout test FAQs

> [accordion] Why isn't my test showing at checkout?
>
> Almost always because the blocks weren't added in the checkout editor, or a Block ID was pasted into the wrong placement. Follow [Add your blocks](#add-your-blocks-in-the-checkout-editor): add a Checkout Block at each placement, paste the matching Block ID, and add the Cart Control block in **Order summary** if you use Cart changes.

> [accordion] A block shows 'Block hidden in this variant'. Is that a problem?
>
> No. It means the selected variant has no change for that block, so customers in it won't see the block. Switch the dropdown to another variant to confirm it renders there.

> [accordion] Will my preview sessions affect my results?
>
> No. Preview sessions bypass traffic allocation and audience targeting and are excluded from analytics.

> [accordion] Do visitors keep the same variant when they come back?
>
> Yes. Once assigned, a visitor sees the same checkout for the duration of the test.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.