> 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/discount-codes-usage.md).

# Discount Codes Usage

See which orders used discount codes

The Discount Codes Usage Report lists the orders in your store that used a discount code during a period you choose. Each row shows the order, the customer and the code they used, so you can see which codes drive sales.

### Overview

The report looks at orders created in the selected dates and writes one row for every discount code applied to them. An order with two codes produces two rows.

All discount codes are included, no matter how they were created: by Gift Card Factory (bulk create, bulk send, imports), by you in the Shopify admin, or by another app. Manual discounts added to draft orders are listed with the code **Custom discount**, the way Shopify records them.

To see usage of the codes from one bulk operation, including the codes nobody has used yet, use the [Bulk Operation Discount Code Usage](https://docs.giftcardfactory.app/reports/bulk-operation-discount-code-usage.md) report instead.

### When to Use This Report

* **Promotion results**: see which codes customers used and on which orders
* **Daily or weekly trends**: group the rows by **Order date** in a spreadsheet to see redemptions per day
* **Financial reconciliation**: match discounts given against your orders and revenue
* **Customer insight**: find the customers who shop with discount codes

### Creating a Report

1. Navigate to **Reports** in the Gift Card Factory app
2. Click the **New Report** button
3. Select **All Discount Codes Usage** from the report options
4. Choose the **Date range**: pick one of the preset ranges or set a **Start date** and **End date**. Orders created on both dates, and every day between them, are included.
5. Optionally check **Send an email with report results** and enter the destination address
6. 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

For repeating schedules the date range moves forward with each run, so every report covers the most recent period; a weekly schedule, for example, sends you each week's discounted orders. 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                                                          |
| --------------------- | -------------------------------------------------------------------- |
| Order number          | Order reference (e.g., #1001)                                        |
| Order ID              | Shopify order ID                                                     |
| Order date            | When the order was placed                                            |
| Customer email        | Email of the customer who placed the order                           |
| Customer name         | Name of the customer who placed the order                            |
| Discount code         | The code applied to the order                                        |
| Order subtotal        | Current subtotal of the order                                        |
| Order total discounts | All discounts on the order, including other codes and automatic ones |
| Order total           | Current total of the order                                           |
| Currency              | Currency of the order amounts                                        |

### 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.

### Tips

* Start with a short date range if your store has a high order volume, to see how long the report takes.
* Use the email option for repeating schedules, so each period's report arrives in your inbox.
* **Order total discounts** covers the whole order. When an order has more than one code, both rows show the same amount, so don't add it up across rows of the same order.

### Related Features

* [Bulk Operation Discount Code Usage](https://docs.giftcardfactory.app/reports/bulk-operation-discount-code-usage.md) — usage of every code created by one bulk operation
* [Gift Cards Usage](https://docs.giftcardfactory.app/reports/gift-cards-usage.md) — the same view for orders paid with gift cards
* [Discount Codes Bulk Send](https://docs.giftcardfactory.app/bulk-operations/discount-codes-bulk-send.md) — create and send unique codes to many customers
