These rules are for importing users only. For records in modules, see Preparing Data for Import (Default).
Warning: Follow these rules carefully. If you’re unsure, raise a support ticket and we’ll help you through it.
An Example File #

The Rules #
- Save the file as CSV (UTF-8).
- One column per field.
- Every user needs a name and an email address.
- Email addresses must be unique and valid. A duplicate email address stops the import with an error.
- Match the case exactly.
[email protected]and[email protected]are treated as different. - Avoid commas and special characters in column headings and values.
- Write divisions as full paths with a forward slash (/) between levels, for example
Company/UK/Sales. Include the top division and leave out the permission group name. - You can only assign divisions you have access to. To give a user
Company/UK, your own account must be assigned toCompanyorCompany/UK. - Set the Active? status. Imported users are active by default, and every active user takes a licence seat. To import a user as inactive, put
FALSEin their Active? column. - Add a phone number for users who will use multi-factor authentication by text message.
Multiple Roles and Divisions #
Put more than one role or division in the same cell, separated by a pipe (|) with no spaces:
- Roles:
risk_manager|incident_manager - Divisions:
Company/UK/Finance|Company/UK/IT
Role names must match the system exactly. See the User Roles Reference.
