Organization Users

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.

Published 2026/11/12

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:
ChoiceWhat every row needsWhat happens
Email a setup link (default)An email, and no passwordUsers are created without a password, then each gets an email with a link to choose one
Set from the fileA passwordEach user gets the password from the file
No password yetNo passwordUsers 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:

  1. Full name (required)
  2. Username (required)
  3. Password: leave empty unless you chose "Set from the file"
  4. Email
  5. Folder
  6. Group
  7. 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: 2024

JSON 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.

To create one user, or to create users through the REST API, see Creating Users.