Import Badges into Virtual Appliance

Last Updated: April 07, 2026

When you store badge information in the Virtual Appliance database, you can bulk import badge attributes using a CSV file.

Create a CSV File

Note the following about the CSV file:

  • The file must contain at least two columns: Badge User Name and Badge ID.
  • Select the example file link on the modal to download a template.
  • The maximum number of entries per file is 1,000.

Manually create a CSV file with the Badge User Name and Badge ID headers, or do the following:

  1. Go to Tools then Badge Management to access the Badge Management page.
  2. Select Import.
  3. In the Import Badges from CSV modal, select the link to download the template.

  4. Add the badge usernames and badge IDs. Values in the Badge User Name column must be in one of the following formats:

    1. Lightweight Directory Access Protocol (LDAP): Use "domain\username." For example printerlogic\first.last.

    2. IdP: Follow your IdP's format.

    CSV showing LDAP format for badge usernames.

Bulk Import Badges

Follow these steps:

  1. Select Import.
  2. In the Import Badges from CSV modal, select Choose File, and select the CSV file.
  3. Select Import.

After the upload completes, the modal shows a message confirming the following:

  • The number of records that successfully imported.
  • The number of records that failed to import.

You can download the CSV file that contains the error details so that you can correct any issues and import again.

Admin Console showing "Import Badges from CSV" modal with import results.

Admin Console showing "Import Badges from CSV" modal.

The Badge Management page shows a list of registered badges.

Admin Console showing Badge Management page and registered badges.

Troubleshooting Help