On the Coupons page, you can see all the coupons created in your store, manage their details and analyze how many times and in which orders they were used.

On this page, you can:

• Search for coupons.
• Export coupons.
• View coupon usage details.
• Filter coupons.
• See the list of active coupons.
• Access the list of archived coupons.
• Create coupons.
• Edit coupons.
• Archive coupons.

To access this page in the VTEX Admin, click Promotions > Coupons.

Below you will find a description of the page components and the actions you can perform.

The top bar of the Coupons page contains a search field as well as filters and buttons for exporting coupons, consulting coupon usage details and accessing the archived coupon list. Learn more about each of these possibilities in the sections below.

To find a specific coupon, use the search field. You can search by coupon code, by UTM source or by UTM campaign.

Use the filters to view only coupons corresponding to certain criteria. To apply filters, follow the steps below.

1. In the VTEX Admin, go to Promotions > Coupons, or type Coupons in the search bar at the top of the page.
2. Select the filter you want to use:
   • Last modified: Indicates the last time a coupon was modified.
   • Coupon type: Indicates if it is a single coupon or a coupon batch. For a better understanding of different coupon types, please read Coupons.
3. Check the desired option.
4. Click Apply.
5. Repeat the process if you want to apply a different filter.

To clear the filters, i.e., to remove the applied filters, you have two options:

• Click next to the filter you want to remove.
• Click Clear all filters to remove all applied filters.

You can download all your coupons and their details in a CSV file.

To export the coupons, click the button Export next to the search field. The exported list will reflect the applied filters.

The generated file contains the information described below.

Column	Description
code	Coupon code. For a coupon batch, the generated code prefix is indicated.
type	Indicates whether it is a single coupon or a coupon batch. For more information on each coupon type, please refer to Coupons. To learn how to export the codes generated in a coupon batch, please read Exporting coupon batch codes.
quantity	The number of coupon codes. For single coupons, the value is always 1. For coupon batches, the number of codes for a specific coupon batch is indicated.
archived	Indicates if the coupon is archived (true) or active (false).
utmSource	Indicates the UTM source linked to the coupon, if any.
utmCampaign	Indicates the UTM campaign linked to the coupon, if any.
maxUsage	The maximum number of times the coupon can be used.
maxItemsPerClient	Determines the maximum number of products to which the coupon can be applied. The defined quantity is valid for one or more purchases made by the same customer. This option mentions a value only for already existing coupons, configured with this limitation in previous versions of the Coupons module.
expirationIntervalPerUse	The minimum period of time before a coupon can be reused.
lastModified	The date the coupon was last modified.

Here is an example of an exported CSV file:

Exporting coupon batch codes

The exported CSV file displays one row for a coupon batch, which means it doesn't show all the codes within the coupon batch, only its prefix.

To view or export all the codes within a coupon batch, you must follow the steps below:

1. Find the coupon batch in the coupon list.

2. Click on the coupon batch row for more options.

3. Click Export.

   Two options will appear on the screen:

   • Copy all: Allows you to copy the generated codes to your clipboard. You can also copy each code individually by clicking it.
   • Export: Allows exporting the generated coupons to a CSV file. The exported file contains a single column, with one code per row.

To view the total number of active coupons and the remaining available space for new coupons, click Coupon usage.

You are allowed a maximum of five thousand active coupons. To free up space, you can archive coupons in the Coupon list. If you need to increase the limit of active coupons, please contact our Support team.

To access the archived coupon list, follow the steps below:

1. In the top right corner of the Coupons page, click More.
2. Click Archived coupons.

The archived coupon list presents the same information described in the Coupon list, except for the options available in the menu of each coupon row. The available options for archived coupons are:

• View: Allows viewing the details of an archived coupon in a non-editable version of the create and edit coupon form.
• Unarchive: Allows accessing a coupon for usage and editing.

The Create coupon button in the top right corner of the page allows you to access the form for creating a coupon. For more information on this procedure, please read Creating a cupon.

The coupon list presents all the active coupons in your store, starting with the most recent one. By clicking on a coupon from the list, you will be redirected to the edit coupon page.

See below for more details on each column of the list:

• Code: Displays the coupon code.
• Coupon type: Indicates if it is a single coupon or a coupon batch.
• UTM source: Indicates the UTM source linked to the coupon, if any.
• UTM campaign: Indicates the UTM campaign linked to the coupon, if any.
• Last edit: Displays the date the coupon was last modified.
• Button : Displays a menu with several options, as described below:
  • Edit: Allows accessing the form for editing coupons to view or modify their details. Please read Creating a coupon for more details on the form. Option available only for active coupons.
  • Archive: Allows archiving the coupon, i.e., deactivate it from being used in the store. Option available only for active coupons.
  • Export: Opens a modal containing coupon batch codes. You can copy them or export them to a CSV file. Option available only for coupon batches.
  • View usage details: Opens a modal containing coupon usage information. For more details, please read the View usage details section. Option available only for active coupons.

The View usage details modal presents information on how each coupon was used, as described below:

• Linked promotions: Displays the name of the promotion associated with the coupon, if any. By clicking on the promotion name, you will be redirected to the promotion editing page.

  The coupon becomes valid when associated with at least one promotion. To associate it, you must use the same utm_source or utm_campaign both in the coupon and the promotion fields. Please read Associating a coupon with a promotion to learn more about this configuration.

• Usage (single coupons): Displays the number of times the coupon can be used and the number of remaining uses, if you have set a usage limit.

  This section presents the list of orders in which a coupon has been used and allows you to search by order number. When you click on the order number, you will be redirected to the order details page in Orders management.

• General usage of the coupon codes (coupon batches): Displays the total amount of times of the codes in a coupon batch have been used and the amount of remaining uses, if you have set a usage limit.

  This section also displays the list of codes in the coupon batch and allows you to search for a specific code. When you click on a code, you have access to the list of orders where the code has been used and you can search by an order number. Clicking on an order number will take you to the order details page in Orders management.

• Coupons
• Creating a coupon