Import Badges - CSV

PrinterLogic lets you import user badge attributes in bulk from a CSV file. The format of the CSV file requires two columns. Badge User Name and Badge ID. You can download a template from the import screen to assist you with this process.

Manually registering badges via the Badge Management tab or importing badges using a CSV is currently not supported for cloud-based IdPs such as Entra ID (Azure AD), Okta, etc.

Importing badge information using this process only enters the data into the PrinterLogic database. The data is not imported into any other source of truth such as Active Directory.

Create CSV File

Create a CSV file containing two columns:

  • Badge User Name
  • Badge ID

  • The names entered into the Badge User Name column must be in one of the following formats:

    For LDAP— domain \ username; for example, printerlogic\first.last

    CSV file view with the Badge Username and Badge ID columns with three LDAP users added in the columns.

Import Badge Attributes

  1. In the Admin Console, navigate to Tools then Badge Management
  2. Click on Import.

  3. Click on Choose File and browse to the created CSV file.

    • You can download an example CSV template by clicking on Example File in the Import screen.Import Badges from CSV pop-up with an arrow pointing to the link to download the example file template.

  4. Click on Import.
  5. The import displays an X Badges Successfully Imported and any errors.

    • If there are errors with users/badges in the CSV.

      1. Click "badge-import-errors.csv" to download the CSV file.

        Import Badges from CSV pop-up showing an error message with an arrow pointing to the link to download the error file.

      2. Adjust the original CSV fields to match the domain\username and badge ID exactly.
      3. Upload the CSV with the adjusted users/badges.

      Commonly seen errors:

      • Badge ID Already In Use.
        • If the existing user information for that badge is incorrect, unregister the existing badge.
      • User does not exist.
        • Verify the user is within Active Directory.
      • Invalid user identifier.
        • Check if there are additional backslashes or characters added between the domain and username.
  6. Click Close.

Admin Console Badge Management tab showing the steps starting with the Import button, selecting the csv file, and displaying a Successfully imported badges message.

The imported Badge User Names and Badge IDs are displayed in the Badge Management page.

Reference the Badge Management Tab for more information.