Shopify Knowledge Base

Issue Guide

A Shopify discount code is not applying at checkout

Why Shopify discount codes fail at checkout, and how to diagnose cart eligibility, combinability, and draft-order limitations before assuming the code is broken.

Symptom

The discount exists, but checkout says it is invalid, not applicable to the cart, or applies a different discount combination than the merchant expected.

Start with these checks

  • 01Review the discount's active dates, entitlements, minimum requirements, and customer eligibility.
  • 02Check whether another code, automatic discount, or checkout context is overriding the expected outcome.
  • 03If testing draft orders, confirm customer-applied discounts are enabled and account for Shopify's draft-order discount limitations.

Most discount failures are not software bugs. They are rule mismatches between what the merchant expects and what the cart actually qualifies for at checkout.

That is why the error feels so frustrating. The code exists, the campaign is live, and the buyer is ready to purchase, but the discount engine is enforcing conditions around products, customers, timing, combinations, or checkout context that are easy to miss in a hurry.

Why a valid code can still fail

Shopify distinguishes between a code that does not exist and a code that exists but does not apply to the current cart. The second case is the common one. The discount may be restricted to certain products, customers, or minimum thresholds, and checkout is correctly rejecting a cart that does not qualify.

Combination rules create a second layer of confusion. Shopify's FAQ notes that if multiple codes are entered and they cannot be combined, checkout applies the best valid combination it can. Merchants often read that as random behavior when it is actually discount precedence doing its job.

  • The cart does not meet the discount's entitlements or minimum conditions
  • Another code is present and the discounts cannot be combined
  • Gift cards or excluded items change how the code behaves
  • The merchant is testing in a checkout context with extra discount limitations

What to inspect first

Start inside the discount configuration itself. Check dates, products, collections, customers, minimum spend, and combination settings. Then recreate the exact cart conditions instead of testing with a rough approximation that may never qualify.

If the order is being sent as a draft invoice or draft checkout link, review Shopify's draft-order limits carefully. By default customers cannot apply discount codes to draft checkouts unless that option is enabled for that individual draft, and shipping discounts or Buy X Get Y discounts are not supported there.

  • Validate eligibility rules against the exact test cart
  • Check combination settings before testing with multiple codes
  • Review gift card, shipping, and excluded-item edge cases
  • Account for draft-order limitations and customer-applied discount settings

When discounting needs technical intervention

Once promotions rely on stacked discounts, market-specific logic, or app-driven custom discount behavior, the problem stops being a simple admin setting. The team needs to understand the discount model across the whole checkout experience rather than one code in isolation.

That is where custom Functions, app rules, or campaign cleanup may matter more than creating one more version of the same discount and hoping checkout finally accepts it.