Use this article to add, edit, or delete individual users in Cirrus. For bulk imports, see Import users via Excel.
All user management happens under Admin > Users.
You need the Manage users permission, configured under Admin > Roles > Administration > Manage users. A System Admin can also grant this permission at the hierarchy-group level. See Access levels and Site roles.
.png)
Add a user
- Go to Admin > Users.
- Click Add new user. The Add user dialog opens.
- Complete the required fields. See User fields below.
- Click Save.
After saving, open the new user's record and assign them to the relevant hierarchies on the Hierarchy tab. The hierarchy assignment controls what content the user can see and act on.
Update a user
- Go to Admin > Users.
- Search for the user.
- Click their name to open the record. The General tab shows their information.
- Edit the fields you need and save.
To change which hierarchies the user belongs to or which permissions apply per hierarchy, open the Hierarchy tab and see Access levels.
Delete a user
- Go to Admin > Users.
- Search for the user.
- Select them in the overview and click Delete.
- Confirm.
Deleted users are quarantined in the trash can for 30 days, during which they can be restored.
User fields
Fields marked with * are mandatory: First Name, Last Name, Username, Password, Role. For candidates, User ID is also mandatory.
User information
| Field | Description | Example |
|---|---|---|
| First Name * | The user's first name | John |
| Last Name * | The user's last name | Smith |
| Username * | The username used to sign in | johnsmith or johnsmith@example.com |
| Password * | A personal password, at least 5 characters | |
| Select role * | The Cirrus role assigned to the user. See Site roles. | Candidate, System Administrator, Author |
| User ID * (mandatory for candidates) | Unique identifier within Cirrus. Also used for API integrations. Optional for non-participants. | johnsmith or johnsmith@example.com |
| Synchronisation key (deprecated) | Legacy unique identifier for external integrations. | 0fcf0639-a0ea-4274-abe9-ac9290c43999 |
| Special needs | When enabled, the user can receive extra time depending on assessment options. | |
| Enable ReadSpeaker | Lets the user have text read aloud during exams. | Visible only when the ReadSpeaker add-on is active. |
| Labels | Custom metadata you attach to users. See User labels. | |
| Allow login via these IP addresses | Restrict the user's sign-in to specific IPs. | |
| Time zone | The user's time zone. Defaults to the regional settings value. Can be set via Excel import. |
Personal information
| Field | Description | Example |
|---|---|---|
| Email address | Recommended. Required for password reset. | johnsmith@example.com |
| Date of birth | 22 July 2001 | |
| Mobile phone | 0123456789 | |
| Address line 1 | 1 Example Street | |
| Address line 2 | ||
| Postal code | Any format | 12345 or 1234AB |
| Post address code |
Login information
| Field | Description |
|---|---|
| Disable Cirrus login | Disables platform access for the user. Useful in combination with SSO. |
| Disable password reset | Removes the Forgot password? option for the user. |