Shopify DiscountsLast reviewed

How to Create a One-Time Use Discount Code in Shopify

Who this is for

Retention, CX, and marketing ops teams issuing apology codes, welcome codes, or VIP codes that must not be reused or shared.

Shopify has two different 'one-time' limits, and teams often pick the wrong one. 'Limit to one use per customer' lets every customer use the code once — the code can still be shared publicly. 'Limit number of times this discount can be used in total' set to 1 means the very first redemption by anyone burns the code. For apology or VIP codes you usually want a unique code per person with a total limit of 1. For welcome offers you usually want one shared code with one use per customer.

When to use this

  • Support issues goodwill or apology codes to individual customers.
  • A welcome code was posted on a coupon site and is being reused.
  • You're sending personalised VIP or win-back codes.
  • Finance wants every discount to be traceable to one customer.
  • You need to stop the same customer redeeming a code twice.

Step-by-step workflow

  1. 1

    Decide: shared code or unique code

    Shared code + one use per customer suits public welcome offers. Unique code + one use total suits anything that must not be shared (apology, VIP, influencer seeding).

  2. 2

    Set the usage limits

    Under Maximum discount uses, tick 'Limit to one use per customer' and/or 'Limit number of times this discount can be used in total' and set it to 1. Both can be on at once.

  3. 3

    Generate unique codes when you need many

    For a handful, create each code individually. For hundreds or thousands, add codes to one discount in bulk through the Admin API (discountRedeemCodeBulkAdd), a bulk-code app, or your email platform's Shopify integration, so every customer gets their own code under the same rules.

  4. 4

    Restrict eligibility when the code is personal

    For codes meant for one person, limit Customer eligibility to that customer or a segment. A leaked code then fails for anyone else.

  5. 5

    Test both limits before sending

    Redeem the code once with a test email, then try again with the same email and with a different email. Confirm each behaves as intended.

Goodwill code issuance log

Customer email: [EMAIL]   Order: [#ORDER]
Reason code: [late delivery / damaged / service failure]
Code: [UNIQUE-CODE]   Value: [$ / %]
Limits: [x] one use total  [x] one use per customer
Eligibility: [specific customer]
Expiry: [DATE]
Issued by: [AGENT]   Approved by (if > $[THRESHOLD]): [NAME]

Frequently asked questions

What's the difference between one use per customer and one use total?

One use per customer lets each customer redeem the code once, so a shared code can be used many times by different people. One use total means the code stops working after the first redemption by anyone.

How does Shopify know a customer already used a code?

Shopify checks the customer's details at checkout, such as the email address. Customers can sometimes get around per-customer limits with a new email, which is why sensitive codes should be unique with a total limit of 1.

Can I create thousands of unique discount codes in Shopify?

Yes. Bulk-add codes to a single discount through the Admin API or a bulk-code app. Every code shares the discount's rules, and each can be limited to one use.

Related resources and tools

Browse all Shopify answers →