Importing users from a CSV file
This article will show you how to import users from a CSV file. This can be helpful if you are migrating a lot of users from a different system.
Prepare your CSV file according to the formats described below.
IMPORTANT: You must export the file as a CSV file. You cannot import a .xls file.
A note on Roles:
You can add one of the following roles to each user:
Each account has unlimited readers, but depending on your plan, you will have a limit on the number of Learner, Editor, or Admin users you can add. If your CSV file contains too many of these users the import will fail.
If you don't include a role, the user will be set as a Reader user.
Editable Sites only apply to Editor roles. The column should be left blank for all other roles.
Editable Sites can be a comma separated list of Site titles that you want the Editor to have access to. By default they will have full access to those sites.
This list will not remove any editable sites that the user is already assigned to. It can only be used to add additional editable sites.
Editing Permissions will default to "Full Access" if you leave the column blank.
If you would like to define specific permissions then you can include the following as comma separated values:
- uncategorized only
- moderate comments
Which every value you include will be set to true. All others will be set to false.
This is an example of the CSV format for importing reader users who will be logging in through ScreenSteps.
This is an example of the CSV format that is used for importing users that will be logging in through an external system (using Single Sign-on).
The RemoteUser heading column is required.
Go to Account Settings
Click on Users > Import Users
Choose a file (the csv file that you exported) and then select Upload. Your users will be imported. If you included an email address then they will be sent an email notification of their new account.