Examplary works best if all of your students and teachers already exist in the system, ideally in user groups. This allows teachers to quickly assign a test or practice space to a whole class, or to invite a colleague to work on a shared test.
You can do this by uploading a CSV file containing your users and groups.
CSV imports are available on the Teacher and Organization plans.
Preparing your data
First, let's collect a CSV of the users and their groups. You might be able to export this from your student information system or directory service.
Download a template:
Columns specification
| Column | Required | Description | Example value |
|---|---|---|---|
| Yes | The user's email address. Must be unique. | user@example.com | |
| role | Yes | The user's role in the system: student, teacher or admin. | student |
| first_name | Yes | The user's first name. | John |
| last_name | No | The user's last name. | Doe |
| groups | No | The groups the user should be added to, separated by commas if multiple. | Class A, Class B |
| avatar | No | The URL of the user's avatar image. | https://example.com/avatar.jpg |
Uploading your CSV file
Once your CSV file is ready, you can upload it to Examplary to import your users and groups. Follow these steps:
- Go to Account → Users & groups.
- Click Import.
- Choose whether to Send invite emails to new users, then click Choose CSV file and select your file.
- Review the import summary and fix any rows that couldn't be imported.
Once complete, your users can sign in to Examplary using their email and start accessing their assigned groups and resources.
Existing users will be updated if their email address matches an existing account in the system. Any changes to their role, name, groups, or avatar will be applied based on the CSV data.
Advanced: metadata
You can include additional metadata for each user by adding custom columns to your CSV file.
The column names should follow the format metadata_<key>, where <key> is the name of the metadata field.
This might be useful to keep track of additional information external systems might need for each user.