Skip to main content

Add Users in Bulk

With BioStar Air, administrators can add multiple users at once using a CSV file. This feature is useful for efficiently handling employee onboarding, site upgrades, or temporary access requirements.

Customers who began using BioStar Air access control before May 2025 may still be using the Airfob Space app, which has since been rebranded as the Suprema Pass app. Both apps offer identical functionality and are fully compatible. There is no need for existing users to switch — mobile credentials work seamlessly across both.

Tip

Refer to the following video for a step�by�step guide to adding multiple users in bulk.

Download the CSV template​

Follow these steps to download the CSV template file.

  1. Click User Management → Users in the left sidebar.

  2. Click Add User → Import User(s) at the top right of the screen.

  3. When the Import User(s) panel appears, click Download.

  4. Save the CSV template file (biostar-import-user-csv-example.csv) locally.

Prepare the CSV file​

Download the CSV template and enter the required details for each user.

Key input fields​

The key fields to enter are as follows.

  • Group IDs: Check the group ID in User Management → User Groups.

  • Access level IDs: Check the access level ID in Access Management → Access Levels. Full Access is always set to 1. Use commas (,) as separators to specify multiple access levels.

  • Email: Enter this if you plan to send invitations by email.

  • Mobile: Enter this if you plan to send invitations by mobile SMS.

Caution

Email and Mobile must not be duplicated. Uploading a CSV file with duplicate values may cause errors.

Support for custom Wiegand formats​

  • Freely configure any Wiegand format, including facility codes, segments, parity bits, and more.

  • HID Corporate 1000 and iCLASS SE and Seos formats are supported.

  • CSV template

    • Each defined format (custom or default) appears as a separate column in the CSV file.

      26 bit SIA Standard-H10301, HID 37 bit-H10302, HID 37 bit-H10304, HID Corporate 1000, HID Corporate 1000 48bit

    • Separate multiple entries in a single field with a slash (/).

    • Use single quotes (') around the card name. Avoid using double quotes ("); they may cause errors.

      ✅ 'CardName' | ❌ "CardName"

    Example

    • With a facility code: 1234567-100-'Main Office Card' (CardID-FacilityCode-'CardName')

    • With multiple segments: 12-3456-78-'Lab Entry Card'

Support for multiple cards​

  • Assign up to eight CSN or Wiegand card formats per user.

  • CSV template

    • For a single card, enter the CSN card number.

    • Separate CSN card numbers with a slash (/) when enrolling multiple cards.

Card naming format: CSN-'Card Name'

Example: 1234567-'Main Entry' / 7654321-'Back Door'

Upload the CSV file​

After preparing the CSV file, upload it.

  1. Click User Management → Users in the left sidebar.

  2. Click Add User → Import User(s) at the top right of the screen.

  3. When the Import User(s) panel appears, click Select File.

  4. Select the CSV file you prepared.

    If the users' profile images are ready, enable the Upload Face Photo option. For more information on uploading profile images, refer to the following.

  5. Click Next.

  6. In the Data Preview section, review the accuracy of the data in the first column.

  7. If there are no issues, click Import in the bottom right corner.

After the upload completes, you can import user images or issue mobile cards in bulk on the next screen. Select the desired action.

Info

  • Do not use special characters other than commas (,) in the CSV file name.

  • The maximum CSV file size is 5MB.

  • Alternatively, drag and drop the CSV file into the Upload CSV field of the Import User(s) panel.

Validate CSV import​

The CSV upload process now provides row-level error feedback, making troubleshooting easier. If errors occur during upload, a detailed report is provided for review. Click Download to download the report.

Upload user profile images​

Profile images can be uploaded automatically with the CSV file or manually in bulk later.

  1. Prepare profile image files that match the User Key column in the CSV file.

    For example, the 601.jpg file corresponds to user ID 601.

  2. After uploading the CSV file in the Import User(s) panel, enable the Upload Face Photo option.

  3. Click Select Folder, then select the folder that contains the profile images.

File format requirements

  • Supported formats: .jpg, .jpeg, .png

  • File size limit: 1 MB per image

Tip

If profile images were not ready when the CSV file was uploaded, use Image Upload() in the user list to add them later.

Finalize the bulk upload​

After all user data and images are uploaded, the system processes the entries, and the new users appear in the list with their assigned credentials.

Troubleshooting​

If you encounter issues with CSV upload, refer to more detailed documentation that helps resolve common problems. The document also includes Excel formulas that help validate data and remove duplicates. Fix Bulk User Addition Issues

Was this page helpful?