Skip to main content
The User Management interface provides centralized control over user access, role assignments, and authentication methods for your organization.

​
Authentication Methods

Control which login providers are available to users in your organization.
1

Navigate to User Management

From the sidebar, go to Settings > User Management.
2

Toggle Authentication Providers

In the Authentication Methods section, enable or disable providers:
  • Basic Authentication - Email and password login
  • Google Authentication - Sign in with Google
  • GitHub Authentication - Sign in with GitHub
  • Microsoft Authentication - Sign in with Microsoft
3

Save Changes

Click Save to apply your authentication configuration.
Disabling a provider prevents new login sessions but doesn’t affect existing sessions. Users already logged in will remain authenticated until they sign out.

​
Managing Users

​
View All Users

The user table displays all registered users with their assigned roles. You can:
  • Search by email address
  • Paginate through large user lists (10, 25, 50, or 100 per page)
  • Sort by any column

​
Edit User Permissions

Users can be assigned multiple roles and permission levels through three mechanisms:
Roles are the primary way to grant permissions. Each role contains multiple permission sets.
1

Open Edit Modal

Click the EDIT button next to any user.
2

Select Roles

In the Roles tab, check or uncheck roles to assign them.
Every user must have at least one role assigned.
3

Save Changes

Click Save Changes to update the user’s roles.

​
Effective Permissions

A user’s effective permissions are calculated as the union of:
  1. All permissions from assigned roles
  2. All permissions from direct permission sets
  3. All direct permissions
If you edit your own permissions, they’ll take effect immediately after saving.

​
Delete User

1

Click Delete

Click the DELETE button next to the user you want to remove.
2

Confirm Deletion

A confirmation modal will appear. Review the user’s email address.
3

Confirm

Click Delete to permanently remove the user.
User deletion is permanent and cannot be undone. All user data will be removed from the system.

​
Search Users

Use the search box to filter users by email address. Results update automatically as you type (300ms debounce).

​
Change Page Size

Select from the dropdown to show 10, 25, 50, or 100 users per page. The view resets to page 1 when changing the page size. Use the pagination controls at the bottom to move between pages:
  • Previous/Next buttons
  • Page number buttons (shows current page and adjacent pages)
  • First/Last page shortcuts

​
Required Permissions

ActionPermission Required
View usersuser.view
Edit user rolesuser.edit
Delete useruser.delete
Modify auth methodsauth.edit
If you don’t have a required permission, the corresponding button will not appear in the UI.

​
Best Practices

Use Roles First

Assign permissions through roles rather than direct assignments. This makes auditing and bulk changes easier.

Least Privilege

Grant users only the permissions they need to perform their job functions.

Regular Audits

Periodically review user permissions to ensure they’re still appropriate.

Test Changes

When editing your own permissions, make sure you retain administrative access.

​
API Reference

See the Users API documentation for programmatic user management.

Build docs developers (and LLMs) love

Get started for freeTalk to us