| ← Settings | Manual |
The Users settings page lists all operator accounts (excluding the root user), lets administrators create new users, and provides a detail panel to view and edit each user’s properties.
┌─────────────────────────────┬──────────────────────────────────────┐
│ Users list │ User Detail panel │
│ [🔍 search] [+ Add] │ (opens when a user is selected at │
│ ───────────────────────── │ /settings/users/:id) │
│ Name [Role] │ │
│ Name [Role] │ │
└─────────────────────────────┴──────────────────────────────────────┘
Each row shows the user’s full name and role chips. The root user is excluded from the list. A text filter searches across first name, last name, username, and email.
Clicking + (requires user:create) opens the Add New User dialog:
| Field | Description |
|---|---|
| First Name | Required |
| Last Name | Required |
| Username (Login ID) | Required — used for login |
| Password | Required — must satisfy the password policy |
| Confirm Password | Must match Password |
| Optional | |
| Role(s) | Multi-select |
| Active | Toggle; defaults to active |
Saving creates the user and navigates to their detail panel.
Each property has a pencil-edit button when the current operator has the required permission and the target user is not a “superior user” (a user with roles unknown to the viewer).
| Property | Editable | Permission |
|---|---|---|
| Full Name | Yes | user:change-name (or self) |
| Login ID | Yes | user:change-username (or self) |
| Password | Yes | user:change-password (or self) |
| Yes | user:change-email (or self) |
|
| Role(s) | Yes | user:change-roles — not for self or superior users |
| Status | Yes | user:activate — not for self or superior users |
Superior users: users with roles not visible to the current operator. Their roles are shown as “Cannot display roles for a superior user” and all edit controls are hidden.
A Delete User button (requires user:delete, hidden for self and superior users) shows a confirmation before permanently removing the account.
| Action | Permission |
|---|---|
| View users list | /settings/users route |
| Add user | user:create |
| Change name | user:change-name |
| Change username | user:change-username |
| Change password (admin) | user:change-password |
| Change email | user:change-email |
| Change roles | user:change-roles |
| Activate/deactivate | user:activate |
| Delete user | user:delete |