This tool allows you to create, view, and export coupons in bulk for existing promotions as well as view the status of your existing promotions.
To use the tool, you must first create a coupon promotion in BigCommerce.
Article Contents
This support article contains several sections which can be accessed quickly by clicking the appropriate link below:
- Note for Accounts Created Prior to August 23, 2023
- View Existing Promotion Details
- View Existing Coupon Details
- Create Coupon Codes in Bulk via Wizard
- Create Coupon Codes in Bulk via Import
- Export Bulk Coupon Codes
- Frequently Asked Questions
Note for Accounts Created Prior to August 23, 2023
If you created a Your Store Tools account prior to August 23, 2023, you will need to create new API keys that give Your Store Tools access to modify promotions. If this is not done, you will receive errors when trying to create coupons. For details on how to create new API keys, click here.
View Existing Promotion Details
From the Bulk Coupon Creator tile, choose View Promotions:
Choose the promotion you want to view the details for and click View:
The details screen will show:
- Name of the promotion as it is set in BigCommerce
- Whether the promotion is ENABLED or DISABLED
- Type of redemption, such as COUPON
- Maximum number of uses set for the coupon
- Number of times the coupon has been used so far
- Coupon start and end dates
View Existing Coupon Details
From the Bulk Coupon Creator tile, choose History.
Choose the promotion you want to view the coupons for and click View Coupons:
The details screen will show:
- Individual coupon code
- Maximum number of uses for the code
- Number of times the coupon has been used so far
- Date the coupon code was created
Create Coupon Codes in Bulk via Wizard
Select the storefront and the promotion you want to create coupons for. Once your coupon promotion is selected, click Next to begin to create coupons in bulk.
Choose Create via Wizard from the drop down:
The wizard will ask you to set:
- Coupon Length – a numerical value between 3 and 20
- Number of Coupons to Generate – a numerical value between 1 and 500,000
- Coupon Prefix – allows you to set an optional set of characters to prepend to your coupon code such as “VIP” or “JULY.”
- Coupon Suffix – allows you to set an optional set of characters to append to your coupon code such as “THANKS” or “2023.”
- Character Set – allows you to set the formatting and character sets for the coupon code such as:
- Allowing or disallowing upper and lower case letters
- Allowing or disallowing numerical digits
- Allowing or disallowing symbols
- Coupon Delimiter – allows you to set a delimiter that will separate elements of the code such as a “-” or a “|.”
- Coupon Split Length – allows you to set the number of characters where the code will be split by the delimiter. For example, if you have a 16 digit coupon code, you can set the length to 4 so the code would be split such as “1234-5678-9012-3456.”
- Max Uses Per Code – the maximum number of times the coupon code can be used. This should be a numerical value between 1 and 10,000.
- Max Uses Per Customer – the maxmimum number of times the coupon code can be used by a single customer. This should be a numerical value between 1 and 1000.
Once your formatting has been set, a sample of the coupon code will be shown in the example box at the bottom of the screen.
Once you have verified the coupon details are correct, click Next.
By default, Your Store Tools will email you when the process is complete. If you choose to receive this notification, verify your email address is correct before clicking Submit. A notification will also appear in the notification center.
Create Coupon Codes in Bulk via Import
Select the storefront and the promotion you want to create coupons for. Once your coupon promotion is selected, click Next to begin to create coupons in bulk.
Choose Import from File from the drop down:
Your CSV file should contain a header row with the following fields:
- Coupon Code – the pre-generated coupon code
- Max Uses Per Code – the maximum number of times the coupon code can be used. This should be a numerical value between 1 and 1000.
- Max Uses Per Customer – the maxmimum number of times the coupon code can be used by a single customer. This should be a numerical value between 1 and 1000.
Once your file is uploaded, click Next to map your fields:
Click Next.
By default, Your Store Tools will email you when the process is complete. If you choose to receive this notification, verify your email address is correct before clicking Submit. A notification will also appear in the notification center.
Export Bulk Coupon Codes
Once your bulk coupons are created, you can download an Excel file with a list of all codes by selecting View Promotions from the Bulk Coupon Creator tile:
Find the promotion you want to download the coupons for and select on Export All Coupons if you want to download all the coupons created for the select promotion.
If you want to use filters to select which coupons to download, click on View Coupons and filter to your specifications:
Once you’re ready to export, you will be asked to select a date and file format:
Once selected, click on Export Coupons:
Depending on the number of coupon codes you’re exporting, the process may take a while to complete.
When complete, the file will be saved to your computer as an Excel file.
Frequently Asked Questions
The Bulk Coupon Creator will allow you to create up to 500,000 coupons at once using the wizard.
No. During the coupon creation process, we run a check of existing coupon codes in the promotion to ensure that no duplicates are created.
When coupons are created in bulk, the latest version of BigCommerce Promotions does not allow you to view individual coupon codes in the store. You can, however, search and view the individual coupon codes and their usage in the Bulk Coupon Creator by choosing View Promotions from the hamburger menu on the tool’s tile.
The Bulk Coupon Creator is subject to rate limits imposed by BigCommerce, depending on how many coupons you’re creating, it can take several minutes to complete. We suggest selecting the option to be notified by email when the job is completed. You can also check the status on the tool tile or look for a notification in the notification center.
No. If during the process of creating coupon codes, the Bulk Coupon Creator finds a code that was previously used in a different promotion, it will not create a code. We encourage you to use a unique prefix or suffix when creating codes to prevent this. In the event a duplicate is discovered, the number of coupon codes created will be short by the amount of duplicates.
If there are errors during the creation process, you’ll receive an email and/or notification with a file to download showing the errors. The most common error that occurs is a time-out error where BigCommerce temporarily becomes unresponsive to an API request. When time-outs occur, our tool will continue on with the job but will not re-attempt the requests that timed out which would account for the discrepancy.
If you’re exporting a large number of coupon codes, it may take a minute or two for the export to complete based on server load and resources.
Did you find an error or need additional support? Contact us at support@yourstorewizards.com to let us know!