xDiscount is coming soon to the Shopify App Store. See it working on the live demo store.
Docs

Account

Troubleshooting & FAQ

Why a discount is not applying, why the offer card is not showing, sync and plan-limit messages, Connect AI errors, and how to reach support from any screen.

Start Here

Nine times out of ten, a discount that “isn’t working” fails one of four checks. Run these before anything else, they take about thirty seconds.

1

Open Discounts

Open Discounts in xDiscount and find the discount in the table.

Read the Status and Sync columns

Both have to be right before anything reaches a shopper. The table below says what to look for.

Check the Included products section

Open the discount. The summary line tells you exactly what it covers: “3 products selected, 5 variants targeted.” If a product is not in there, the discount will never touch it.

Check the Discount period section

Dates follow your store’s timezone, and both the start day and the end day are included.

ColumnWhat you want to seeIf it says something else
StatusActiveDraft and Archived discounts are invisible to shoppers and never apply at checkout
SyncSyncedPending, Failed or Too large all mean your latest save has not reached your store. See Sync says Failed or Too large below

What a working discount looks like at checkout

A line labelled with the discount’s Checkout label, or with its Name when the label is empty (xDiscount if both are empty).

The label never shows the percentage or a reason. If you see it, the app is working. If you do not, keep reading.

You can also test the cart with the Discount checker below.

Check a Cart With the Discount Checker

The quickest way to find out why a discount is not applying is to ask checkout itself. The Discount checker builds the same input checkout receives and runs the same code on it, using the discount data saved on your products in Shopify.

1

Open the checker

Open Discounts and click Check a cart at the top of the page. The page is headed Discount checker.

Choose who is shopping

Under Check as, choose who is shopping. A guest is the default. A logged-in customer takes their Customer tags, separated by commas, whether they are On their first order, and their Lifetime spend in your store’s currency. A B2B buyer is a logged-in customer buying for a company, with the same fields and the Company they buy for. Each can have a Country, the one they browse your store in. Under Where the order is placed, In your online store is the default, and In store on Shopify POS checks an order at one of your locations.

Build the cart

Click Add products and pick the products a shopper would have in their cart. Open a product in the picker to choose some of its variants. Picking the whole product adds every variant. You can check up to 20 items.

Set the quantities

Set a Quantity on each item, a whole number from 1 to 999. The bin icon removes an item.

Check

Click Check.

Each item then gets its own card:

  • Discounted shows the discount checkout applies, the Checkout label shoppers see, the discount, and the line price before and after it. A percentage’s amount is worked out on each item and rounded down to the cent, the way checkout does it, so the price after is the one checkout charges.
  • Not discounted lists every discount on that product, each with the first reason it does not apply, using your cart’s real numbers. For example: Item quantity: the cart has 1 item in total, it needs at least 2. Other reasons include a discount that has not started or has ended, a variant it does not cover, a variant skipped because of its stock, volume tiers not reached, a discount kept for customers the shopper you chose under Check as is not, and another discount winning the item under your Overlapping discounts choice in Settings.
  • A Buy X get Y offer says when the item qualifies for the gift. The checker cannot add the gift itself. Shoppers add it with the offer card on the product page.
  • A discount that is a Draft or Archived, or that is saved but has not reached the product in Shopify yet, is listed too, with what to do about it.

The last card says whether the cart gets free shipping, and from which discount.

The checker works in your store’s currency, at each product’s base price, and on today’s date in your store’s time zone. For A B2B buyer with a company location chosen, it works at the prices that location pays, as Shopify gives them for the location and its country. It covers xDiscount only, so discount codes and other apps can still change the final price. It never changes anything in your store.

A Discount Isn’t Applying at Checkout

Work down this list in order. It is sorted by how often each cause turns out to be the real one.

1. The Discount Is a Draft or Archived

Only Active discounts are written into your store at all. Moving a discount to draft or archiving it takes it out of your products’ configuration, so checkout stops seeing it.

Fix: open the discount and click Activate discount in the page header, then confirm with Activate. Setting the Status dropdown in the right-hand column to Active and clicking Save does the same thing.

2. The Product in the Cart Isn’t Targeted

Open the discount and read the Included products section.

  • A product added whole covers every variant, including variants you add in Shopify later. Its line says All 4 variants, including any added later.
  • A product narrowed to particular variants says 2 of 4 variants. Only those variants are discounted.

Fix: click Browse to reopen the picker, or expand Variants (4) on the product and tick the ones you want. Ticking the last unticked variant puts the product back to whole-product targeting.

3. A Condition Wasn’t Met

Conditions live in the Conditions section of the discount, and there are exactly three.

ConditionWhat it actually measures
Item quantityThe total number of items in the whole cart, not just the discounted product
Cart valueThe cart subtotal, in your store’s currency
InventoryThe stock of one variant, resolved by the app before checkout, not read in the cart

Four things catch people out:

  • Bounds are inclusive. A Minimum items of 3 means a cart of exactly 3 qualifies.
  • There is no grouping. Rows fold from top to bottom. The first row is labelled When and has nothing to join to, every later row carries its own and or or, and there are no brackets and no precedence. An Inventory row’s join is locked to and.
  • Negate this condition flips that one row only, not the whole set.
  • An Inventory row does not judge the cart at all. It removes variants from the discount before checkout ever runs, so no other condition can rescue a skipped variant. See point 6.

There is no date condition to add

Dates live in Discount period, not in Conditions. An older discount that still carries a date row shows it as Date range (set under Discount period), and it keeps working, but nothing can be switched to that type and a new row can never be one.

4. The Discount Is Outside Its Period

A start date of today is live today, and an end date of today runs until the end of your store’s day. If the timing looks a day out, remember the comparison uses your store’s timezone, not yours and not the shopper’s.

5. Another xDiscount Discount Won That Item

Only one discount applies per item.

Your choice under Settings → Overlapping discounts decides which: Biggest discount wins (the default), The product’s own discount first, or My priority order. So under the default a 12% collection sale beats a product’s own 5% discount, and under The product’s own discount first the product’s own discount wins. The discount page says so too: under Applies to, a note names the other active discounts that reach some of the same products, a collection discount whose collection holds one of your products included, and what happens where they meet.

Normally a product belongs to one discount for each kind of buyer, so two discounts on specific products rarely meet. It can happen when an archived discount is brought back after its products went to another discount, or with a discount saved before the one-discount rule. Your Overlapping discounts choice decides between those two as well, and the lower priority number settles a tie.

Fix: archive the discount you don’t want on that product, or open it and remove the product. The other one then applies. You can also pick the Overlapping discounts choice that matches how you want your offers to meet.

A discount code and an automatic discount do not add up. When a shopper enters a code, Shopify compares it with your automatic discounts on the whole cart and applies whichever saves the shopper more, not item by item. So a code can seem to do nothing when the automatic discounts saved more, and the other way round. A cart spend code is the exception: it adds to your automatic discounts on items and to free shipping.

6. An Inventory Condition or the Out-of-Stock Skip Excluded the Variant

Both of these work the same way. xDiscount reads each targeted variant’s stock on the server, works out which variants fall outside your range, and writes that list into your products’ configuration. Checkout then skips them. Nothing is re-read in the cart.

That answer is a snapshot, and it can be up to a day old. It is refreshed:

  • immediately, whenever you open the discount and click Save
  • once a day, at 03:00 UTC, for Active discounts that use Inventory or Skip products that are out of stock

So a variant that sold out since the last check is still discounted, and a variant you restocked since the last check is still skipped. The builder says so next to the row: “Checked per product variant when this discount syncs, and once a day after that. Variants outside the range are skipped until the next check.”

Fix: open the discount and click Save. That takes a fresh stock reading straight away.

Two more things worth knowing. Stock is counted per variant, never summed across a product, so one size can be skipped while another is discounted. And variants that do not track inventory are never skipped, whatever bounds you set.

7. It Was a Subscription Order

xDiscount applies to one-time purchases only. Subscription orders are excluded deliberately.

8. The xDiscount Entry in Your Shopify Discounts List Is Gone or Switched Off

xDiscount registers one automatic discount in your Shopify admin, under Discounts, titled xDiscount. Every discount you build in the app runs through it.

Fix: open Shopify’s Discounts list and look for xDiscount. If it is there but inactive, activate it. If it is missing entirely, reinstall the app, which re-registers it.

9. Setup Never Finished

If Home shows a red banner headed Your store isn’t fully set up, part of the install did not complete and discounts genuinely cannot apply. Click Retry setup on the banner. It runs the same setup again from inside the app, and the banner clears as soon as every step succeeds. If it still fails after a retry, reinstalling the app runs it once more with fresh permissions. The banner names the steps that failed, so keep that list if you need to report it.

10. It Is a Discount Code

A Discount code applies only when a shopper enters its code at checkout. Shopify refuses a code that is past its End date, used up by its Usage limit, already used by that customer when Limit to one use per customer is ticked, or on a discount that is Draft or Archived. Codes work on Shopify POS only for staff with the Apply discount codes permission, and never on exchanges. A code is never shown on the product page, so the offer card does not show it either.

11. The Discount Is Kept for Some Customers

Open the discount and read Who can get it. Unless it says Everyone, Retail shoppers and B2B buyers and Online store and in store, only shoppers who match every rule turned on there get the discount:

  • Retail shoppers or B2B buyers: a discount for Retail shoppers only never reaches a buyer buying for a company, and one for B2B buyers only never reaches a retail shopper. New discounts start at Retail shoppers only. A B2B buyer also gets nothing where your store’s B2B discounts are turned off in Shopify.
  • Which companies and Customer for at least: an offer for chosen companies reaches only a buyer buying for one of them, and one for companies that have been customers for a number of days only companies whose Customer since date in Shopify is at least that long ago. xDiscount checks your companies when you save and every day, so a change in Shopify reaches the offer by the next day. Saving the discount checks them again at once. A save refused with “xDiscount has no access to your companies in Shopify yet. Open xDiscount again from your Shopify admin and approve the access Shopify asks for. Then save again. Or choose Every company and leave Customer for at least off.” means your store has not approved that access yet: do as it says.
  • Where it applies: a discount for Online store only never reaches an order in store on Shopify POS, and one for In store only never reaches your online store. In store, Shopify applies automatic discounts only at locations with POS Pro.
  • Logged-in customers only, Customers tagged and First order only need the shopper logged in to their customer account. A guest, or someone who only typed their email address at checkout, does not get it.
  • Customers tagged needs at least one of the tags on the customer in Shopify. Open the customer under Customers and check Tags. Capitals do not matter.
  • First order only leaves out a customer who has ordered before.
  • Lifetime spend at least needs the customer logged in and their spend in your store, over all their orders, at least the amount set. A shopper browsing in another currency does not see the offer on the product page, but checkout still gives it to them.
  • Countries needs the shopper browsing your store in one of the countries listed, the country your store’s country selector shows.
  • Skip items already marked down leaves out an item whose compare-at price is above its price, whoever the shopper is.

The discounts list says who can get each discount in one line under its name, such as “VIP customers only”. The product page, the badges and the cart progress bar show the offer only to shoppers who can get it, so a guest never sees a VIP offer.

Fix: check the cart in the Discount checker with Check as set to the shopper you have in mind, for example A logged-in customer with the tag VIP. A discount kept out by its rules says which rule. If the rules are not what you meant, change them, or choose Everyone, and click Save.

12. Shopify Limits the xDiscount Discount to Some Buyers

Shopify lets you limit any discount to some markets, chosen customers or customer segments. Done to the xDiscount discount in your Shopify Discounts list, it takes every item discount, gift and free shipping offer away from the buyers left out. Done to xDiscount order, it takes your cart spend discounts away from them. A region market leaves out B2B buyers, and a B2B market leaves out retail shoppers. The product page still shows the offers, so nothing looks wrong until checkout.

Home shows a warning banner headed Shopify limits who gets your discounts when this happens, naming the discount and who it leaves out.

Fix: open Discounts in your Shopify admin, open the discount the banner names and set its eligibility back to all customers. Then choose who gets each offer with Who can get it in xDiscount, as section 11 above describes.

Free Shipping Specifically

Free shipping is handled separately from product discounts, so it has two extra requirements. A targeted product must be in the cart, because free shipping is attached to products like every other type, so an empty-handed cart gets nothing. And the cart must have shipping, because digital-only and local-pickup carts have no delivery options, so there is nothing to discount. When it does apply, it takes 100% off shipping, for every delivery group in the cart.

The Offer Card Isn’t Showing on a Product Page

Your plan is never the reason

The storefront offer card is included on every plan, Free included, so your plan is never the reason it’s missing. If the offer card’s badge in Settings ever reads Not on your plan, the app did not recognise your subscription: click Refresh plan under Plans & billing, and if the badge stays, tell us. The card on your storefront keeps showing either way. If the card is missing, it is one of the four causes below.

1. The Block Isn’t on Your Live Theme

Go to Settings, then Storefront features, and read the badge on the Offer card on product pages row.

BadgeMeaningWhat to do
OnThe block is on your live theme’s product template and switched onNothing
OffIt is not thereClick Add to theme, the editor opens with the block already placed, then Save
Couldn’t checkThe theme read failed, which is not the same as “not installed”Click Check again

Four situations count as not added:

  • The block is on a theme that is not your live published theme. Publishing a new theme means adding it again.
  • The block is present but switched off in the theme editor.
  • Your theme has no modern product template, as older “vintage” themes cannot take app blocks at all.
  • The block was added to a custom product template. xDiscount checks the default product template only, so the badge can read Off while the card renders perfectly on the products using your custom template.

A theme read that fails inside Shopify’s own API lands on Couldn’t check, never on Off, and the card says in one line what went wrong. If you know the block is there and the badge still reads Off, click Check again before adding it a second time. If it persists, tell support which theme you use, because the check reads your live theme’s default product template, however large it is.

Uninstall does not remove the block

Uninstall, which sits with the offer card’s badge in Settings, opens your theme editor so you can delete the block yourself. No app can remove it for you, because Shopify offers no way to, and the card says so above the button.

2. That Product Has No Live Offer Right Now

The card is gated before it renders anything. No live, in-window discount on that product means no markup at all, no empty card and no heading. Check that the discount is Active, that the product is targeted, and that today falls inside the Discount period.

3. The Configuration Hasn’t Reached That Product Yet

The card reads exactly the same configuration checkout reads. If the Sync column does not say Synced, the card is still showing the last configuration that did reach your store, or nothing at all if none ever did.

4. The Card Is There but Looks Wrong

The card’s appearance is set in the theme editor, on the xDiscount offer block, under Text, Colours, Size and spacing and Display. A blank colour means “inherit your theme”, so if the card suddenly has a colour you did not want, look for a filled-in swatch under Colours and clear it. Card width set to anything but Full width caps the card’s width, and Full width caps nothing.

The card is more forgiving than checkout, on purpose

If a date on a discount is unreadable, the card treats it as absent and still shows, while checkout treats it as a failure and does not discount. That asymmetry is deliberate: a card that shows too often is visible to you and fixable, a discount that wrongly applies costs you money on every order.

Why an amount can read 10 USD off

Amounts are stored in your store’s currency. When a shopper browses in another currency, the card states the unit rather than dressing your number in the shopper’s symbol. Checkout still converts properly, and percentages are never affected.

Discount Badges or the Cart Progress Bar Don’t Show

Both are app embeds, and Shopify keeps every app embed switched off when you install an app. Go to Settings, then Storefront features, and read the badge on that row:

BadgeMeaningWhat to do
OnIt is switched on in your live themeCheck that a discount is Active and inside its dates. Badges and the bar only show a live offer
OffIt is switched off, or was never switched onClick Turn on. The theme editor opens on App embeds with it already switched on. Click Save
Couldn’t checkThe theme read failed. This is not the same as OffClick Check again, or Open theme editor to look at the switch yourself

The badge reads your live (published) theme only. If you publish a different theme, switch the embeds on there too.

I Can’t Find Help

There is a floating help button on every screen in the app, a round chat button in the bottom-right corner. It is there on Home, Discounts, the discount page, Analytics and Settings.

1

Click the chat button

A panel opens headed Help & support, with two tabs. A small close button at the top right shuts it.

Use How to use for the guides

It lists every guide, Getting started, Discount types, Managing discounts, Targeting products, Conditions and rules, The storefront offer card, Analytics, Connect AI, Plans and billing, Settings and Troubleshooting. Each one opens in a new tab.

Use Questions to write to us

Fill in Email, which is the address we reply to, then Subject and How can we help?, and click Send message.

What to expect:

  • Send message is never greyed out. If something is missing, clicking it marks every field that needs fixing at once and tells you why. It never withholds the reason.
  • On success you get Message sent and a reference. Quote it if you write to us again about the same thing. Send another message clears the form.
  • On failure you get Not sent with the reason, and everything you typed is still there. Click Send message again.
  • Closing the panel, with the close button, the Escape key, or a click outside it, does not throw away a half-typed message. Reopen it and your draft is exactly where you left it.

If the guides are not linked yet

If the How to use tab says “The guides are not linked from this app yet”, the docs site address has not been configured for your install. That is not a fault with your store. Use Ask a question, which takes you straight to the Questions tab. Settings, then Support, holds only a Back to discounts button, so the floating help button is how you reach us.

A Change Isn’t Reaching the Storefront

Your store’s configuration is rewritten every time you save or delete a discount, and once a day for discounts that depend on stock. Nothing else rewrites it, not a plan change and not a page view.

SituationWhat to do
You edited a discount and the product page still shows the old offerReload the product page, or try it in a private window, then check the Sync column
You removed a product from a discountThat product is rewritten with whatever discounts are left. If none are left, its configuration is removed entirely, which is expected
You restocked, or sold out, and the discount has not noticedStock is re-read on save and once a day. Open the discount and click Save
You changed plan and expected the offer card to appear or disappearNothing changes. The card and Connect AI are on every plan, and a plan change never rewrites your configuration. What a plan change moves is your allowance
You want to see what synced most recentlyOn Discounts, open the sort menu and choose Last synced

Re-saving a discount is the universal repair. It re-reads your plan, re-checks stock, and rewrites every product the discount targets.

Sync Says Failed or Too Large

Saving always succeeds locally, and a failed push to Shopify never throws your work away. It is recorded on the row instead.

BadgeMeaningFix
PendingNever pushed yetOpen the discount and click Save
SyncedIt is in your storeNothing
FailedShopify rejected the write or did not answerOpen the discount and click Save again
Too largeThe configuration is over Shopify’s 10,000-byte limit for discount functionsMake it smaller, see below

Home raises these for you with a red banner headed Some discounts aren’t reaching your store and a Review them button that opens Discounts already filtered. You can also filter yourself: the Filter button offers Status and Sync facets, and Sync lists Synced, Pending, Failed and Too large.

About Too large. The message gives you the exact size:

This discount configuration is 10,412 bytes, over Shopify’s 10,000-byte limit for discount functions. Shopify would store it but the discount would never apply at checkout. Reduce the number of targeted variants or rules and try again.

That limit applies to a product, counting every discount targeting it, not to one discount on its own. So target whole products instead of long lists of individual variants, use fewer conditions, use fewer gift products on a Buy X get Y, and run fewer discounts on the same product. An Inventory condition adds the list of skipped variants on top of everything else, so it costs bytes too.

xDiscount refuses the write rather than trimming it, because a stored but oversized configuration is the worst outcome of all: shoppers are shown an offer that can never apply, and nothing reports an error.

You’ve Hit a Plan Limit

What you seeWhat it meansWhat to do
Your Free plan includes 3 active discounts, and you have 3. Pause or archive one, or upgrade your plan to add more.The active-discount limit, 3 on Free, 25 on Starter, unlimited on Growth and ScaleOpen a discount and click Move to draft or Archive discount, or upgrade under Plans & billing in Settings
Banner: You’ve used all 3 discounts on FreeThe same limit, shown on HomeClick See plans
Banner: You’ve passed the free monthly limitFree includes 50 discounted orders a monthNothing is switched off at 50, your discounts keep running on every order. Click See plans if you want more headroom
Banner: Approaching your monthly limitYou are at 80% of your plan’s included discounted ordersNothing stops at 100%. On a paid plan the banner also names what each extra order costs
Banner: Usage limit reachedExtra orders have hit your spending cap, $50 on Starter, $150 on Growth, $400 on ScaleClick Raise limit. Your discounts are still running in the meantime
Banner: Your subscription is pausedShopify could not collect payment, so you are on free-plan limits. Plans & billing badges this PausedClick Update billing

Drafts are never blocked by the active-discount limit, because only what is live at checkout counts. And a discounted order only counts when xDiscount actually reduced the price, so orders it did not touch never count.

Connect AI Is Refusing

MessageCauseFix
That credential is not valid. Generate a new one in Settings.Wrong, mistyped or truncated keyGenerate a new key and paste the whole thing
That credential is not valid. It may have been revoked.You clicked Revoke, or generated a newer key that replaced itGenerate a key and update your client
A bearer token is required. Connect through OAuth, or generate a Connect AI key in Settings.The client called with no credential. For a token-based client, the key is missing from its settingsPaste the key as a bearer token, or connect the client with the connection URL and approve it in your admin
Unable to verify the server or Could not register with the connection service, in claude.ai when adding the connectorclaude.ai could not read this app’s OAuth discovery documents. The app’s OAuth secrets are not configured, or the URL is not the one from SettingsUse the exact connection URL from Settings, then Connect AI. It ends in your store’s name. If it still fails, the app operator has to set the OAuth secrets on the environment
The offer card’s badge in Settings says Off with “…added by a different installation of xDiscount”Two copies of xDiscount are installed on this store, typically a development copy and the real one, and the block on the theme belongs to the other copyClick Add to theme to place this copy’s block. Remove the other copy’s block in the editor if you no longer use it
The approval page says This connection is for a different store than the one you’re signed intoThe connection URL names one store and your browser is signed into another Shopify adminSign into the store whose URL you copied, then start the connection again from your AI client
The approval page says This request expiredApproval requests live a few minutesStart the connection again from your AI client and approve promptly
The approval page appeared without you starting anythingSomeone else is trying to connect a client to your storeClick Deny. Nothing is granted until you allow it
This discount is live. Unpublish it first…An assistant tried to edit an Active discountClick Move to draft, make the change, then Activate discount
Inventory narrows the discount, so every condition here has to join with and.An assistant sent an Inventory condition joined with or. It can only narrow, so it can only be joined with andAsk it to use and, or fix the row in the Conditions section
This discount has no products yet, so it would apply to nothing…An assistant tried to publish a discount before giving it any productsAsk it to find the products with searchProducts and add them, or pick them yourself in Discounts, then publish
A discount needs at least one product before it can be active. Add products, save, then activate it.Something tried to make a discount with no products Active: the bulk Set as active action, an assistant, or the API. The form itself never lets this throughOpen the discount, choose its products, save, then activate
Choose at least one product for this discount to apply to., from an assistantIt tried to create a discount without any productsAsk it to search for the products first, or name them in the request
A product can belong to one discount for retail shoppers and one for B2B buyers. … is already a target of ”…”An assistant tried to add a product that another live or draft discount for the same buyers already coversArchive that discount, remove the product from it, or make one discount for retail shoppers only and the other for B2B buyers only, then ask again
No product with id … in this store.The assistant used an id your store does not have, usually one it guessedAsk it to search first with searchProducts
Percentage must be between 0 and 100., and the form’s other messagesAn assistant sent a value the form would refuse. The same validator checks bothCorrect the value. The message says what is wrong

Other things worth checking. The connection URL is /mcp/your-store-name on this app’s URL, and Settings, then Connect AI, shows it with a Copy button. A client that approved access appears under Connected AI clients. If yours is missing there, the approval did not finish, so start the connection again. For a token-based client, the badge Key created, not used yet means no client has ever called with that key, so the problem is on the client’s side: check the URL and the token. A key is shown once, under the banner Copy this now, it won’t be shown again, and only a hash of it is stored, so a lost key cannot be read back to you and you need a new one.

A draft is the guardrail, not a failure

Everything an assistant creates arrives as a Draft. Open Discounts, review it, and click Activate discount.

An Offer Is Dimmed and Says “Not Available for the Selected Variant”

That is the card doing its job. The shopper has selected a variant the discount doesn’t cover: either you narrowed the discount to other variants, or that variant was skipped by Skip products that are out of stock or an Inventory condition at the last stock check. Checkout would charge full price on it, so the card says so instead of advertising the offer. Selecting a covered variant brings the tile back.

To cover the variant, open the discount, expand the product under Included products and tick it. For a stock skip, restock it. The next daily check, or opening the discount and clicking Save, picks it up.

Shoppers Can’t Add the Gift

Buy X get Y is the one type with a hard dependency. A discount cannot put an item into a cart, so the storefront offer card is what puts the gift there. Without the card on your theme, a shopper has no way to claim it.

Work down this list:

  1. Is the offer card on your live theme? See The offer card isn’t showing above. The card is included on every plan, so this is about your theme, never your plan: without the card on the page, Buy X get Y has no way to deliver a gift at all.
  2. Did you pick gift products? The form warns “No gift chosen yet. Shoppers cannot claim this offer until you pick one.” Saving it as Active with no gift is blocked outright.
  3. Is a gift missing its variant? Validation says “One of your gifts has no variant. Remove it and pick it again.” A gift without a variant is skipped on the storefront, so its button never renders.
  4. Does clicking a gift do nothing? The button disables itself, tries to add the item, then re-enables if the add failed. The usual causes are a gift product that is not published to your Online Store, or a variant that sold out since the window opened. A variant already sold out when the window opens does not get that far: it is greyed out as Sold out and cannot be clicked.
  5. Did the cart not visibly update? The card adds the gift and then asks your theme to refresh its own cart. Some themes do not listen, so reload the page or open the cart to confirm the gift is there.
  6. Was the gift added some other way? A gift added from its own product page, or restored from an old cart, is not marked as a gift and is not discounted. It has to come from the card’s gift buttons.
  7. Is the trigger product still in the cart? The gift is only discounted while a product carrying that Buy X get Y discount is in the cart beside it.
  8. How many gifts did you expect? Number of gift items caps the gift across the whole cart. If it is blank or unusable, the cap is 1, never unlimited.
  9. Is the gift the right price? Buy X get Y is a percentage off the gift. For a genuinely free gift, set Percentage off the gift to 100.

There’s an “xDiscount configuration” Field on My Products

Open any product that has a live discount and, under Metafields, you’ll see xDiscount configuration. It is the offer exactly as the storefront card and checkout read it, one payload, written by xDiscount every time you save a discount.

  • It is read-only in the product editor, on purpose. It lives in xDiscount’s own namespace, so only the app can write it. To change an offer, edit the discount in xDiscount and the field follows.
  • It is safe to ignore. Nothing you do on the product page changes what checkout charges.
  • If it is missing on a product you targeted, re-saving the discount rewrites it. See A Change Isn’t Reaching the Storefront above.

Before You Ask for Help

Use the floating help button in the bottom-right corner, then Questions. When you report a problem, have this ready:

  • The discount’s name, Status and Sync badge from the Discounts table.
  • The product page URL where you expected the offer, and your plan from Plans & billing in Settings.
  • The exact wording of any banner or error message, including the step names listed if Home showed Your store isn’t fully set up.
  • Your reference from a previous message, if this is a follow-up.

Try one save first

Before reporting anything, open the discount and click Save once. It rewrites the configuration on every product the discount targets, re-reads your plan and re-checks stock, and it clears most Pending and Failed rows on its own.