Skip to content

Import Promo Codes

If you don't want to create promo codes individually, but instead create bulk promo codes in the system, you can use the import function. When importing a promo code, you need to upload a CSV file with all the necessary information. Each line of this CSV file will then be generated as a promo code.

Once you upload the file in the system, the field names of your CSV file must be associated with the field names of our system. If you name the fields of the CSV file directly in the same wording, the fields will even be linked automatically.

To start a promo code import, select the Discounts and Promo Codes module. Then click on the Import option in the upper right, and select the CSV file you want to import. After that, more settings options will display. Here you have to link the field names as described above.

You can find a sample import file here. Visual step by step guide

Import File

The following variables can be stored in the CSV file. We also explain the meaning of the field as well as the possible contents. More information about the variables can be found in the promo code creation.

The file must meet the following requirements:

  1. File format: CSV (semi-colon delineated)

  2. File size: Any

  3. Column names: Best case, the columns of the CSV should have the exact name of the internal fields they will be linked to during import. This is because they will be directly linked when the file is selected, so they do not have to be selected individually.

  4. Structure: one line must correspond to a single promo code.

  5. Mandatory fields:

    1. Name

Note: Only the name is mandatory. All other fields can be left blank if necessary. The fields correspond to the fields which can be filled in the manual promo code creation.

Promo Code import file

Expand all

active

Expand all

Import Process

To perform a promo code import, select the Import button via the Discounts and Promo Codes module. Alternatively, the ticket import can also be triggered via the same process in the Jobs module.

Perform the following steps for the import:

  1. Click the Import button via the Promo Codes module. A new window will open.

  2. Select the Select button to upload the import file. After that, more settings will pop up.

  3. Connect the fields of your CSV file with the internal fields. If the fields of your CSV are already named with the same wording, the mapping will be done automatically.

  4. Click Import to start the import. You will be automatically redirected to the Jobs module.

Screenshot 2025-07-23 at 1.54.15 PM

In the Jobs module you have the possibility to download a file of the successful imports. If there are any records that could not be imported successfully, you can also download a file with all failed records.

Import Errors

After performing an import, you will be automatically redirected to the Jobs module. There you have the possibility to download all successful and all failed records. You can access the Jobs module later by clicking on your vivenu account name in the lower-left corner of the dashboard. Failed records are those promo codes that could not be imported for certain reasons. In the right column of each failed record file, you will find the so-called Error reason.

For the sake of better readability, the simultaneous use of the language forms male, female and diverse (m/f/d) is waived. All personal designations apply equally to all genders.