Discount Code Not Working

When a customer reports that a discount code does not apply, the cause is almost always a rule on the discount rather than a fault, and most of what you need is visible on the Discounts page. The page groups discounts by status and shows the key rules as columns, so you can usually name the reason without opening each section. Use the reference below to turn what you see on that page into a cause and a fix, then confirm it by trying the code yourself.

Before you begin

• Your role includes Edit discounts.
• You have the exact code the customer entered, since a mistyped code and a rule that excludes them look the same from the outside.
• Open Discounts in the admin sidebar and open the discount the customer is trying to use.

Read the discount on the Discounts page

The Discounts page shows the status tabs, All, Active, Scheduled, Expired, and Draft, and columns for Status, Method, Eligibility, Type, Combinations, and Used. Those are the signals you read to find the blocking rule.

(opens full size)

What you see, what it means, and how to fix it

Why two of these are easy to miss

An automatic discount has no code, so no code can work. A discount is either a code customers type at checkout or an automatic one that applies on its own when the cart qualifies. If it was saved as automatic, there is nothing to enter, and it may already be reducing the customer's total. Their report of a code that does not work describes a code that was never meant to exist.

A discount set not to combine will refuse a cart that already has one. Every other rule can be met and it still does nothing, with no sign that the other discount is the reason. Empty the cart of other discounts and try the code on its own.

Confirm it yourself

The columns explain most cases, but the fastest way to be certain is to reproduce the problem. Add the same items to a cart and enter the code in a private browser window to see exactly what the customer sees, including the message they get. A private window shows the live storefront rather than a cached view, so your result matches theirs.

Checks that live on the discount

A few conditions do not appear in the list and are only on the discount's own page. Open the discount to check these when the columns do not explain the problem.

• The active dates, which set when the discount can be used.
• Any minimum purchase amount the cart must reach.
• The usage limits, both in total and per customer.

See Create a Discount Code for what each of these settings does.

Where each fix is made

The fixes in the table are made in a few different places, and each has its own article.

• Publishing a Draft discount, or moving one between states, is covered in Discount Status Flow.
• Changing when a discount starts or ends is covered in Schedule Discounts.
• Raising or removing a usage cap is covered in Discount Usage Limits.
• Letting two discounts apply together is covered in Combining Discounts.

Verify the result

• You can name the specific rule that stopped the code, such as an expired date or an unmet minimum.
• Entering the code yourself under the customer's conditions reproduces the same outcome.
• The customer is told either how to qualify or that you have adjusted the discount.

Best practices

• Test a discount by placing an order before you publish it, which catches most blocking rules before a customer meets them.
• Reproduce a reported problem in a private browser, so you see the real message rather than guessing.
• Tell the customer the specific reason in plain terms, so they know exactly what to do next.
• Set minimums, limits, and combination rules deliberately, since each one is a reason a code can fail to apply.

Next steps

• Create a Discount Code
• Combining Discounts
• Apply a Discount to a Customer Segment

Related articles

• Discount Analytics
• Customer Segments
• Discounts Performance Report