Batch statuses explained
Each batch of discount codes in Discount Magic has a status that shows whether its codes have been created in Shopify or the batch needs your attention.
Last updated 6 days ago
In Discount Magic, each batch of discount codes shows a status badge that tells you whether its codes have been created in Shopify. If a batch stops early, you can retry or cancel it.
Which plans include batch statuses
Batch statuses
A batch moves through the statuses below in roughly the order shown. Most need no action from you.
Before it starts: Draft
While it's being created: Pending, Generating codes…, Creating codes…, Syncing results…, Retrying…
When it has finished or stopped: Active, Partially active, Stalled, Failed, Cancelled
Draft
The batch has been designed but its codes haven't been generated yet. Nothing exists in Shopify.
To generate the codes, go to Discounts in Discount Magic, click the discount's title and click Finish setup.
While a batch is being created
A batch moves through these statuses in order: Pending → Generating codes… → Creating codes… → Syncing results… → Active.
Pending
The batch is in a queue. Batches for the same discount are created one at a time, so it starts automatically as soon as the batch ahead of it finishes.
No action needed. The status changes to Generating codes… or Creating codes… when the batch starts.
Generating codes…
Discount Magic is preparing the codes before it sends them to Shopify. The batch shows Preparing codes… under its progress bar. This usually takes under a minute, even for a large batch.
No action needed. The status changes to Creating codes… when the codes are ready to send.
Creating codes…
Shopify is creating the codes, in groups of up to 250. The progress bar and the time remaining update as Shopify works through the groups. Codes that have been created already work at checkout, as long as the discount's settings allow it.
No action needed, and you can leave the page. The status changes to Syncing results… when Shopify has finished.
Syncing results…
The last step. Discount Magic checks which codes Shopify created and records the result.
No action needed. The status changes to Active when every code was created, or Partially active when some weren't.
Retrying…
A retry is creating the codes that are still missing.
No action needed. The status changes to Active when the missing codes have been created.
When a batch has finished or stopped
Active
Every code has been created in Shopify and works at checkout, as long as the discount itself is active.
The codes are ready to share or export.
Partially active
Most codes were created and work at checkout, but Shopify didn't create some of them. For example, Shopify rejects a code that already exists in your store.
To create the missing codes, see which codes failed and why, then retry the batch.
Stalled
Code creation stopped before it finished and isn't running any more. For example, the background service that creates codes was interrupted and couldn't pick the batch up again. The codes already created are active in Shopify. The rest haven't been created.
To create the rest, retry the batch.
Failed
An error stopped the batch. For example, it couldn't start, or Shopify returned an error partway through. Any codes created before the error are active in Shopify.
To create the missing codes, see which codes were created, then retry the batch.
Cancelled
You stopped the batch with Cancel batch while it was being created. Codes created before then are active in Shopify.
If you don't want those codes, delete the batch.
How to see which codes were created and which failed
When a batch is Partially active, Stalled or Failed, the batch's list of codes shows exactly which codes exist:
In Discount Magic, go to Discounts and click the discount's title. In the Discount code batches section, click the batch to see its codes.
The batch's details show how many codes failed, such as 12 codes failed.
In the list of codes, use the Status filter to show only Active, Creating, Failed or Skipped codes.
Hover over a code's Failed badge to see why that code wasn't created.
Active codes work at checkout. Failed and Creating codes don't exist in Shopify yet, and a retry tries to create them. A Skipped code already existed in Shopify, so it wasn't created again as part of this batch.
How to retry a batch
You can retry a batch that is Stalled, Failed or Partially active. In Discount Magic, go to Discounts and click the discount's title. In the Discount code batches section, right-click the batch and choose Retry batch.
A retry creates only the codes that weren't created the first time. Codes that already exist are left as they are, so retrying doesn't create duplicates.
How to cancel a batch
While a batch is being created, go to Discounts in Discount Magic and click the discount's title. In the Discount code batches section, right-click the batch and choose Cancel batch. Codes that Shopify had already created stay active and keep working at checkout.
A batch with the Cancelled status can't be retried, and you can't add codes to it. To remove the codes it did create, delete the batch.
Deleting a batch deletes its codes, so any that were already shared with customers stop working. This can't be undone.
Frequently asked questions
Why is my batch pending?
In Discount Magic, batches for the same discount are created one at a time. A pending batch starts automatically when the batches ahead of it finish.
What does a stalled batch mean?
A stalled batch stopped before all of its codes were created. The codes already created work at checkout. Click Retry batch to create the rest.
Will retrying a batch create duplicate codes?
No. In Discount Magic, a retry creates only the codes that are still missing.
Do codes work while a batch is still being created?
Yes. Each code works at checkout as soon as Shopify has created it, as long as the discount's settings allow it. For example, the discount must be active and past its start date.
Related articles
Was this helpful?
More in Discount batches
Discount code batchesWays to use unique discount codesAdding more codes to a batchAuto-replenishStill need help? Ask the team