How to Use Coupon Codes in Klaviyo



Coupons or discounts can be a great way to bring your customers back if they haven't returned recently or to reward them for subscribing to your newsletter.

There are multiple ways to upload and use coupon codes in Klaviyo. This guide covers the following methods:

  • Generate unique coupons codes (for Shopify and Magento 1.x stores)
  • Upload unique coupon codes
  • Upload a single static coupon code for everyone

After you have your coupon codes set up, this guide outlines some ways to use them.

  • Add coupons to your emails
  • Display your coupons as barcodes for your brick and mortar stores
  • Set up coupon reminders for customers that haven't used a coupon code.
  • See who used specific discount codes (Shopify and Magento stores)

Generate Unique Coupon Codes

Klaviyo can auto-generate unique coupons in emails for both Shopify and Magento 1.x stores.

Upload Unique Coupon Codes

You can generate your own set of unique coupon codes outside of Klaviyo, upload them to your Klaviyo account, and reference them in your campaign or flow emails. This is a useful method if you're using point of sale software that can generate and manage coupon codes. There are some important things to note when uploading coupons using this method.

  • Klaviyo doesn't maintain any metadata on your coupons. This means we don't know how much the code is worth, what the expiration period is, what restrictions there are on the code's use.
  • You are responsible for ensuring the validity and expiration dates of these codes will work at your point of sale system.
  • You can set an expiration date when adding coupons codes, but this date only applies to how long the coupon codes are available in your Klaviyo account. 


This feature is not automatically enabled. Please contact our Success Team and request to have it enabled in your account.

Follow these steps to upload your own unique coupon codes.

  1. If you haven't already, contact our Success Team and request to have the Uploaded Coupons feature enabled.
  2. Prepare a list of your unique coupon codes. Each code should be unique. The list of codes should be saved in a CSV file with one column, where the header is Coupon or Coupon Code. Below is an example of what a list of coupon codes look like in a spreadsheet. 
  3. Navigate to your Coupons tab and click the Uploaded Coupons button.
  4. Click Add Coupon to add a new coupon code. Provide a name for your coupon, and select an expiration date.


    If you send a campaign or flow email without enough available coupons codes, then the messages will be skipped.

  5. Click Add Coupon to save your coupon. You're taken back to your Coupons tab.
  6. Click the dropdown for your new coupon and select Add Codes.
  7. Upload your list of coupons. You can drag and drop your file, or select it from your computer.
  8. After selecting your file, review your coupons and then click Start Import
  9. After your coupons finish importing, you can see how many coupon codes uploaded successfully and how many were skipped because of duplicates or a lack of data.
  10. You can now include your coupon codes in your emails. When editing an email, include the following snippet, replacing "coupon_name" with the name of your coupon: 
    {% coupon_code 'CouponName' %}.
  11. After sending, you can check the total available coupon codes by clicking into the Coupons tab and checking the Available/Total column.

When sending uploaded coupon codes in emails, if your send list is larger than your available coupon codes, then the messages scheduled will be skipped.

  • If the code is used in a campaign message, Klaviyo will compare the number of expected recipients to the number of available codes for the coupon used. A warning is displayed if there aren't enough codes available, and you are unable to send the campaign.
  • If the code is used in a flow message, Klaviyo will compare the number of expected recipients to the number of available codes for the coupon used. Flows that contain coupon codes with 0 available cannot be turned live. Live flow emails that contain a coupon with no available codes will be skipped. You can see who was skipped by clicking into the analytics of the flow email and clicking Recipient Activity > Other.

Send Coupons as Barcodes

If you also have brick and mortar stores, you can save your customers (and your cashiers) lots of time by providing a barcode coupon that can quickly be scanned at your point of sale system.

To display a barcode in an email template, use the following template tag:

{% barcode_code 'CouponName' height=100 width=200 %} 

The height is measured in pixels and can be adjusted to serve the design requirements for your template.

Below is an example showing both a regular coupon code as well as a coupon barcode in the template editor.

Below is the same image after it has been rendered.

Some point of sale systems required you to add special characters to your coupon code before it is rendered into a barcode. If you need more control over the code before being rendered, adding the cut parameter to your coupon template tag removes a specific character or characters from all locations in the code displayed. 

For example, let's say your point of sale system requires that you render your barcodes from coupon codes that begin with a hashtag. For your site, you need to remove this hashtag. You can use the cut parameter to pass one version of this code as a barcode, and a separate version that does not include the hashtag for your other code. For the code #GREATdoggo12345, the following tags display these values for a user:

{% coupon_code 'CouponName' cut=# %} == GREATdoggo12345
{% coupon_code 'CouponName' cut=G %} == #REATdoggo12345
{% coupon_code 'CouponName' cut=g %} == #GREATdoo12345
{% coupon_code 'CouponName' cut=5 %} == #GREATdoggo1234
{% coupon_code 'CouponName' cut=#Gg5 %} == REATdoo1234


The cut parameter has the following limitations:

  • This is case sensitive. For example, using cut=i will remove i but not I.
  • Multiple items can be combined a single cut tag.

If you're using the cut parameter, ensure that you fully understand how characters are removed from your rendered code so that customers do not receive corrupted codes.

Add a Single Static Coupon Code For Everyone

For small stores or for certain discounts, you may just want to paste the code straight into the email content being used. If you're worried about the code getting spread, you can change it every couple of months or set a small expiration window.

The first step would be to create a coupon code in your ecommerce platform. To use that in Klaviyo, simply copy/paste the code into your email template. 

Set Up Coupon / Discount Code Reminders

A great use of Klaviyo's automated flows is to automatically follow up with people who haven't used a coupon code to remind them about it. Follow these steps to add coupons to a flow:

  1. Add an additional email to the same flow that was triggered to give out the initial coupon, but set this additional email to go out a few days later. 
  2. Add an Additional Filter to this new email that checks whether or not that person has placed an order that used that discount code. Only allow this follow up email to send if someone hasn't yet placed an order.

One person can only receive one unique coupon code per coupon. If you resend an email to one of your customers using the same coupon, they will receive the same unique coupon code.

See Who Used Specific Discount Codes in Shopify and Magento

For Shopify and Magento stores, Klaviyo has the ability to pull in specific coupon codes being used for each purchase.

This feature lets you easily create a dynamic segment of everyone who used a particular coupon code.

  1. Create a new segment and name it "Used a coupon".
  2. Select What someone has done (or not done) from the dropdown.
  3. Select the Placed Order event and then click the Add Filter option to specify the discount codes to select.

This is a great way to understand if coupons are getting forwarded on to others, shared among friends, etc.


If you are using a custom platform or a platform like Volusion, BigCommerce, Symphony, or others, you may also be able to pull coupon information. Use the Add Filter option to see if a "Coupon" or "Discount Codes" option appears. 

Was this article helpful?
5 out of 9 found this helpful