User Directory ​

The User Directory is the management system for all Users within a Project. Users are the individual accounts for logging in to the App. Each User belongs to a Role which defines its Permissions.

How it Works ​

This Module is a management system that enables one to view, invite, create, edit, and delete Users and User information. Users can be created directly in the app, or invited to join via email.

When a User is created, they must also be assigned a Role. This Role defines the User's data access permissions within Directus. In other words, it determines what a User can see and do inside the app.

The User Directory is composed of two pages: The User Directory Page and the User Details Page. It has all the same features and functionality as the Content Module such as manual and automatic sorting, batch edit/delete/archive, import/export from files, etc.

User Directory Page ​

The User Directory Page lists all Users in a Project, with a navigation that allows quick access to Users by Role. This page has the same functionality as the Collection Page.

• Select All — Selects all Users currently in queue.
• Card Size — Toggles size of User Displays.
• Sort Field — Selects Field used to Users by.
• Sort Direction — Toggles ascending & descending sort order.
• Search — Enables classic type-based searching.
• Filter — Enables advanced query-based search.
• person_add — Invite people to become Users via email.
• add — Create User manually.

The following are only visible once Users are selected.

• edit — Opens a User Details page to apply a single edit across multiple Users.
• delete — Deletes one or more Users.

Layout Options ​

The Sidebar > Layout Options (denoted by layers when Sidebar is minimized) allows you to adjust how Users are displayed on the User Directory. To learn more, see Layouts.

User Details Page ​

A User's profile page can be accessed from the User Directory or by clicking the User Menu at the bottom of the Module Bar. The profile page has the same features and functionality as the Item Page. Administrators can add and customize Fields under Settings > Data Model > Directus Users, but the following are available by default.

• First Name — The given name.
• Last Name — The family/surname.
• Email — A unique email address.
• Password — A hashed system password.
• Avatar — An image to represent the User.
• Location — The city, country, office, or branch name.
• Title — The professional staff title.
• Description — A free-form text description.
• Tags — Keywords for search-ability.

User Preferences ​

• Language — The preferred App language/locale.
• Multi-Factor Authentication — Configuration for MFA.
• Email Notifications — Receive emails for notifications.

Theme ​

• Appearance — Light or Dark theme (or based on system preference).
• Light Theme Customization — Customization for light theme in use.
• Dark Theme Customization — Customization for dark theme in use.

Admin Options ​

• Status — Sets User status as Draft, Invited, Active, Suspended, Archived.
• Role — Defines the User's Role.
• Token — Allows generating a static User access token.
• Provider — read-only: SSO provider associated with User. See our built-in SSO options.
• External Identifier — Displays external identifier generated by SSO provider.

Read-only Info ​

Information in the Sidebar (denoted by info when Sidebar is minimized) also includes the following read-only details:

• User Key — The Primary Key of the User.
• Last Page — The last App page accessed by the User.
• Last Access — The timestamp of the User's last App or API action.

View a User ​

Users are referenced throughout the app, often for accountability purposes. Hovering over a User in this context will provide a popover with basic information. Clicking that popover will navigate you to a view of that User's profile page.

Create a User ​

To create a User, follow these steps:

1. Navigate to the User Library.
2. Click add in the page header.
3. Enter an Email Address.
4. Optional: Fill in the other User details as desired.
5. Click check to save the User.

Invite a User ​

To invite User(s) via email, follow these steps:

1. Navigate to the User Library.
2. Click person_add in the page header.
3. Enter one or more email addresses, separated by a comma and a space.
   Tip: You can also add emails on a new line.
4. Select the Role you want to assign to the User(s).
5. Click Invite.

After that, the invited User(s) will receive an email with a link to the App where they set a password and enable their account.

Edit User Details ​

To edit User details, follow these steps:

1. Navigate to the User Library.
2. Click on the User you wish to manage and the User Details Page will open.
3. Reset User details as desired.

The User Detail is only editable by the current User and admins, and the following fields are only available to admins:

• Status — Determines if an account is able to access the platform or not. Only the active state is able to authenticate, all others are simply descriptive inactive states.
  • Draft — An incomplete User; no App/API access.
  • Invited — Has a pending invite to the project; no App/API access until accepted.
  • Active — The only status that has proper access to the App and API.
  • Suspended — A User that has been temporarily disabled; no App/API access.
  • Archived — A soft-deleted User; no App/API access.
• Role — The User's role determines their permissions and access.
• Token — A User's token is an alternate way to authenticate into the API using a static string. When NULL, the token is disabled.

Archive a User ​

To archive a User, follow these steps:

1. Navigate to the User Library.
2. Click the User you with to archive to go to their User Detail page.
3. Click on archive in the header.
4. Confirm this decision by clicking Archive in the dialog.

Delete a User ​

To delete a User, follow these steps:

1. Navigate to the User Library.
2. Select one or more Users you wish to delete.
3. Click on delete in the header.
4. Confirm this decision by clicking Delete in the dialog.