Choose the Import Type
| Import type | Use it when |
|---|---|
| Invite new users | You're adding new users who will log in with a ScreenSteps password. Each user gets an invitation email to set up their account. |
| Preload users (SSO) | You use Single Sign-On (e.g., Microsoft Entra, Google, Salesforce) and want to set up users and their groups before they first log in. No invitation emails are sent, and password login is disabled. |
| Update existing users | You want to change roles, groups or other details for users who are already in ScreenSteps. |
Format for Invite New Users
| Role | Groups | First Name | Last Name | Time Zone | Preferred Site | |
|---|---|---|---|---|---|---|
| [email protected] | Site User | Group A | Steve | Young | employee-kb |
- Required: Email, Role (account admin or site user)
- Optional: Groups, First Name, Last Name, Time Zone, Preferred Site
- Preferred Site can be a site domain (such as employee-kb) or a hostname (such as help.company.com).
Format for Preload Users (SSO)
| Role | Groups | First Name | Last Name | Time Zone | |
|---|---|---|---|---|---|
| [email protected] | Site User | Group A | Steve | Young | |
| [email protected] | Admin | Group B | Joe | Montana |
- Required: Email, Role (account admin or site user)
- Optional: Groups, First Name, Last Name, Time Zone
Format for Update Existing Users
- Required: Public ID or Email. ScreenSteps uses this to find each user.
- Optional: Role, Groups, First Name, Last Name, Login, Time Zone, Deactivated, Disable Password Login
- Login: usually the same as the email address.
- Deactivated: leave blank unless deactivating the user. Use true to deactivate.
- Disable Password Login: use true to stop the user from logging in with a ScreenSteps password.
Accounts That Assign Roles Through Groups
If your account assigns roles through groups, the import doesn't use a Role column. Leave it out and assign roles with the Groups column instead.
Save and Upload
- Save your file as a CSV
- Open Import users
- Choose the import type and upload your file

