This guide is for users who installed the Bulk Coupon Creator via Your Store Tools. If you installed the Bulk Coupon Creator via the BigCommerce App Store and access it via your store’s control panel, instructions for that version can be found here.
Creating Bulk Coupon Codes Using the Wizard
Step 2: Create Coupon Codes Using the Wizard
To create coupon codes using the wizard, select "Create via Wizard" from the drop down menu.
This will bring up the wizard which allows you to select various formatting options for your coupon codes, which include:
- Coupon Length: a numerical value between 3 and 20. Keep in mind, BigCommerce allows a maximum coupon code length of 50 characters, and this will include any prefix, suffix, or delimiter you may add.
- 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.”
- Allowed characters:
- a-z
- A-Z
- 0-9
- Underscore and hyphen ( _ and - )
- Allowed characters:
- Coupon Suffix: allows you to set an optional set of characters to append to your coupon code such as “THANKS” or “2023.”
- Allowed characters:
- a-z
- A-Z
- 0-9
- Underscore and hyphen ( _ and - )
- Allowed characters:
- 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
- Coupon Delimiter: allows you to set a delimiter that will separate elements of the code such as a hyphen.
- Allowed characters:
- a-z
- A-Z
- 0-9
- Underscore and hyphen ( _ and - )
- Allowed characters:
- 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 maximum 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 options have been selected, 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.
Step 3: Select Your Notification Type and Submit
By default, Your Store Tools will provide a notification on the dashboard as well as a notification via email when the job is complete. If you choose not to receive a notification via email, you can turn this option off on this screen, or change the email address it will be sent to.
It's important to note that depending on the number of coupon codes you are creating, it can take several minutes for the process to complete.
Once your selection is made, click Submit to finish.
Additional Tool Features
By accessing the stacked menu in the upper right corner of the tool's tile from the dashboard, you can access the following:
- View Promotions:
- Displays a list of all current promotions set up in BigCommerce as well as their details including:
- Name: The name given to the promotion in BigCommerce.
- Status: Whether the promotion is marked as enabled or disabled in BigCommerce.
- Redemption Type
- Max Uses: The number of maximum uses set in the default (non-unique) coupon code. Unique coupon codes can have alternate values for this field.
- Current Uses: The number of times the default (non-unique) coupon code has been used.
- Start Date
- End Date
- Allows you to export an Excel or CSV file of all bulk coupon code usage for a select date range.
- Displays a list of all current promotions set up in BigCommerce as well as their details including:
- History - a list of the last 7 days of processing history for this tool.
- Help - a link to this support document.
Creating Bulk Coupon Codes via a File Upload
Step 1: Create Your CSV File
The Bulk Coupon Creator allows you to upload up to 500,000 unique bulk coupon codes that you generated outside the app.
To begin, you will first need to create a CSV file with your coupon data. It's important to note that BigCommerce only supports the following characters for coupon codes, this includes the code, any prefix or suffix, or delimiters.
- a-z
- A-Z
- 0-9
- Underscore and hyphen ( _ and - )
Your CSV file must contain a header row with the following fields:
- Coupon Code: The pre-generated, unique coupon code. Keep in mind, BigCommerce allows a maximum coupon code length of 50 characters.
- 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 maximum number of times the coupon code can be used by a single customer. This should be a numerical value between 1 and 1000.
Step 2: Launch the Tool and Select Promotion
To begin, launch the Bulk Coupon Creator Tool from the tile on the Your Store Tools dashboard.
Then, select which storefront you want to run this tool on along with the existing promotion you want to create coupon codes for.
Once your promotion is selected, you can click on View Promotion Details to view more information about the promotion you're creating coupons for. Details displayed include:
- Name: The name given to the promotion in BigCommerce.
- Status: Whether the promotion is marked as enabled or disabled in BigCommerce.
- Redemption Type
- Max Uses: The number of maximum uses set in the default (non-unique) coupon code. Unique coupon codes can have alternate values for this field.
- Current Uses: The number of times the default (non-unique) coupon code has been used.
- Start Date
- End Date
When you're ready to proceed to the next step, click Next.
Step 3: Upload Your CSV
Select "Import from File" from the drop down menu.
Upload your CSV file.
Click Next.
Step 4: Map Your Fields
Map the columns in your CSV file to the appropriate fields, then click Next.
Step 5: Select Your Notification Type and Submit
By default, Your Store Tools will provide a notification on the dashboard as well as a notification via email when the job is complete. If you choose not to receive a notification via email, you can turn this option off on this screen, or change the email address it will be sent to.
Once your selection is made, click Submit to finish.
Additional Tool Features
By accessing the stacked menu in the upper right corner of the tool's tile from the dashboard, you can access the following:
- View Promotions:
- Displays a list of all current promotions set up in BigCommerce as well as their details including:
- Name: The name given to the promotion in BigCommerce.
- Status: Whether the promotion is marked as enabled or disabled in BigCommerce.
- Redemption Type
- Max Uses: The number of maximum uses set in the default (non-unique) coupon code. Unique coupon codes can have alternate values for this field.
- Current Uses: The number of times the default (non-unique) coupon code has been used.
- Start Date
- End Date
- Allows you to export an Excel or CSV file of all bulk coupon code usage for a select date range.
- Displays a list of all current promotions set up in BigCommerce as well as their details including:
- History - a list of the last 7 days of processing history for this tool.
- Help - a link to this support document.
Additional Options for Premium Plan Subscribers
Scheduling a Tool to Run at a Later Day and Time
Premium subscribers have access to schedule tools to run in advance. This option will be displayed after you set your notification type.
By default, the scheduling option is set to No. If you do not want to schedule the tool, click Submit.
If you want to schedule the tool to run at a later time, click Yes.
From here you can select to schedule the tool to run at a specific date and time:
The scheduled start time is the time the tool will run, not complete.
Once you set the day and time for the tool to run, click Submit.
Scheduling a Tool to Run on a Recurring Schedule
Premium subscribers have access to schedule tools to run in advance. This option will be displayed after you set your notification type.
By default, the scheduling option is set to No. If you do not want to schedule the tool, click Submit.
If you want to schedule the tool to run at a later time, click Yes.
From here you can select to run the tool on a recurring basis:
Options for recurring jobs include:
- Schedule Start Date and Time: The day and time the first instance will run.
- Repeat: The recurring schedule for this tool, which can be:
- Daily
- Weekly
- Monthly
- Specify Hour: The hour of the day the tool will run.
- Times are based on the time zone set up in your Company Profile.
- Recurring runs can only be schedule at the top of the hour.
- Ends: When the recurring job should stop. Options include:
- Never
- After a set number of runs have completed
- On a specific date and time
The scheduled start time is the time the tool will run, not complete.
Once your recurring options are set, click Submit.
Scheduling the Update Guest Order Tool to Automatically Check Historical Orders
In addition to the regular scheduling option available on all tools with the premium plan, the Update Guest Order tool allows store owners an additional scheduling option for checking historical orders on a regular, recurring basis.
This additional schedule, allows you to do the following:
- Schedule a daily run to check and associate orders from the previous day.
- Schedule a weekly run to check and associate orders from the previous day, week, two weeks, or three weeks.
- Schedule a monthly run to check and associate orders from the previous day, week, two weeks, three weeks, month, two months, or three months.
In order to use this method for scheduling, you must set the schedule by going to the tool's tile in the Your Store Tools dashboard and select Create Schedule from the stacked menu:
From there you can schedule the tool to run on a daily, weekly, or monthly basis.
Frequently Asked Questions
How many coupons can I create at a time?
The Bulk Coupon Creator will allow you to create up to 500,000 coupons at once using the wizard.
If I’m generating 5,000 codes for a promotion that already has 5,000 codes, is there a chance the tool will create duplicate coupon codes?
No. During the coupon creation process, we run a check of existing coupon codes in the promotion to ensure that no duplicates are created.
Why can’t I view the coupon codes in my store?
When coupons are created in bulk, the latest version of BigCommerce Promotions does not allow you to view individual coupon codes in the store.
Can I delete coupon codes?
Unfortunately, once a unique, bulk coupon code is created, there is no way to delete it. This is due to two factors:
- BigCommerce does not allow bulk coupons to be viewed, edited, or deleted within the store's control panel.
- Our Bulk Coupon Creator does not allow the option to delete a single or multiple coupon codes to be deleted due to the number of API calls that would be required to locate and delete individual codes.
How long does it take to create a bunch of bulk coupons?
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.
Can I use the same coupon codes in more than one promotion?
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.
I tried to create 300,000 coupons, but only 299,990 were created. Why?
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 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.
Why did it take a few minutes for my export file to be generated?
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.
What characters are supported for coupon codes?
BigCommerce restricts coupon codes to only contain the following characters:
- a-z
- A-Z
- 0-9
- Underscore and hyphen ( _ and - )
This applies to the prefix, code, delimiters, and suffix whether created via the wizard or uploaded via a CSV file.
I created a promotion but it's not showing up in the list of promotions, why?
If you created a promotion within BigCommerce and it's not showing up in the drop-down list of promotions in Bulk Coupon Creator, you need to clear the BigCommerce API cache.
To do this, simply click on the clear cache button at the top of the screen:
Once this is done, your promotion should appear in the drop down list.
Did you find an error or need additional support? Contact us at support@yourstorewizards.com to let us know!