Required permissions: You need Read on Manage Users to view the users list, Create to add users, Update to edit users and assign or revoke roles, and Delete to delete users. See roles and permissions.
Creating Users
Administrators can add new users from the Users section of the Admin Portal. You need Create on Manage Users. Without it, the New User button doesn’t appear.Step 1: Open the Create User Dialog
- Navigate to Administration → Users
-
Click the New User button in the top-right corner

Step 2: Enter User Information

Required Fields
Optional Fields
An alternative email for non-authentication communications.Options:
- Leave blank to use the account email for all communications
- Check “Use same as account email” to automatically copy the account email
- Enter a different email for separate communication preferences
One or more roles to assign to the user. Roles control what the user can see and do in the Admin Portal.If you leave this field empty, the user gets the default Viewer role. See Roles and permissions.
- Users are created with an Active status by default.
- There is no invitation workflow — notify new users manually after creation.
- The Account Email must be unique and cannot be changed after activation.
- If Contact Email is left blank, it defaults to the account email.
- No bulk import
- No password setup (handled via SSO or first-login reset)
- No custom templates or attributes
- Duplicate or invalid email address
- Missing required fields
Viewing and Searching Users
The Users list displays all active users in your instance, including a Roles column that shows each user’s assigned roles. Inactive and deleted users are hidden by default.Status Indicators
User status is displayed with color-coded badges for quick identification:Active - User can access the systemPending - User invited but not activatedInactive - Account temporarily disabledDeleted - User has been removed
Currently, the interface displays only active users. Deleted and inactive users are filtered from the view.
Search
Use the Search users… box above the list to find users by name or email. Results update as you type. The search term is saved in the page URL as asearch query parameter. Reloading the page or sharing the link keeps the list filtered. For example, searching for jane adds this to the URL:
Individual Actions
Click a user row to open the edit view, or use the ⋮ actions menu for quick operations such as Edit or Delete.Editing Users
Administrators can update user information directly from the list. You need Update on Manage Users to edit a user or to assign and revoke roles. Saving a user’s edited permissions as a new role also needs Create on Manage Roles. All edits are logged automatically in the audit trailupdatedAt, updatedBy).
Accessing the Edit User Feature
There are two ways to edit a user:Method 1: Click on User Row
Click anywhere on a user’s row in the user list table to open the edit modal.
Method 2: Actions Menu
- Click the actions menu (⋮) in the user’s row
-
Select Edit from the dropdown

- Name — updates display name throughout the system
- Account Email — must remain unique; affects login credentials
- Contact Email — optional; defaults to account email
- Status changes managed separately
- No bulk edit or version history
Deactivating and Deleting Users
Deleting a user removes their access to Entegrata while preserving their historical data for audit purposes. You need Delete on Manage Users. Without it, Delete doesn’t appear in the actions menu.Deleted users cannot log in or access the system, but their historical data and audit trails remain intact.
Step 1: Access Delete Option
Click the actions menu (⋮) in the user’s row and select Delete.
Step 2: Confirm Deletion
A confirmation dialog will appear to prevent accidental deletions.
- Status changes to Deleted, ending all sessions and invalidating tokens
- Audit logs and historical data remain intact
- Deletions are recorded with who performed the action and when
- Confirm deletion is appropriate and reassign any owned resources
- Notify relevant team members and document the reason
Related Documentation
User Overview
Understanding user management basics in the platform
Roles and permissions
Control what users can see and do with roles
Troubleshooting
Common issues and solutions for user management
