Voucher usage

Report of voucher/code usage, times used and total discount given with CSV export guidance.

This page documents the Voucher Usage report — see how often voucher codes are redeemed and the total discount value they generated.

At a glance

Purpose: show voucher/code performance over a selected date range so you can measure promotion effectiveness and spot misuse.
Primary view: a table listing voucher codes, counts and total discount amount.
Controls: right-hand date selector and the Download CSV action.

The main view is a table of voucher codes and usage statistics. Typical columns shown:

id — internal identifier for the voucher record (if available).
code — the voucher or promotion code used.
times_used — how many times the code was redeemed in the selected range.
total_discount — total monetary value discounted by this code in the selected range (currency shown in store settings).

Use the Download CSV action (top-right) to export the current table. The CSV uses snake_case column names. A minimal example row:

id,code,times_used,total_discount
123,WINTER10,42,210.00

This export helps with reconciliation, claim validation and marketing analysis.

Date selector (right-hand panel): choose the period to analyse ( custom range).
Search / code filter: narrow to a specific code or partial match to inspect usage.

High times_used and high total_discount: the promotion drove volume but at a cost — check margin impact.
High times_used with low average discount: many small redemptions — consider bundling promotions to increase AOV.
Low times_used but high total_discount: a few heavy redemptions (e.g., free-gift or large fixed-value vouchers) — check eligibility rules.

Open the Voucher Usage report and set the date range you want to inspect using the right-hand selector.

Use the search or code filter to focus on a specific voucher if you want to inspect a single campaign.

Look at times_used and total_discount to understand redemption volume and cost.

Click Download → CSV to export the rows and reconcile with finance or campaign reports.

Currency: totals are reported in the store currency; check store settings if numbers look unexpected.
Refunds & cancellations: exported totals reflect applied discounts on orders; refunds or cancelled orders may require separate reconciliation.