> ## Documentation Index
> Fetch the complete documentation index at: https://docs.digifist.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Common Galantis Discount Flow issues and how to fix them — discounts not applying, free gifts not appearing, activation limits, sync errors, and reinstall behavior.

Most issues with Galantis Discount Flow come down to a small set of causes: a plan or platform limit was reached, the theme embed isn't enabled, a condition requires a logged-in customer, or a push to Shopify failed. This page lists each common symptom with its cause and fix.

<Tip>
  For anything involving free gifts or storefront behavior, turn on **Debug mode** in the [theme app embed](/galantis/discount/storefront/theme-embed) settings first — it logs the storefront evaluation to the browser console and usually reveals the cause immediately.
</Tip>

## Common issues

<AccordionGroup>
  <Accordion title="Campaign shows a sync error banner" icon="triangle-exclamation">
    **Symptom:** A campaign's detail page shows a sync error banner, and the discount isn't behaving as expected at checkout.

    **Cause:** Pushing the campaign to Shopify failed, so the Shopify discount is out of date (or missing).

    **Fix:** Click the **Resync** button on the banner to push the campaign to Shopify again. If the error persists, check the other limits on this page — a resync can fail because a platform or plan limit blocks it.
  </Accordion>

  <Accordion title="&#x22;A store can have at most 25 active automatic discounts.&#x22;" icon="circle-exclamation">
    **Symptom:** Activating a campaign fails with this message.

    **Cause:** This is a Shopify platform limit, counted across **all** apps and native Shopify discounts — not a Galantis Discount Flow limit.

    **Fix:** Deactivate automatic discounts you no longer need (in Galantis Discount Flow or on Shopify's native **Discounts** page), then activate the campaign again. Code-based campaigns don't count toward this limit, so converting a flow to use a **Discount code** condition is another way to stay under it.
  </Accordion>

  <Accordion title="&#x22;FREE plan allows a maximum of 3 active campaigns. Upgrade to activate more.&#x22;" icon="lock">
    **Symptom:** You can't activate a fourth campaign on the Free plan.

    **Cause:** The Free plan allows at most 3 active campaigns at a time.

    **Fix:** Pause one of your active campaigns, or upgrade to Pro via **Settings → Change plan** for unlimited active campaigns. See [Plans & limits](/galantis/discount/billing/plans-limits).
  </Accordion>

  <Accordion title="All discounts stopped applying and a usage-paused banner appeared" icon="pause">
    **Symptom:** Discounts that worked yesterday no longer apply at checkout, and the dashboard shows a usage-paused banner.

    **Cause:** Your store is on the Free plan and hit a monthly usage cap — 25 discounted orders or 1,000 discount applications. Hitting either cap pauses all of the store's discounts for the rest of the period.

    **Fix:** Wait for the next monthly period (anchored to your install date), when discounts reactivate automatically — or upgrade to Pro, which lifts the pause immediately. The **Activity Log** in [Settings](/galantis/discount/settings) shows exactly when the limit was reached.
  </Accordion>

  <Accordion title="Free gift isn't added to the cart" icon="gift">
    **Symptom:** The cart qualifies for a free-gift flow, but the gift product never appears.

    **Cause:** The **Galantis Discount Flow** theme app embed is disabled, or its **Auto-add free gifts** setting is turned off. Gifts are added on the storefront by the embed — checkout cannot add items.

    **Fix:** In the theme editor, open **App embeds**, enable **Galantis Discount Flow**, and confirm **Auto-add free gifts** is on. If it still doesn't appear, enable **Debug mode** and check the browser console to see how the campaign evaluated. See [Theme app embed](/galantis/discount/storefront/theme-embed).
  </Accordion>

  <Accordion title="Customer-based conditions never match" icon="user-lock">
    **Symptom:** A campaign using customer tags, segments, order count, or first-order conditions doesn't apply, even for customers who should qualify.

    **Cause:** Customer-based conditions require the customer to be **logged in**. Guest checkouts have no customer identity to evaluate against.

    **Fix:** Test while logged in to a customer account that meets the conditions. If your store relies heavily on guest checkout, consider conditions based on the cart instead of the customer.
  </Accordion>

  <Accordion title="Discount not visible in the cart, but applied at checkout" icon="cart-shopping">
    **Symptom:** Customers report the discount is "missing" on the cart page, yet it appears once they reach checkout.

    **Cause:** This is expected behavior for automatic discounts — Shopify applies them at checkout, not in the cart.

    **Fix:** Nothing to fix. If cart-page visibility matters to you, communicate the offer with your theme's promotional content instead.
  </Accordion>

  <Accordion title="Uninstalled the app — are my campaigns gone?" icon="rotate-left">
    **Symptom:** You uninstalled Galantis Discount Flow and want to know what happens to your data.

    **Cause / behavior:** If you reinstall within **48 hours**, your campaigns are restored automatically. After 48 hours, data is permanently deleted in line with Shopify's privacy rules.

    **Fix:** Reinstall within 48 hours to recover everything. After that window, campaigns must be rebuilt from scratch.
  </Accordion>
</AccordionGroup>

## Still stuck?

If none of the above matches your issue, gather what you can before reaching out: the campaign name, what you expected vs what happened, whether the store is on Free or Pro, and (for storefront issues) the **Debug mode** console output from the theme embed.

## Related guides

* [Theme app embed](/galantis/discount/storefront/theme-embed) — embed settings and Debug mode
* [How discounts apply at checkout](/galantis/discount/storefront/how-discounts-apply) — evaluation, stacking, and the automatic-vs-code distinction
* [Plans & limits](/galantis/discount/billing/plans-limits) — caps, the pause mechanic, and changing plans