Voucher Codes Guide

Learn how to create, upload, and manage discount codes for your referral program rewards.

What are Voucher Codes? (ELI5)

Think of voucher codes like digital gift cards or discount coupons that you give to people in your referral program. When someone refers a friend (or gets referred), they receive a special code that they can use to get a discount on their next purchase.

Simple example: Imagine you run a coffee shop. When Sarah refers her friend Mike, you give Sarah a code like "SAVE10" that gives her 10% off her next coffee. You might also give Mike a code like "WELCOME5" that gives him $5 off his first purchase. These codes are your "voucher codes" - they're the rewards that motivate people to participate in your referral program.

What voucher codes do: They automatically get assigned to people when they successfully refer someone (or get referred) and that person makes a purchase. The system tracks who got which code, when they got it, and whether they've used it yet.

What voucher codes don't do: They don't automatically apply discounts at checkout - you still need to integrate the code validation into your e-commerce system. Mouthfully just manages and assigns the codes; you handle the redemption part.

Key Concepts

Unique vs Non-Unique Vouchers

Unique vouchers are like one-time-use gift cards. Each code can only be assigned to one person, one time. Once someone gets "SAVE20", nobody else can get that same code. Perfect for special rewards or limited-time offers.

Non-unique vouchers are like reusable discount codes. The same code (e.g., "FRIEND10") can be given to multiple people, and each person can use it once. You can set a limit (like "this code can be used 100 times total") or make it unlimited. Great for standard referral rewards that everyone gets.

Example:

Unique: "VIP2024" - Only one person gets this special code
Non-Unique (100 uses): "REFERRAL10" - Up to 100 people can get this code
Non-Unique (unlimited): "WELCOME5" - Everyone who gets referred can use this code

Who Gets the Voucher?

When someone makes a purchase after being referred, you can give vouchers to different people:

Referrer (the person who made the referral)

Sarah refers Mike. When Mike buys something, Sarah gets a voucher. This rewards the person who did the referring.

Friend (the person who was referred)

Sarah refers Mike. When Mike buys something, Mike gets a voucher. This rewards the new customer.

Both

Sarah refers Mike. When Mike buys something, BOTH Sarah and Mike get vouchers. This rewards everyone!

Discount Types

You can create two types of discounts:

Percentage Discount

A percentage off the total purchase. Example: 20% off means if someone buys $100 worth of products, they pay $80.

Use when: You want the discount to scale with purchase size. Bigger purchases = bigger savings.

Fixed Amount Discount

A fixed dollar amount off. Example: $10 off means they save exactly $10, regardless of purchase size.

Use when: You want consistent rewards. Everyone saves the same amount, whether they buy $50 or $500.

Creating Voucher Codes

Create Individual Codes

Create one voucher code at a time through the dashboard. Perfect for special promotions or limited codes.

Steps:

Go to the Voucher Codes tab in your dashboard
Click "Create Voucher Code"
Enter the code (e.g., "SAVE20")
Choose discount type (percentage or fixed amount)
Set the discount value
Choose if it's unique or can be reused
Set who gets it (referrer, friend, or both)
Click "Create"

Bulk Upload via CSV

Upload hundreds or thousands of codes at once using a CSV file. Great for large-scale referral programs.

CSV Format:

code,discount_type,discount_value,is_unique,assignment_target,max_uses
SAVE20,percentage,20,true,both,1
FIXED10,fixed,10.50,false,referrer,100
WELCOME5,percentage,5,false,friend,

Note: Only the "code" column is required. Other fields will use defaults if not provided.

Steps:

Create a CSV file with your voucher codes
Go to Voucher Codes tab → "Bulk Upload"
Select your CSV file
Set default discount type and value (used for rows missing these fields)
Click "Upload"
Review any errors and fix them if needed

Managing Your Vouchers

View Assignments

See who received each voucher code, when they got it, and whether they've used it. Click the eye icon next to any voucher to see all assignments.

Edit Vouchers

Update discount values, change status, or modify usage limits. Click the edit icon to modify any voucher code.

Export Codes

Download all your voucher codes as a CSV file. Useful for backup, analysis, or sharing with your team.

Delete Codes

Remove individual codes or bulk delete multiple codes at once. Deleted codes cannot be recovered, so be careful!

Best Practices

Use clear, memorable codes: "SAVE20" is better than "VC2024X7K9"
Set appropriate limits: For unique vouchers, you only need 1 use. For reusable codes, set limits based on your program size.
Track your codes: Regularly check the "View Assignments" feature to see which codes are being used.
Test before launching: Create a test voucher and verify it works in your checkout system before assigning it to real customers.
Keep backups: Export your codes regularly so you have a record of all active vouchers.
Monitor usage: Watch the "Uses" column to see which codes are popular and which aren't being used.

Common Questions

How do vouchers get assigned to people?

Vouchers are automatically assigned when a conversion happens (someone makes a purchase after being referred). The system looks for available vouchers that match your assignment target settings and assigns them automatically.

Can I use the same code for multiple people?

Yes! Set is_unique: false and set a max_uses limit (or leave it unlimited). The same code can then be assigned to multiple people, and each person can use it once.

What happens if I run out of available vouchers?

If all your vouchers are assigned or expired, new conversions won't receive vouchers until you create more. Make sure to create enough vouchers to match your referral program volume, or use non-unique vouchers with high limits.

Do I need to integrate voucher redemption in my store?

Yes. Mouthfully manages and assigns the vouchers, but you need to integrate code validation into your checkout system to actually apply the discounts when customers use the codes.