What settings are available for bulk coupons?

Total Number of Codes

Select the number of unique codes you would like for the campaign.

  • You must select at least 1 and no more than 100,000.
  • After the bulk coupon is created, you have the option to add more unique codes, up to 100,000 for the bulk coupon.

Total Number of Codes

Select the number of unique codes you would like for the campaign.

  • You must select at least 1 and no more than 100,000.
  • After the bulk coupon is created, you have the option to add more unique codes, up to 100,000 for the bulk coupon.
 Required Prefix

Specify a prefix that will be the same across all unique codes.

  • The prefix is the coupon code for the campaign as a whole.
  • It must be unique across all redeemable coupons on your site.
  • The prefix can be alphanumeric and may include a dash (-), underscore (_), or a plus sign (+).
 Generated Code Format

Specify the format of the dynamically generated portion of the code.

  • This is the unique portion of the code.
  • Format can be alphabetic, alphanumeric, or numeric.
 Generated Code length

Specify the character length of the dynamically generated portion of the code.

  • This is the unique portion of the code.
  • Length does not include the prefix or optional suffix.
  • Length must be at least 4 characters for alphabetic and alphanumeric formats, and 6 characters for numeric.
  • Length cannot be longer than 50 characters.

Unique Code Preview

The preview will show you a sample generated unique code reflecting your template choices. Note that the prefix and suffix are always separated from the dynamically generated portion with dashes. Your customers will need to enter the entire code, with dashes, at redemption. If you would like a different unique code template, or do not want to include dashes, you can design your own template through the API.

 

Maximum Redemptions

Maximum redemptions will not show as an option in the Recurly UI when you select the "Bulk unique codes" option. By default, maximum redemptions are set to unlimited in order to allow your number of unique codes to be the limiting factor in redemptions. If you would like to set a maximum redemptions for your bulk coupon, you can do so through the API. If you set a maximum redemptions that is less than the number of unique codes generating, you are saying that not all unique codes can be redeemed, only those redeemed until the maximum redemptions are reached for the coupon.

 

Redemptions Per Account

Redemptions per account will not show as an option in the Recurly UI when you select the "Bulk unique codes" option. By default, redemptions per account are set to "1". A unique code can only ever be redeemed once. If you want a customer to take part in the campaign more than once, you could set the redemptions per account to a number greater than one. This would allow a customer to redeem more than one unique code on their account. You can set redemptions per account to a number other than "1" through the API.

Fill out the rest of your coupon details and click Create Coupon. You will be taken to the Coupons dashboard and will see an alert that your unique codes are being generated. If you requested a large number of codes you may need to wait a minute or two. Go ahead and refresh the page and you will find your new coupon at the top of the Redeemable Coupons table. Click on the coupon's Internal Name or the View Codes link to visit the coupon's details page and see all of your unique codes and their redemption status.