Code Lists Manager

What you can do in the Code Lists Manager

To	Do this
Upload a new code list	Upload a code list.
See which codes were issued and redeemed	Click Total, Issued or Redeemed on the list's info pane.
Add more codes to a list	Use Add Codes in the list's options.
Find a code list	Use Search, Tag and Sort.
Rename or delete a code list	See Code list options.
Tag or delete several code lists at once	Select them.

Before you start

• Code lists need the Scale plan or higher. Tags and Permissions need the Max plan.
• Codes go out in the order they appear in your file, unless you randomize them when you upload.
• Deleting a code list can't be undone. Before you delete one, make sure no email, Form Container or Field Widget still uses it.

Open the Code Lists Manager

Click Manage in the navigation menu, then Code Lists, or go straight to the Code Lists Manager.

What's on the page

Each code list has an info pane showing:

Detail	What it shows
List name	Hover over it and click the edit icon to rename the list. Click the blue checkmark to save.
Last edited	When the list last changed.
Created	When the list was uploaded.
Total	How many codes the list holds.
Issued	How many codes have been given out to entrants, in an email or an Instant Win result.
Redeemed	How many codes entrants have entered in a Code Redemption field.

Click Total, Issued or Redeemed to open the list's codes in the Code List Wizard. Redeemed codes show the date they were submitted in the Redeemed column.

Upload a code list

1. Click New Code List at the top right.
2. Download a template. The Simple Template has one column, code, and suits most lists. The Advanced Template adds columns for more prize details.
3. Open the template in a spreadsheet program such as Google Sheets or Excel, add your codes under the headers, and save it as a .csv file. To give the same code to more than one person, repeat it on as many rows as you want it used.
4. Drag your file into the upload window, or click Select to find it.
5. Name the list, and tick Randomize the order if codes shouldn't go out in file order.
6. Click Save & Upload, then Continue when the upload finishes.

The list appears in the Code Lists Manager.

You can also upload a code list where you use it, with the same steps:

• In an email: click New Code List on the codes step. See Using unique codes in emails.
• In Instant Win: choose Advanced in the Form Container's Instant Win settings, then upload a list in the pop-up. See Instant Win.

To check codes at entry instead, connect the list to a Code Redemption field. See Setting up Code Redemption.

Find a code list

• Search: type a word or phrase from the list's name.
• Tag (Max plan): type a tag to see the code lists that carry it. See Organizing with tags.
• Sort: choose Recently Edited, Newest or Oldest.

Code list options

Click the dropdown arrow on the right of a code list's info pane.

Option	What it does
View Codes	Opens the list in the Code List Wizard, where you can see, add and edit its codes.
Add Codes	Opens the Code List Wizard. Click Add Codes at the top and upload a .csv file of the new codes.
Permissions	Chooses which team members can open this code list. See ShortStack for Teams.
Delete	Deletes the code list and its codes. Your entries aren't affected.

Work with several code lists at once

1. Click a code list to select it. To select several at once, click and drag your cursor across them.
2. Use the options at the top:
   • Tag (Max plan): type tags separated by commas, press Enter/Return, then click Save.
   • Delete: type the confirmation prompt, then click the red Delete button.

If something goes wrong

What you see	What to do
Codes aren't going out in file order	The list was uploaded with Randomize the order ticked. Upload it again without it if order matters.
An entrant sees "This code has already been claimed."	The code they typed has already been redeemed. Click Redeemed on the list's info pane to see when it was used.
The prize code is blank in an email	The email isn't connected to a code list. See Using unique codes in emails.

FAQs

Does deleting a code list delete my entries?

No. Deleting a code list removes the list and its codes for good, and your entries stay as they are.

In what order are codes given out?

In the order they appear in your file, unless you tick Randomize the order when you upload the list.

Can I add more codes to a list I already uploaded?

Yes. Open the list's options, choose Add Codes, and upload a .csv file of the new codes.

Related resources

• Using unique codes in emails
• Setting up Code Redemption
• Instant Win
• How to use unique codes in an email (video)