# Test Shopify add to cart and checkout after an app or theme update

> An app install or theme update can silently break the cart. A plain-language test adds a variant, reaches checkout and pays with Shopify's test gateway, on a schedule.

By Jason Nguyen, Founder, Testsy. Published 2026-11-21. https://testsy.dev/blog/test-shopify-add-to-cart-and-checkout-after-an-app-update/

## The store looks up and sells nothing

Shopify merchants keep reporting the same pattern: the Add to Cart button stops responding after an app was [installed and then uninstalled](https://community.shopify.com/t/why-isnt-my-add-to-cart-button-functioning-properly/175491), or after a theme update, and the store looks fine. One merchant asked the community how others found out when an app update [silently broke their store](https://community.shopify.com/t/has-an-app-update-ever-silently-broken-part-of-your-store/672225); the answers were a sales dip, a customer complaint, or luck. A reply in the same thread describes the check that catches it: a real-shopper smoke test after every app or theme change.

## The test

Run it on a development store or a staging copy with Shopify's test gateway active. Per Shopify's help, while the [test payment gateway](https://help.shopify.com/en/manual/checkout-settings/test-orders/payments-test-mode) is active every order is a test order; card number `1` succeeds, `2` is declined and `3` fails at the gateway, and the amount must be more than the equivalent of US$1.

```text
Open https://client-store.example.
Open the product "Linen shirt", choose the size M and the colour Navy,
and add it to the cart.
Open the cart and check it shows "Linen shirt", size M, Navy, quantity 1.
Change the quantity to 2 and check the subtotal doubles.
Go to checkout. Enter the email this run's address, a made-up name and
address, and pay with the card number 1.
Check the order confirmation page shows an order number, and the
order confirmation email arrives at this run's address.
```

Selecting a non-default variant matters: many cart bugs only appear when the variant changes.

## On a live store

Do not complete a payment on a live store with the test above; it places a real order. On production, stop at the checkout page:

```text
Add "Linen shirt" in size M to the cart and go to checkout.
Check the checkout page shows the product, the subtotal and at least
one payment method, and no error message.
```

## When to run it

- Right after installing, removing or updating an app or theme.
- Nightly on a [schedule](https://testsy.dev/docs/schedules/), because apps update themselves.

A failure comes with the step where it broke, what was expected and what was seen, and the replay, so you can show the client (or the app developer) exactly what happened.

![A passed run: every check with the value it was decided on, the replay and the video.](https://testsy.dev/docs/img/run-passed-light.webp)

## If the run is blocked

Some stores use bot protection that challenges cloud browsers. A run the site stops is **Blocked** and not counted. Allow our [static addresses](https://testsy.dev/docs/network/) if you control the protection; on a hosted platform, test the staging store instead.

This post is part of [Find the bug before your client does](https://testsy.dev/blog/find-the-bug-before-your-client-does/).
