Skip to main content
Testing is a critical part of creating promotions. Atom Commerce provides three ways to verify that your offers work exactly as expected before they go live for all customers.

Admin Simulator

Test discounts manually in the built-in cart builder.

AI Agent

Let the AI Assistant build carts and verify results for you.

Storefront

Preview offers on your actual live website in isolation.

​
Admin Simulator (Local Testing)

The Admin Simulator allows you to build a test cart and see evaluation results instantly without affecting your live store.

​
Using the Simulator

  1. Navigate to Test Offers in the sidebar.
  2. Select Offers: Choose the active or scheduled offers you want to test from the selection panel.
  3. Build your Cart: Use the Cart Builder to add products from your catalog.
  4. Apply Coupons: If your offer requires a coupon code, enter it in the coupon field.
  5. View Results: The results panel shows:
    • Total Savings: The total discount amount applied.
    • Applied Discounts: A breakdown of which offers applied and how many times.
    • Line Item Details: Detailed pricing for each item in the cart.

​
Test Modes

You can choose between two test modes to control how your selected offers interact with other discounts:
  • Test Together with Active Offers (ALL): This mode includes all currently active offers in your store. Use this to see how your new offer stacks or conflicts with existing promotions.
  • Test in Isolation (ISOLATION): This mode only evaluates the offers you have explicitly selected. Use this to verify a new offer’s behavior without noise from other active discounts.
Free gifts (Gift with Purchase) are automatically added to your simulator cart if the qualifying conditions are met.

​
AI-Powered Testing

The Test with Agent feature leverages the Atom AI Assistant to automate and verify your testing workflows.

​
How to use AI Testing

Click the Test with Agent button in the Test Offers scene to open the assistant with testing-specific instructions. The AI Agent can:
  • Find Qualifying Products: Ask “What products qualify for my 20% discount?” and the agent will list them.
  • Build Complex Carts: Say “Add 3 shirts and 2 hats to my test cart.”
  • Run and Explain Tests: The agent will run the evaluation and explain why specific discounts applied (or why they didn’t).
  • Verify Accuracy: The agent automatically checks if the discount amount in the results matches your offer definition.
If you have a tiered discount (e.g., “Spend 100,save100, save 10; Spend 200,save200, save 25”), the AI Agent is particularly helpful for verifying that the correct tier is triggered at each price point.

​
Storefront Testing

For the most realistic verification, you can preview your offers directly on your Shopify storefront.

​
Enabling Test Mode

If an offer is Scheduled but not yet live, you must enable Test Mode to see it on the storefront:
  1. In the Test Offers page, select the scheduled offer.
  2. If the offer doesn’t have a test code, the AI Assistant or the UI will prompt you to Enable Test Mode.
  3. Enabling Test Mode generates a private test code that allows you to trigger the offer via a special link.

​
Previewing on Storefront

  1. Switch to the Test on Storefront tab.
  2. Click Open Storefront Test View.
  3. Your store will open in a new tab with a special ?atom_test_offer=... parameter.
  4. Browse your store and add items to your cart as a customer would. The selected offer will be active only for your session.
Storefront testing is for preview purposes only. While you can see the discounts, avoid completing actual transactions unless you are using a Shopify test payment gateway.

​
Troubleshooting Conflicts

If an offer isn’t applying as expected in the simulator, it might be due to a priority conflict.

​
Priority and Stacking

Atom Commerce evaluates discounts based on their Rank (Priority). If two offers cannot stack (e.g., two different 10% off coupons where stacking is disabled), only the higher priority offer will apply.
  • Higher Rank = Higher Priority: An offer with Rank 10 will apply before an offer with Rank 0.
  • Qualifier Conflicts: If a product is used as a “qualifier” for one offer, it may be unavailable for others depending on your Discount Limits settings.

​
AI Troubleshooting

You can ask the AI Agent: “Why isn’t my BOGO offer applying?” The agent will analyze the cart, check for priority conflicts, and can even help you Change Offer Priority directly through a confirmation dialog. For more details on how priority works, see the Priority and Stacking guide.