Skip to main content

Setting Up Code Redemption

This feature available on All Plans (except where noted)

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

This feature available on the Pro Plan

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

  1. Create a Code List:

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

  2. Save the File:

    • 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. Add the Field Widget:

    • In the Campaign Builder, click the Field Widget icon in the Add Widgets Panel.
    • Drag the widget into the desired position within your Form Container.

  2. Select Code Redemption Field:

    • In the pop-up, choose Code Redemption from the available field types.
    • 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 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 Validation

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

  1. Set the Field as Required:

    • Check the Required field box if only entrants with a valid code can submit the form.
    • Use Show advanced options to specify whether the field is always required or only when visible.

  2. Select a Code Validation Method:

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

  3. 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.

  4. Connect the Code List:

    • 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.

  5. Save Your Settings:

    • Click Save & Exit in the Form Designer to finalize your setup.

Checking Redeemed Codes

Track code usage in the Code Lists Manager:

  1. Access the Manager:

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

  2. View Code List Details:

    • See 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. Review and Manage Codes:

    • Redeemed codes display the date they were submitted in the Redeemed column.
    • Click the date to view the entry that submitted the code.
    • Delete codes by clicking the trashcan icon next to the code.

 

Was this article helpful?