Create and Manage Voucher Lists

Learn how to efficiently manage your voucher lists, track their status, and ensure seamless distribution.

Overview

View and manage all your voucher lists in one place. The Voucher Lists page provides key details about each list, helping you track their status, usage, and associated campaigns.

Access Voucher List

To access the Voucher Lists page, perform these steps:

  1. Go to Promotions from the CleverTap dashboard.
  2. Click Rewards and select Partner Vouchers from the dropdown menu.
Voucher Lists

Voucher Lists

The Voucher Lists page provides a comprehensive overview of all voucher lists with the following columns:

Column NameDescription
List IDA unique identifier for each voucher list. Click the ID to view detailed information about the list.
PartnerDisplays the name of the voucher provider associated with the list.
List TagA unique identifier for the voucher list is used along with the Partner Name to generate a distinct List ID.
Updated OnThe date and time of the most recent modification.
Status

Indicates the current state of the voucher list. The following are the statuses:

  • Active
  • Expired
  • Paused
  • Archived
For more information, refer to Voucher List Status and Actions.
Linked Promo CampaignsThe number of campaigns using this voucher list.
Codes UploadedThe total number of voucher codes uploaded.
Codes DistributedThe number of voucher codes issued to users.

Voucher List Status and Actions

The status of a voucher list determines its availability and the actions you can take. Properly managing lists ensures seamless voucher distribution in promotional campaigns.

The table below outlines each voucher list status, its description, and the actions you can perform:

StatusDescriptionAvailable Actions
ActiveVoucher list is available for use in promotional campaigns.Pause, Edit, Upload codes, Archive
PausedVoucher list is temporarily inactive; campaigns cannot use codes.Activate, Edit, Upload codes, Archive
ExpiredVoucher list has passed its expiration date and cannot be used.Edit, Archive
ArchivedThe voucher list is permanently deactivated and retained for record-keeping.No further actions allowed

Voucher List Actions

To perform any action on the voucher list, click the icon next to the list. The available actions depend on the current status of the list.

ActionEffect
PauseTemporarily deactivates an active voucher list, making it unavailable for campaigns.
Upload codesAdds new voucher codes to the existing list, ensuring continued distribution.
EditAllows modifications to the list name, description, and expiry date.
ActivateReactivates a paused voucher list, making it available for use again.
ArchivePermanently disables a voucher list, preventing any further modifications or usage.

Upload New Vouchers

Before uploading new voucher codes, you must create a voucher list in CleverTap. Once created, you can upload codes to distribute them through campaigns. To upload new voucher codes, follow these steps:

  1. Go to Promotions from the CleverTap dashboard.
  2. Click Rewards and select Partner Vouchers from the dropdown.
  3. Click New Voucher List in the top-right corner.
  4. Enter the following details:
FieldDescription
PartnerEnter the name of the voucher provider. For example, Puma. The partner name helps categorize and track voucher sources. If the Partner is not listed, click Add Partner to create a new entry. The system enforces case sensitivity and prevents duplicate partner names. For example, clevertap and CLEVERTAP are considered separate partners in Promo.
List tagDefine a short, unique identifier for the codes. For example, holi2025campaign. The List tag uniquely identifies the uploaded voucher list within CleverTap. It must be unique for each Partner. The system automatically converts the value to lowercase. Special characters are permitted, but spaces are not.
List nameThis is the name of the voucher list used for communication campaigns. For example, Holi 2025 Sale. It does not describe individual voucher codes but serves as an identifier for the list.
List descriptionThis field defines the usage conditions of the voucher codes uploaded in a voucher list. For example, Offer is applicable on orders above $100.
FilesUpload a CSV file with voucher codes. The maximum file size must not exceed 50MB. Add voucher codes in a single column without comma-separated values. If multiple columns are added, the system rejects the file.
ExpirySet up an expiration date for the voucher list. Once the date expires, CleverTap stops distributing vouchers from this list. However, you can extend the expiration date if needed.
  1. Click Create.
Create Voucher List

Setup Voucher List

View Upload History

Once a voucher file is uploaded, the system processes and validates the codes and records the upload logs against each voucher list. The Upload tab logs details of uploaded voucher files, helping you track and manage the upload process.

To view the upload history of a voucher file, click the List ID of the desired voucher list, then select the Uploads tab.

View Uploads

View Uploads

Each entry has the following fields:

Column NameDescription
TimestampThe date and time when the voucher file was uploaded.
Status

Indicates the current state of the upload process. The possible statuses are:

  • Completed: The upload was successful, and all valid voucher codes have been processed.
  • In Progress: The system is still processing the uploaded file.
  • Failed: The upload encountered errors, and no codes were processed.
Uploaded ByDisplays the email ID of the user who uploaded the voucher file.
File NameDisplays the name of the uploaded file.
Codes (Uploaded/Total)Displays the number of voucher codes successfully uploaded compared to the total codes in the file.
ErrorsDisplays issues found during upload, such as duplicate codes or an invalid file format. It also indicates the total number of errors found in the uploaded file.

Issues found during upload, such as duplicate codes or an invalid file format. The total number of errors is also displayed.

You can download the uploaded voucher file from the Uploads page for reference or troubleshooting.

Download Uploaded Vouchers File

Download Uploaded Vouchers File

Upload Codes

If your voucher list is running low on codes, you can add more vouchers without creating a new list. This ensures seamless voucher distribution and prevents disruptions in your campaigns.

To upload additional voucher codes:

  • Use the Upload Codes option to add new vouchers to an existing list at any time.
  • The system automatically validates new codes to prevent duplicates within the same list.
  • Once uploaded, the newly added codes immediately become available for distribution.

πŸ“˜

Errors in Uploading Codes

If an error occurs during upload, for example, duplicate codes or invalid format, download the Error File from the Uploads tab. This file contains error codes and corresponding error messages. Correct the errors and re-upload the corrected file using the Upload codes flow against the same voucher list.

Best Practices

To ensure smooth voucher list management and avoid disruptions in campaigns, follow these best practices:

  • Upload Unique Voucher Codes: Ensure that all voucher codes in a list are unique to prevent duplication errors and maintain accuracy.
  • Monitor Status Regularly: Keep track of the voucher list status to ensure it remains active for ongoing campaigns.
  • Maintain Unique List Tag: Use meaningful and distinct identifiers for better organization and easy reference.
  • Keep Codes Updated: Regularly upload new voucher codes to prevent depletion and ensure continuous availability.