# Post Purchase Upsell QA Checklist

## What to Check First:

Once your post purchase upsell is setup, you'll need to QA your site to make sure everything is working as it should. Before heading to your site, confirm a few things first:

* [ ] Is the Intelligems JavaScript installed in your live theme? Check out [this article](https://docs.intelligems.io/getting-started/adding-intelligems-script-to-your-theme) for more information on where to find this.
* [ ] Have you [enabled Intelligems as your Post Purchase page](https://docs.intelligems.io/how-to-set-up-a-post-purchase-upsell-personalization-or-test#step-5-enable-intelligems-in-shopify) in Shopify?

## Previewing your Test or Personalization:

Once you have confirmed both of those items are true, you can preview the test or personalization on your live site. Enter Preview mode by clicking on the eyeball icon next to your test.

<figure><img src="https://2052204893-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2SvefuMLsJyJPAcVXeWc%2Fuploads%2FORYI0uudDKq5gJYsQ3sc%2FScreenshot%202026-03-04%20at%209.43.24%E2%80%AFAM.png?alt=media&#x26;token=24eb985e-909b-4351-8ed9-25aad7a5549c" alt=""><figcaption></figcaption></figure>

This will open your site up in a new window with the Intelligems preview widget enabled. In the preview widget, you'll see:

1. The name of the test you're previewing (top left)
2. A dropdown to switch between test groups (bottom left)
3. A toggle to highlight any replacements (top right)
4. An edit button (bottom right) — this enables integration mode, where you can edit on-site content

<figure><img src="https://2052204893-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2SvefuMLsJyJPAcVXeWc%2Fuploads%2Fgit-blob-1defc4f1a22458167719b236da5b7fb1f608f1a3%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

### Step 1: **Set Up a Way to Place Test Orders**

Before you can QA your post purchase upsell, you'll need a way to complete checkout without placing a real order. How you do this depends on your store type.

**If you're on a Shopify test/development store:** You can use Shopify's Bogus Gateway or Shopify Payments' Test Mode to simulate orders without real transactions. Learn how to set those up [here](https://help.shopify.com/en/manual/checkout-settings/test-orders/payments-test-mode#activate-bogus-gateway).

**If you're on a live production store:** Use your existing internal test order practices. This typically involves placing and then immediately cancelling and refunding the order.

Whichever method you use, the goal is the same: complete the checkout flow so the post purchase page triggers.

### Step 2: Confirm that Post Purchase Upsells are Displaying Correctly

Now it's time to verify your upsells are appearing correctly after checkout. Choose one of the test groups from the preview widget dropdown, and add a product (or products) to your cart that qualifies for your post purchase upsell.

Proceed through checkout and place a test order using one of the methods in step 1, or another preferred method if you have one.

Once the order is placed, your post purchase upsell should appear. Verify the following:

**Styling & content looks correct:**

* [ ] Text is readable and properly formatted
* [ ] Images display correctly and are the right size
* [ ] Colors match your configuration
* [ ] Spacing looks correct (not too cramped or too spread out)
* [ ] The expected products are displayed
* [ ] Discounts and pricing are displayed correctly

**Functionality is working:**

* [ ] Accepting an upsell adds it to your order
* [ ] Declining an upsell takes you to the thank you page
* [ ] Pricing looks correct

Be sure to test multiple scenarios to ensure the upsells are always displaying correctly. This list is not exhaustive, and these may not all be applicable to your site, but a few scenarios we recommend testing include:

* Different products in the order
* If you have a control group with no upsell, verify nothing appears
* Verify targeting is working (if applicable)
* Test on multiple devices (desktop and mobile) and browsers (such as desktop Chrome and mobile Safari) to confirm there are no discrepancies

Complete these steps in each test group. If you notice any issues, or have any questions, please feel free to [reach out to support!](https://portal.usepylon.com/intelligems/forms/intelligems-support-request)

### What happens next?

Now that you've completed the QA checklist for your Post Purchase Upsell Test, you can start the test!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.intelligems.io/post-purchase-upsells/post-purchase-upsell-qa-checklist.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.