If there are multiple people that need to be added to the system along with their credentials, people group assignments, and photos, a bulk import can be done. The import of mobile credentials is not supported. Up to 2000 people can be added to the system through a bulk import. The maximum .ZIP file size is 500 MB.

Importing can only be performed by people with administrator permissions. (See Roles.)

Template

A .CSV file containing the data or a .ZIP file containing the photos and data may be uploaded to the system. A specific template must be used. If needed, download the template under People Import.

  • First name and last name are required.
  • Credentials:
    • If a person's badge ID in the import file is assigned to another person already in the system, the person will not be imported at all, even if they had other badges.
    • If two or more people in the import file have the same badge ID, they will not be imported.
    • Multiple Badge IDs (along with their credential status and expiration) can be imported by separating them with a comma. Badge IDs, credential statuses, and expirations must match one for one. If they do not match, the import will fail and be reported as an error.
      For example, if a person being imported has three badge IDs and only two credential statuses or expirations, the import will fail and be reported as an error.
    • The credential status may be Active, Lost, Stolen, Damaged, Terminated, or Other. If there is no status, the default status of Active will be applied. 
    • Credential expiration must be in ISO 8601 date and time format - YYYY-MM-DDTHH:mm:ss. If there is no expiration, the credential will not have an expiration. For each controller, the credential expires at this time based on its timezone.
    • If multiple badge IDs for a person are imported with only one status or expiration, that status or expiration will be applied to all their badges.
    • If the credential expiration is not enabled in System Options and the imported file has an Expiration column, the import job will fail.
    • The credential status and expiration currently appear in the .CSV template but are not included in the .ZIP file. To include them, create a .CSV template with those fields and add it the .ZIP file for upload (similar to Custom Fields).
  • To assign a PIN, at least one badge ID is required.
  • People groups:
    • People groups can be imported by separating them with a comma.
    • If the people group name does not exist, the system will create a people group with that name and assign the imported people. If the import fails, the people group will not be created.
  • To enable extended access, enter "Yes", "Y", "True", or "T". Otherwise, this field will be considered "False" and extended access will be disabled.
  • Photos:
    • When using a .ZIP file to import people and their photos, only one .CSV file may be included. If there is more than one .CSV file in the .ZIP file, the import will fail.
    • The relative path name (<path>/<filename>.<extension>) of the photo image file must be specified for the person in the .CSV file. This is case-sensitive. Ensure that the path name is exact so that it is properly processed.
    • The person will not be imported if their photo import fails.

  • The template also supports:

    • Person ID

    • A person's active or inactive status

Custom Fields

If there are custom person fields defined, the .CSV template includes these specific fields. The Photo column is used with the .ZIP file and will be ignored when using only the .CSV file. The .ZIP file does not include custom fields. For .ZIP files, the .CSV file should be updated with the custom fields and added for the upload.

  • All field identifiers for the custom field are included in the template as columns.
  • If field is required, it is indicated by "Required field" in the cell for each row.
  • If field is not required, it is indicated by "Optional field" in the cell for each row.

Import People

  1. From the sidebar, select Configuration, then System Options.
  2. Download the .ZIP or .CSV template to format the data properly if needed.
  3. Under People Import, select Start Import.
  4. Choose the file to be uploaded. Multiple files may be uploaded, but only one job will be processed at a time.

Once the file is uploaded, the import will start. The current status will be indicated under Job Status.

To undo the import, select the import job and then select Undo Import. Undo of the entire import is available for 48 hours.

Job Status

The system will queue jobs so that only one import or undo job occurs at a time. The details for each job is shown:

  • In Progress - The file is currently being imported.
  • Queued - If a file is uploaded while a job is currently in progress, it will be placed in a queue until the current job is done.
  • Completed - The import of the file is done.

After importing, a report is available for download, including successes and failures from the import job. To view the imports, select Job Status. The Job Status screen lists the current state of the imports. To view the full report for an import, select the import and then Download Summary. The summary file will be updated with a new status column for each record. On successful imports, a person ID column will be added. To view only the failed imports, select Download Errors on the Import People details screen.


Training video: Bulk Import People

Related Topic

Custom person fields



© 2025 Honeywell International Inc. All Rights Reserved.