---
title: "Voucher Setup"
slug: "setup-voucher-manager"
updated: 2025-12-19T09:31:40Z
published: 2025-12-19T09:31:40Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Voucher Setup

This page gives you a **high-level overview** of how to import, manage, and use vouchers in Mapp Engage. It outlines the basic steps and concepts. For detailed guidance on specific tasks, please refer to the How-To guides in this section.

---

## 1. Where do vouchers come from?

Voucher codes are typically generated in **external systems**, such as:

- your **online shop**
- a **CRM**
- or through manual generation

The codes are uploaded into Mapp Engage using a **coupon list**.

**Watch: How to create, assign, and track vouchers in Mapp Engage**

[Coupons & Barcodes - Coupons 1 - Sandra](https://player.vimeo.com/video/1040084223?badge=0&autopause=0&player_id=0&app_id=58479)

---

## 2. What types of vouchers are supported?

There are two types of vouchers in Mapp Engage:

- **Coupons**

Alphanumeric codes, like XMAS20 or unique generated tokens.

Used for online redemptions.
- **Barcodes**

Scannable images generated from codes.

Used in offline/retail settings.

---

## 3. How voucher assignment works

During message sendout:

- A **placeholder** is inserted into the message
- Engage replaces the placeholder with a **unique code**
- If the placeholder appears multiple times, the same code is shown
- If not enough codes are available, you can:
  - Show **alternative text**
  - Or **pause** the sendout

---

## 4. Setup steps

### A. Create a coupon list

- Prepare your codes (TXT or CSV) and create a new list under *Content > Voucher Manager > Coupons*

### B. Import your codes

- Upload the file via the list’s import option.
- Choose format, encoding, and separator as needed.

### C. Generate barcodes (optional)

- Create barcodes under *Content > Voucher Manager > Barcodes*
- You can generate barcodes based on different data sources, depending on your use case.
  - **Coupon list:** Use this option if each recipient should receive a unique, trackable value.
  - **Custom attribute:** Use this option if the barcode should represent an existing identifier, such as a membership or customer ID stored in the contact profile.
  - **Manual input:**Use this option if the same barcode value should be used for all recipients, for example for a general in-store promotion.
- Once created, the barcodes are stored and can be reused across messages.
- Use Engage Variables or Content Elements to insert the barcode into your message.

### D. Add voucher to a message

- Use the **Engage Variable** to insert a coupon or barcode.
- Barcodes can also be added as content elements.

---

## 5. Required permissions

To use the Voucher Manager, the following permissions may be required – depending on the features you use.

| **Area** | **Permission** | **Description** |
| --- | --- | --- |
| **Coupons** | 157 – Edit own coupons | Create and manage your own coupon lists |
| 158 – View all coupons | View all coupon lists on the system |
| 159 – Edit all coupons | Edit all coupon lists (needs 158 to view others) |
| **Barcodes** | 170 – Edit own barcodes | Create and manage your own barcodes |
| 171 – View all barcodes | View all barcodes on the system |
| 172 – Edit all barcodes | Edit all barcodes (needs 171 to view others) |
| **Exports** | 162 – Export coupon list | Generate and schedule coupon exports |
| **Automations** | 353 – Edit own automations | Use automations with your own objects |
| 355 – Edit all automations | Full access to all automations |

---

## 6. After sendout

Vouchers are:

- **Inserted individually** per recipient
- **Tracked**, if redemption info is available (e.g. via CRM/shop)
- **Exportable**, for follow-up actions or reporting

Redemption data can be used for:

- Segmentation (e.g., who redeemed)
- Follow-up campaigns
- ROI analysis