Creating Promotion Codes

Creating a Single Code

1. Navigate to STORE > Promotions Builder.

2. Select the promotion for which you want to create a code.

3. Go to the Promotion Codes tab.

4. (Optional) On the right-hand side, select Add a new promotion code.

   The Add a new promotion code button is disabled for automatic promotions. To manually create a code, ensure the Coupon-driven checkbox is selected while creating the promotion.

5. In the Create Single code tab:

   1. Provide a code in the Create a code field.

   2. Choose your audience:

      • Public: The code is available to everyone.
      • Private: The code is specific to a particular shopper, so you’ll need to enter their unique identifier.

   3. Set the code type:

      • Regular code: A standard code that can be used by any shopper.
      • First time Shopper code: A code for shoppers using it for the first time. This option is only available when you set the audience to Public.

   4. Define limitations. Choose either No limitations or Add limitations. This option is only available when you set the code type to Regular code.

      If you select Add limitations, set at least one of the following limitations:

      • specify the Max code use across all checkouts to control how many times the code can be used overall. Each time a shopper checkouts, the usage is tracked against this number.
      • specify the Max times a shopper can apply the code to control how many times the code can be used per shopper. See Create Max Uses Per Shopper Promotion Codes
        • specify the max use limitation to Include Guests or Exclude Guests.
          • See the API spec on how to use max_uses_per_shopper.includes_guests

      By default, the Commerce Manager uses the per checkout method. However, if you need to limit usage on a per_application basis, you can configure this via the backend. See Creating Promotion codes.

6. Select Save Changes.

Searching for a Promotion Code

You can search for a promotion code across all promotions.

1. Go to STORE > Promotions Builder.

2. In the Search coupon code field, enter the promotion code you are looking for on the All Promotions page.

   The promotion name associated with the promotion code is displayed.

Bulk generate promotion codes

caution

• You can only generate a maximum of 1000 codes for a single promotion.
• When generating more than 1000 codes, the promotion's duration must be limited to a maximum of 365 days from its start date. If you need to increase the number of promotion codes for a single promotion, reach out to our customer success team.

With bulk generating codes, you can generate large number of unique promotion codes. To do so, follow these steps:

1. Go to STORE > Promotions Builder.
2. Select the promotion name for which you want to create codes.
3. Go to the Promotion Codes tab.
4. On the right-hand side, click Add a new promotion code.
5. In the Bulk generate codes tab, enter the following details:

• Number of codes to generate : Specify the number of codes to be generated.
• Code character limit : Specify the desired code length, which ranges from 8 to 16 characters. The default code length is eight characters, and a dash is added after every four characters in the code. For example, aa2b-3c4d.
• (Optional) Assign a prepend value to all codes : Add a prefix value to the generated codes. When codes are generated, the specified prepend value is added as a prefix to each code. For example, if you set summer as prepend value and aa2b-3c4d is generated, the promotion code is summer-aa2b-3c4d.
• (Optional) Assign a maximum time each code can be applied : Enter the maximum number of usages of a code for a promotion. If no value is set, customers can use the code unlimited number of times. We recommend you to set value greater than or equal to 1.

6. Click Bulk-generate code.

   The page will display a loading indicator while the codes are being generated. Once the job is complete, the generated codes will appear on the Promotion Codes page.

Export promotion codes

Using the Manage Code Export tab, you can export your promotion codes and download them in CSV format. To do so, follow these steps:

1. Go to STORE > Promotions Builder.
2. Select the promotion name for which you want to export the codes.
3. Go to the Promotion Codes tab.
4. On the right side, click Manage Code Export.
5. Click Create export to initiate the code export process.

The page will display a loading indicator while the codes are being exported. Once the export is completed, you can download the exported file in CSV format.

Demos

Generating Bulk Coupon Codes in Commerce Manager

Maximum Promotions Usage Limitations for Guest Shopper