Skip to main content

Letting shoppers use discount codes in the cart

Add a discount code field to your cart drawer, set its text and colours, preview its states, and know every message shoppers can see. The codes themselves are created in Shopify.

Written by Grace

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

  1. Open your cart upsell in the editor and click Discount codes, under Footer.

  2. Switch it on with the switch at the top of the panel.

  3. In Content, set the field's placeholder and button text.

  4. In Colors, set its colours.

  5. 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.

Did this answer your question?