> For the complete documentation index, see [llms.txt](https://docs.giftcardfactory.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.giftcardfactory.app/reports/bulk-operation-discount-code-usage.md).

# Bulk Operation Discount Code Usage

See which discount codes from a bulk operation were used

The Bulk Operation Discount Code Usage Report lists every discount code a bulk operation created, and for each code how many times it was used and on which orders. Use it to see how many customers redeemed the codes from a campaign, such as a Black Friday send.

### Overview

The report writes **one row per code**, whether it was used or not. Codes that haven't been used yet show **0** in **Times used**, so filtering on that column tells you at a glance how many of the codes were redeemed (for example, 15 of 906).

Usage comes from your Shopify orders: an order counts when the code was applied to it at checkout. Each report reflects usage up to the moment it runs.

### Requirements

* A finished discount code bulk operation: [Bulk Create](https://docs.giftcardfactory.app/bulk-operations/discount-codes-bulk-create.md), [Bulk Send](https://docs.giftcardfactory.app/bulk-operations/discount-codes-bulk-send.md) or [Import From File](https://docs.giftcardfactory.app/bulk-operations/discount-codes-import-from-file.md)
* The bulk operation must have been created **on or after November 11, 2026**, when code tracking for this report was enabled

### Creating a Report

You can start the report in two ways:

* From **Reports**: click **New Report** and select **Bulk Operation Discount Code Usage**
* From a finished discount code bulk operation: open it and click **Discount code usage report**. The operation is preselected.

Then:

1. Choose the **Bulk operation** from the dropdown. It shows the operation number and type; after selecting one you'll see how many discount codes it created.
2. Optionally check **Send an email with report results** and enter one or more addresses, separated by commas
3. Click **Create report** to generate the report now, or **Schedule** to run it at a future date and time you select, once or repeating on a daily, weekly, monthly or yearly interval

A repeating schedule is a simple way to follow a campaign: a weekly run sends you the latest usage of the same codes every week. Each upcoming run appears on the Reports page with a **Scheduled** badge; select it there to edit the schedule or cancel it to stop the recurrence.

### Report Contents

The generated CSV file includes the following columns:

| Column                | Description                                                                                    |
| --------------------- | ---------------------------------------------------------------------------------------------- |
| Discount code         | The code customers enter at checkout                                                           |
| Discount ID           | Shopify discount ID                                                                            |
| Recipient email       | Who the code was sent to (Bulk Send, or Import From File with an email); empty for Bulk Create |
| Times used            | Number of orders that used the code                                                            |
| Order numbers         | Orders that used the code (e.g., #1001, #1005)                                                 |
| Customer emails       | Emails of the customers who placed those orders                                                |
| Order total discounts | Total discounts on those orders. Includes any other discounts applied to the same orders       |
| First used at         | When the first order with the code was placed                                                  |
| Last used at          | When the most recent order with the code was placed                                            |

### Downloading Results

After the report finishes, click the **Result** link next to it on the Reports page. Download links expire after 72 hours; after that, run the report again if you still need the data.

### Use Cases

* **Campaign results**: see how many of the codes you sent were redeemed
* **Customer follow-up**: find recipients who haven't used their code yet (**Times used** is 0) and send them a reminder
* **Recipient vs. buyer**: compare **Recipient email** with **Customer emails** to spot codes that were shared with other people

### Frequently Asked Questions

#### Why don't I see my bulk operation in the dropdown?

Your bulk operation may not appear if:

* It was created before November 11, 2026
* It hasn't finished yet (stopped and limit-paused operations aren't listed)
* It isn't a discount code operation. For gift card operations use the [Bulk Operation Gift Card Usage](https://docs.giftcardfactory.app/reports/bulk-operation-gift-card-usage.md) report

#### Why does a code show as used more than once?

A code can be used on several orders if its usage limits allow it. Each order is listed in **Order numbers**.

#### Are refunded or cancelled orders counted?

Yes. The report counts every order the code was applied to, including orders that were later refunded or cancelled.

#### What subscription plan do I need to generate the report?

All reports can be generated without a paid subscription.

### Related Features

* [Discount Codes Usage](https://docs.giftcardfactory.app/reports/discount-codes-usage.md) — every order that used any discount code in a period
* [Bulk Operation Gift Card Usage](https://docs.giftcardfactory.app/reports/bulk-operation-gift-card-usage.md) — the same view for gift cards created by a bulk operation

### Need Help?

If you have questions about this report, contact our support team at <support@code57.pl>.
