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

# Troubleshooting Common ABConvert Issues

> Step-by-step guides for the most common problems when running and analyzing your experiments

## Analytics showing 0 views or conversions

Your experiment is running but the analytics dashboard shows no data, or data stopped recording partway through.

<Steps>
  <Step title="Check experiment health">
    Go to your analytics page and select the **Test Settings** tab. In the **Test Details** section, look for a green healthy label indicating the test is running properly.

    <Frame>
      <img src="https://mintcdn.com/abconvert/h_ETvILcFTNbqYH5/images/Screenshot-2026-04-28-at-17.09.06.png?fit=max&auto=format&n=h_ETvILcFTNbqYH5&q=85&s=6a5885f88dccca179cbaec03eabd3728" alt="Screenshot 2026 04 28 At 17 09 06" title="Screenshot 2026 04 28 At 17 09 06" style={{ width:"96%" }} width="1042" height="546" data-path="images/Screenshot-2026-04-28-at-17.09.06.png" />
    </Frame>
  </Step>

  <Step title="Wait for data propagation">
    Analytics data processes with a delay. Our system caches data to maintain fast dashboard performance, so new events can take up to 10–15 minutes to appear. If you just launched your experiment, wait at least 1–2 hours for meaningful traffic before checking results.
  </Step>

  <Step title="Verify traffic and audience targeting">
    Analytics only populate when real visitors interact with your experiment. Confirm that:

    * Your store is receiving traffic to the experiment page
    * Your audience targeting rules are configured correctly
  </Step>

  <Step title="Test in incognito mode">
    Open your store in an incognito or private window to bypass Shopify's cache. Trigger a page view or add an item to your cart, then click **Refresh** on your dashboard to see updated data.
  </Step>
</Steps>

***

## Test variant not showing on live store

The active test variant is failing to display for visitors on the live storefront.

<Steps>
  <Step title="Check experiment health">
    Go to your analytics page and select the **Test Settings** tab. In the **Test Details** section, look for a green healthy label indicating the test is running properly.

    <Frame>
      <img src="https://mintcdn.com/abconvert/h_ETvILcFTNbqYH5/images/Screenshot-2026-04-28-at-17.09.06.png?fit=max&auto=format&n=h_ETvILcFTNbqYH5&q=85&s=6a5885f88dccca179cbaec03eabd3728" alt="Screenshot 2026 04 28 At 17 09 06" title="Screenshot 2026 04 28 At 17 09 06" style={{ width:"83%" }} width="1042" height="546" data-path="images/Screenshot-2026-04-28-at-17.09.06.png" />
    </Frame>
  </Step>

  <Step title="Use preview links to verify the variant">
    With a 50/50 traffic split, you may randomly see the original page. Instead of guessing, use the preview links in your ABConvert dashboard's **Test Settings** tab. These links bypass the traffic split and force the variant to load, letting you confirm it's working.
  </Step>

  <Step title="Test in a fresh incognito window">
    Once you visit your store, our system assigns you to a variant and keeps showing you that version. To properly QA your test, always use a fresh incognito window so previous assignments don't interfere.
  </Step>
</Steps>

<Tip>
  Use **Preview Mode** before going live

  We recommend testing your variant in preview mode before launching the test live. This ensures everything works as expected without affecting real traffic.

  <Frame>
    <img src="https://mintcdn.com/abconvert/h_ETvILcFTNbqYH5/images/image-1.png?fit=max&auto=format&n=h_ETvILcFTNbqYH5&q=85&s=95cc984b441b72d2b09386ab0899dd06" alt="Image 1" width="1500" height="220" data-path="images/image-1.png" />
  </Frame>
</Tip>

***

## Price not updating correctly in the store

Visitors are seeing the original price instead of the test price, or prices are displaying incorrectly across different pages or after adding items to the cart.

<Steps>
  <Step title="Check experiment health">
    Go to your analytics page and select the **Test Settings** tab. In the **Test Details** section, look for a green healthy label indicating the test is running properly.

    <Frame>
      <img src="https://mintcdn.com/abconvert/h_ETvILcFTNbqYH5/images/Screenshot-2026-04-28-at-17.09.06.png?fit=max&auto=format&n=h_ETvILcFTNbqYH5&q=85&s=6a5885f88dccca179cbaec03eabd3728" alt="Screenshot 2026 04 28 At 17 09 06" title="Screenshot 2026 04 28 At 17 09 06" style={{ width:"84%" }} width="1042" height="546" data-path="images/Screenshot-2026-04-28-at-17.09.06.png" />
    </Frame>
  </Step>

  <Step title="Confirm the product is included in the experiment">
    Open the experiment and verify that the product you're testing is listed under the experiment's products. If it isn't, the script won't update prices on that product's page.
  </Step>

  <Step title="Check your theme compatibility">
    When you first start a price test, our team reviews your theme to ensure compatibility with our price tests. If you've recently updated your theme, this may prevent prices from updating correctly. Contact support to request a new theme review.
  </Step>
</Steps>

***

## Shipping rates are not showing correctly in checkout

Visitors are seeing the original shipping rates instead of the expected test rates, or shipping costs are displaying incorrectly during the checkout process.

<Steps>
  <Step title="Add ABConvert rates in your shipping profiles">
    To enable shipping tests, add ABConvert shipping rates to your target zones.

    1. Go to **Shipping and delivery settings** > **General profile**
    2. Select your zone, click **Add shipping option**
    3. Choose **Carrier or app calculated**, select **ABConvert**, and click **Done**.

    <Frame>
      <img src="https://mintcdn.com/abconvert/h_ETvILcFTNbqYH5/images/Screenshot-2026-04-29-at-10.43.16.png?fit=max&auto=format&n=h_ETvILcFTNbqYH5&q=85&s=58a0a8e85128128d81bdab82dd20706d" alt="Screenshot 2026 04 29 At 10 43 16" title="Screenshot 2026 04 29 At 10 43 16" style={{ width:"94%" }} width="1166" height="546" data-path="images/Screenshot-2026-04-29-at-10.43.16.png" />
    </Frame>
  </Step>

  <Step title="Enable app embed &#x22;ABConvert Shipping V2&#x22;">
    Verify the **ABConvert Shipping V2** app embed is enabled in your live theme before running shipping tests. This embed is required for the shipping script to calculate and display test rates correctly.

    <Frame>
      <img src="https://mintcdn.com/abconvert/h_ETvILcFTNbqYH5/images/Screenshot-2026-04-29-at-10.47.42.png?fit=max&auto=format&n=h_ETvILcFTNbqYH5&q=85&s=f3faf2dbf90cdc2534fe746f17e21b1d" alt="Screenshot 2026 04 29 At 10 47 42" title="Screenshot 2026 04 29 At 10 47 42" style={{ width:"78%" }} width="932" height="592" data-path="images/Screenshot-2026-04-29-at-10.47.42.png" />
    </Frame>
  </Step>

  <Step title="Test in the target zone">
    Shipping tests are zone-aware and only display test rates for visitors in your targeted shipping zone. If you're testing from a different location, use a VPN to match your target zone during QA to see accurate test rates.
  </Step>

  <Step title="Ensure discounts are applied before checkout">
    If shipping rates calculate incorrectly when **discount codes are applied at checkout**, it's because our script cannot run on Shopify's checkout page due to platform limitations. Manually entered discount codes won't be recognized by our shipping script.

    <Frame>
      <img src="https://mintcdn.com/abconvert/h_ETvILcFTNbqYH5/images/image.png?fit=max&auto=format&n=h_ETvILcFTNbqYH5&q=85&s=15ebb349c7be19acd87941f1bdd2232f" alt="Image" title="Image" style={{ width:"83%" }} width="735" height="493" data-path="images/image.png" />
    </Frame>

    To fix this, **apply discounts automatically before checkout** using Shopify's automatic discount settings. This ensures the shipping script calculates rates correctly with discounts included.
  </Step>
</Steps>

<Note>
  If you work through the steps above and still can't resolve the issue, contact support based on your plan:

  * **Starter plan** — self-serve documentation
  * **Growth plan** — email support (response within 24–48 hours)
  * **Scale plan** — priority email + live chat (response within 12–24 hours)
  * **Pro and Unlimited plans** — dedicated Slack channel and scheduled calls
</Note>
