- What is TestInvite?
- Build Your First Test
- Run Your First Assessment
- Taking the Assessment
- Viewing the Results
- Question Bank Overview
- Common Question Features
- Scoring
- Question Types
- Question Authoring
- Browsing Questions
- Content Blocks
- Media Library
- Metadata Rules & Schema
- Tasks Overview
- Creating a Task
- Task Dashboard
- Steps
- Task Settings
- Candidates
- Test Sessions
- Sent Mails
- Proctoring
- Analytics
- Data Operations
- Analytics Overview
- Test Analytics
- Question Analytics
- Per-Question Analytics
- Results Explorer
- Segment Analysis
Importing Users
An import adds many users from a CSV or JSON file or pasted text, and one choice decides whether they get an emailed setup link, a password from the file, or none yet.
Click Import on the Users page. An import only adds new users; to change existing users, see Updating users from a file.
1. Choose how to provide the users
Upload a CSV or JSON file, or paste text with one user per line.
2. Settings
- Roles: every imported user gets the roles you choose here.
- How will these users get a password? One choice for the whole import:
| Choice | What every row needs | What happens |
|---|---|---|
| Email a setup link (default) | An email, and no password | Users are created without a password, then each gets an email with a link to choose one |
| Set from the file | A password | Each user gets the password from the file |
| No password yet | No password | Users are created without a password; they can't sign in until you set one or send links later |
A setup link works once and is valid for 7 days. With a link you never know the user's password. Users whose email belongs to a single sign-on domain where passwords are not allowed never get a password or a link; leave their password empty.
3. Preview
Each user appears in a panel. A field the file got wrong is red, and a row that doesn't fit your password choice says why. Fix a row with its edit button, remove it, or go back and fix the file. You can save once every row is correct.
If the import would take you over the number of learners or teammates your organization can have, the preview says so and saving is blocked.
4. Save
Users are created one by one. If some can't be created, for example because a username is already taken, they stay in the list with the reason and the button changes to Retry.
With setup links, the last screen also shows how many links were emailed and lists any that could not be sent. Select those users in the table and use Send password links; see Passwords.
CSV and text format
One user per line, columns separated by commas, in this order:
- Full name (required)
- Username (required)
- Password: leave empty unless you chose "Set from the file"
- Folder
- Group
- Any number of tags, each as
Tag name: Tag value
Every line needs the same number of columns.
Martin Brown, martinbrown, , martinbrown@example.com, general, group1, Section: Math, Year: 2023
Jessica White, jessicawhite, , jessicawhite@example.com, general, group1, Section: Physics, Year: 2024JSON format
{
"users": [
{
"username": "martin",
"fullname": "Martin Brown",
"email": "martinbrown@example.com",
"active": true,
"folder": "general",
"group": "group1",
"tags": { "Department": "Sales" },
"labels": [],
"favorite": false
}
]
}Add "password": "..." to a user only when you chose "Set from the file". The import dialog offers example CSV and JSON files to download; they work as they are with the default choice.