User & Role Management

Users in Eloquent can belong to multiple organizations with different roles in each. The Admin App provides a centralized interface for managing user accounts and access.

Users Page

The Users page requires selecting an organization first. Once selected, it displays:

• Org controls — enable/disable organization toggle
• User table — name, email, role (per-org), status, auth source, created date
• Actions — edit or delete per user

User Statuses

Creating Users

Click "New User" (requires an organization to be selected).

Adding an Existing User

1. Enter the user's email and click Search
2. If the user exists, a green checkmark appears and name fields are pre-filled
3. Select roles for this organization
4. Click Create — the user is added to this organization with the selected roles

Creating a New User

1. Enter the user's email and click Search
2. If no user is found, fill in first name and last name
3. Select roles for this organization
4. Click Create — a new account is created with access to this organization

Editing Users

The edit dialog has two tabs:

Basic Info

• Email address
• First and last name
• Auth provider (e.g., credentials, google)

Organization Access

Lists all organizations the user belongs to. For each entry:

• Organization — dropdown to select which org
• Roles — checkboxes for available roles in that org
• Remove Access — removes the user from that specific org

Click "Add Organization Access" to grant the user access to additional organizations.

Roles

Default Roles

Every organization has two built-in roles:

• user — standard access
• admin — full access to organization settings and management

Custom Roles

Organizations can define up to 20 custom roles via the organization edit dialog (Roles tab). Custom roles can be used for fine-grained access control within applications built on the platform.

Multi-Organization Access

A single user account can be a member of multiple organizations simultaneously:

• Each organization membership has its own set of roles
• Users see only data from their currently selected organization
• Switching organizations changes the user's active context
• Roles do not carry across organizations — a user can be an admin in one org and a regular user in another

Removing vs. Deleting Users

When clicking the delete icon on a user, two options are presented:

Choose "Remove" when a user is leaving one team but staying with others. Choose "Delete" only for permanent account removal.