Using Unique Codes in Emails
ShortStack allows you to distribute unique codes (e.g., coupon codes or prize names) through emails or the Instant Win feature. This guide walks you through creating a code list, attaching it to an email, and managing the distribution process.
Step 1: creating and uploading your Code List
1. Download a template
Use the Simple Template for most cases. This template has one column with a header: code. For advanced configurations, use the Advanced Template, which includes multiple columns for additional data.
2. Populate your Code List
Open the template in a spreadsheet program (Google Sheets, Microsoft Excel, etc.).
Add your codes or data beneath the column headers.
Save the file as a
.csv.
3. Upload your Code List
From the Home Page, click on the Manage dropdown menu, then select Code Lists.
Click the blue New Code List button.
Drag and drop your
.csvfile into the upload window or click Select to navigate to it.Name your list in the Name your list field.
Check the Randomize the order... box if desired.
Click Save & Upload.
When the upload is complete, click Continue.
Your new code list will appear in the Code Lists Manager.
Note: Unless randomized, codes will be distributed in the order as presented on the list.
Step 2: building your email
Starting with the Emails Manager
Click on the Manage dropdown menu, then select Emails.
Click New Email and choose the email type.
Starting with the Campaign Builder
Open your campaign in the Campaign Builder.
Click the envelope icon in the top-right.
Click New Email next to the list for which you want to create an email.
Note: If your campaign has multiple forms, ensure you choose the correct list.
Step 3: attaching your Code List
There are three ways to set up codes in your email:
One code (no Code List)
Select YES - One Code and click Continue.
Choose a template or click Continue to proceed without one.
Customize your email content, manually adding the single code where indicated.
Finish building and reviewing your email, then click Save & Activate.
Instant Win
Select YES - Instant Win and click Continue.
Choose a template or click Continue to proceed without one.
In the Email Designer:
Add messages for winners under
{% if entry.instant_winner %}.Add non-winner messages under
{% else %}.Use
{% endif %}for universal messages.
Insert the merge field for prize codes (
{{ entry.prize_codes }}):Click the Prize Code button in the left panel or type the merge field manually.
Finish editing, testing, and activating the email.
Note: Enable Instant Win in your campaign to activate this feature. Refer to the Instant Win Help Doc for guidance.
Code List
Select Code List and click Connect Code List.
Highlight an existing list and click Select, or click New Code List to upload a new list.
Name your list, upload it, and click Save & Upload.
Confirm the attached list, then click Continue.
In the Email Designer:
Insert the merge field for prize codes (
{{ entry.prize_codes }}) by clicking the Prize Code button.Use the Prize Code URL button for displaying codes as QR codes.
Finish editing, testing, and activating the email.
Viewing assigned codes
To check which code was assigned to an entry:
Open the Entries Manager for the corresponding list.
Hover over an entry and click View Details.
The code will appear next to a trophy icon in the Entry Details view.
Related resources
Was this helpful?
Thanks β that helps us decide what to fix next.
Sorry this missed. Tell us what you needed and we'll get you an answer β and fix the page.