Skip to main content

Setting Up Code Redemption

Pro.svgALL PLANS

Overview

The Code Redemption Field Widget restricts form submissions by requiring a code, which can be a single shared code or multiple unique codes. This guide will walk you through setting up and configuring the field for your campaign.

Note: This guide assumes you’ve already started a new campaign, selected a template, and added a Form Container. For help starting a campaign, refer to the Getting Started with ShortStack walkthrough video.

Making a Code List

If you’re using a list of unique codes (instead of a single code), create the list before accessing the Campaign Builder:

  1. Use any spreadsheet program to create your list. Each code should be on a separate row.

  2. Save the file in .csv format (comma-separated values).

Note: Unless randomized, codes will be distributed in the order as presented on the list.

Adding the Field to Your Form

  1. In the Campaign Builder, click the Field Widget icon in the Add Widgets Panel.

  2. Drag the widget into the desired position within your Form Container.

  3. In the pop-up, choose Code Redemption from the available field types.

  4. Click Next to proceed.

Configuring the Field

The Field Settings section in the widget settings includes the following configurable areas:

Layout

Adjust the field's width:

  • 30%, 50%, or Normal (100%).

Text

Add a Label and a Placeholder that will appear in the field before the entrant types anything.

Validation

This section allows you to configure how the code redemption works. Detailed instructions are provided below in the Code Redemption Field Validation section.

Error Messages

Customize error messages for specific scenarios:

  • If field left blank: Message shown when the field is empty.
  • Code invalid: Message shown for incorrect codes.
  • Maximum # characters: Set the character limit for field inputs.

Field Points

Assign extra points for entrants who complete the field. Enter the number of points in the Extra points awarded if field completed field.

Other

Instructions: Add text below the field to provide guidance for entrants.

Extra CSS Classes: Attach CSS classes to style the field via the CSS Editor.

Code Redemption Field Validation

The Validation section is where you configure the core functionality of the Code Redemption field:

  1. Select one of the following options:

    • Always: Field is always mandatory.

    • When Visible: Field is mandatory only when visible.

    • Never: Field is not required.

  2. Select a Code Validation Method:

    • Single Value: Enter a single code that entrants can use. Codes are not case-sensitive.
    • Code List (Pro Plan and higher): Upload a list of unique codes or select an existing list.

  3. (Optional) Uploading a New Code List. 

    • Click New Code List in the pop-up.
    • Drag and drop the .csv file or select it from your computer.
    • Name your list and click Save & Upload.
    • Select your uploaded list and click the blue Select button.
    • To change the connected list, click the edit (pencil) icon next to the list name.

  4. Save and exit. 

Checking Redeemed Codes

Track code usage in the Code Lists Manager:

  1. In your Dashboard, click Other at the top and select Code Lists from the dropdown.

  2. View the total number of codes, issued codes, and redeemed codes for each list. Click any of these numbers next to a list to view detailed data.

  3. Redeemed codes display the date they were submitted in the Redeemed column.

  4. Click the date to view the entry that submitted the code.

  5. Delete codes by clicking the trashcan icon next to the code.

 

Was this article helpful?