Ask the shopper which message they saw. The discount code field in your cart drawer shows a different message for each reason a code fails, so each message points to what to check on the code in your Shopify admin. “This code can't be applied to your cart” means the code exists and is active, but Shopify won't apply it to that cart, often because it can't combine with a discount already there, such as a bundle discount. Codes are created and managed in Shopify, not in Atlas.
In this article:
What each message means
Message | Cause | What to do |
The code replaces the field, with “You saved” and an amount (or “Applied at checkout”) | The code worked | Nothing |
“Please enter a discount code” | The field was empty | Nothing to fix |
“This code can't be applied to your cart” | The code exists and is active, but Shopify won't apply it to this cart | See "If the code can't be applied to the cart" below |
“This discount code is not valid” | No code with that name exists, or it was mistyped | Check the exact spelling, then check the code exists in Shopify |
“This discount code is not currently active” | The code isn't active in Shopify: it's scheduled to start later, it has ended, or it was deactivated | Check its status and dates in Shopify |
“This discount code is not yet active” | Its start date hasn't come yet | Change the start date |
“This discount code has expired” | Its end date has passed | Change or remove the end date |
“This discount code has reached its usage limit” | It's been used as many times as its total limit allows | Raise the limit, or create a new code |
“Unable to validate discount code. Please try again.” | Atlas couldn't check the code with Shopify | Usually brief. Ask the shopper to try again. |
“Failed to apply discount code. Please try again.” | The cart couldn't be updated | Usually brief. Ask the shopper to try again. |
“Failed to remove discount code. Please try again.” | The shopper tried to remove an applied code, and the cart couldn't be updated | Ask the shopper to try again. |
When a code fails, any code that was already working in the cart stays applied.
💡 Look hard at “This discount code is not valid”. It covers both a typo and a code that doesn't exist, and spaces copied along with a code are a common cause. Check exactly what the shopper typed before deciding the code is broken.
The editor's Invalid code preview shows a sample message worded differently. Shoppers see the messages in this table.
Why it happens
Atlas doesn't keep its own codes. When a shopper clicks your apply button, Atlas asks Shopify to apply the code to the cart. If Shopify refuses, Atlas looks the code up in your store to tell the shopper why: whether it exists, whether it's active, its dates and its usage limit. If none of those is the problem, the reason is something about that cart, and the shopper sees “This code can't be applied to your cart”.
How to check a code in Shopify
In your Shopify admin, go to Discounts.
Find the code and open it.
Check each of these:
Check | What to look for |
Status | Active, not scheduled or expired |
Active dates | The start date has passed and the end date hasn't |
Usage limits | The total limit isn't reached, and a once-per-customer limit isn't already used by this shopper |
Minimum requirements | The cart meets any minimum amount or quantity |
Customer eligibility | The code isn't limited to customers or segments the shopper isn't in |
Products or collections | The code applies to something in the cart |
Combinations | The code can combine with the other discounts in the cart |
To create codes, go to Discounts in Shopify and choose Discount code as the method. See Shopify's guide to discounts.
If the code can't be applied to the cart
“This code can't be applied to your cart” means the code is fine on its own, but Shopify won't apply it to what's in this cart. Check, in order:
Combinations. If the cart has a bundle discount or another automatic discount, open the code in Shopify and look at Combinations. Allow it to combine with product discounts (bundle discounts are these), and with order and shipping discounts if you use them. See Shopify's guide to combining discounts.
Minimum requirements. The cart may be below the code's minimum amount or quantity.
Products or collections. The code may apply only to products that aren't in the cart.
Customer eligibility and once-per-customer limits. The code may be limited to customers the shopper isn't, or already used by them.
If a code works when typed at Shopify's checkout but not in the cart, ask shoppers to enter it at checkout for now, and contact support with the details below.
When you contact support, include the exact code, the exact message the shopper saw, a screenshot of the code's settings in Shopify, and roughly what was in the cart.
If it still isn’t working, open the menu from your profile at the bottom of the sidebar and choose Chat with support, or email support@helloatlas.io.
