Skip to content

Setup and compatibility

Set up the offer, then test the full cart and checkout journey.

Effective date: October 29, 2026

1. Install and enable the embed

Install UpsellTrix and open it from Shopify admin. Review the permissions Shopify asks you to approve. In UpsellTrix, open Theme setup, then open App embeds. Turn on UpsellTrix and select Save in the theme editor.

The embed runs gift synchronization. A progress bar or product block is a display surface; hiding that display does not replace disabling the embed. Enable the embed on the theme you intend to use, including a draft theme when testing there.

2. Choose where progress appears

For product-page progress, add the UpsellTrix product block to the product template and save the theme. Select the matching placement in your campaign. The editor may show a setup placeholder before an eligible campaign is active.

Dawn and Savor are the supported themes. Other themes and third-party cart replacements may not work. Check both the cart page and drawer if your store uses both.

3. Configure a campaign

Choose Spend X → Free Gift for a single gift, or Tiered Free Gifts for multiple spend levels. Choose each threshold and gift variant, then save. Gift variants must meet the app’s product-status, Online Store publication, and stock checks. A product appearing in Browse does not by itself mean every variant is eligible.

One campaign can be active at a time. Activating another pauses the previous campaign. Review all tiers before activation; draft and paused campaigns do not run alongside the active one.

4. Test before launching

  1. Start with an empty cart. Add a paid product and remain below the threshold; no unearned gift should appear.
  2. Reach the threshold. Check that the intended gift appears and its discount makes it free.
  3. Reduce the cart below the threshold. Check that the app-added gift is removed and displayed totals refresh.
  4. For tiered rewards, cross each configured threshold in both directions.
  5. Check that a separately purchased copy of the gift product is not removed or made free.
  6. Verify the cart page, drawer, and regular checkout show the expected items and prices. Repeat on mobile.

Checkout limitations

Buy it now, Shop Pay express, and other product-page express buttons bypass the cart, so automatic gifts are not added on those paths. Use the regular cart path to test gifts. Inventory changes and other discount or cart apps can affect the result; investigate on a test theme or store rather than changing live promotions blindly.

Pause, disable, or uninstall

Pause the campaign to stop the active offer. To stop storefront integration, turn off the UpsellTrix theme embed and save. Remove any product blocks you no longer want. To uninstall, use Shopify admin’s Apps and sales channels settings. Verify the resulting cart and discounts after changing your setup.

Uninstalling is different from deleting every retained record. See the Privacy Policy for deletion handling, or contact support.