Discount codes adds a field to your cart drawer where shoppers type a discount code and see straight away whether it worked. You don't create codes here: codes are created in your Shopify admin, and Atlas checks what shoppers type against them. By the end of this you'll have the field in your cart, styled to match.
In this article:
How to add the discount code field
Open your cart upsell in the editor and click Discount codes, under Footer.
Switch it on with the switch at the top of the panel.
In Content, set the field's placeholder and button text.
In Colors, set its colours.
Click Publish.
Content settings
Setting | Default | Limit | What it does |
Input placeholder | Discount code | 50 characters | The grey text inside the empty field. Help text: “Shown inside the empty discount code field.” |
Apply button text | Apply | 20 characters | The button next to the field. |
Neither can be left empty. An empty one stops the cart upsell saving, with “Enter the discount code placeholder.” or “Enter the apply button text.”, even while discount codes are switched off.
Change them if your store calls codes something else, such as "Promo code" or "Gift card or voucher".
Colors settings
Setting | Default | What it colours |
Input background | #FFF | The field |
Input text | #000 | The code the shopper types |
Button background | #000 | The apply button |
Button text | #FFF | The apply button's text |
Success message | #059669 | The applied code and the line showing the saving |
Success background | #F3F4F6 | Behind the applied code |
Error message | #DC2626 | The message shown when a code doesn't work |
💡 Check the error state carefully. Typos and expired codes are common, and an error message that's hard to read on your background fails exactly when shoppers need it.
Previewing the field's states
The Preview section switches the editor's preview between three states: No discount, Valid code (with the sample code SAVE10) and Invalid code (with WRONGCODE and a sample error). This only changes the preview and isn't saved.
What shoppers see
The field sits in the drawer's footer, under shipping protection and above the subtotal. When a shopper types a code and clicks your apply button, Atlas asks Shopify to apply it to the cart:
What happened | What the shopper sees |
The code works | The code replaces the field, and a line under it shows “You saved” with the amount, or “Discount” and “Applied at checkout” for a free shipping code |
Nothing was typed | “Please enter a discount code” |
The code is active, but Shopify won't apply it to this cart (for example, it can't combine with a bundle discount) | “This code can't be applied to your cart” |
The code doesn't exist, or was mistyped | “This discount code is not valid” |
The code isn't active in Shopify: scheduled, ended or deactivated | “This discount code is not currently active” |
Its start date hasn't come yet | “This discount code is not yet active” |
Its end date has passed | “This discount code has expired” |
It's been used as many times as its total limit allows | “This discount code has reached its usage limit” |
Atlas couldn't check the code | “Unable to validate discount code. Please try again.” |
The cart couldn't be updated | “Failed to apply discount code. Please try again.” |
If a code fails, a code that was already working stays applied. Shoppers can also remove an applied code, which shows “Discount code removed”.
The editor's sample error is worded differently from these. On your store, shoppers see the message for the actual reason.
When a shopper says a code didn't work, ask which message they saw: each one points to a different setting in Shopify. See Why did a discount code fail in the cart?
Codes are created in Shopify
Create codes in your Shopify admin under Discounts, with the method set to Discount code. There's no separate list of codes in Atlas. See Shopify's guide to discounts.
These are different from the automatic discounts behind a reward progress bar, which shoppers never type. See Setting up the reward progress bar.
Should you show the field?
Turn it on when you actually hand out codes: email campaigns, influencer partners, win-back offers, or support goodwill.
⚠️ An empty code field on a store that rarely issues codes sends shoppers off to search for one, and some don't come back. If your promotions are automatic discounts, leave this feature off.

