How to Manage Users
This guide explains how to create, edit, and manage user accounts for Custos.
Prerequisites
- You must be logged in as a superuser (admin)
- The Users page is only visible to admins
Navigating to User Management
From the main navigation, click on Users (or go to /users).
User Roles
The application has two user roles:
| Role | Description |
|---|---|
| Regular User | Can log in, enter measurements, and view reports |
| Admin (Superuser) | Full access — can also manage part numbers, lot numbers, users, and settings |
Adding a New User
- On the Users page, click Add New User
- Fill in the required fields:
| Field | Description |
|---|---|
| The user's login email address | |
| Password | Initial password (minimum 8 characters) |
| Confirm Password | Must match the password field |
| Admin | Check this box to grant admin/superuser access |
| Force Password Change | When checked, the user will be prompted to change their password on first login (recommended) |
- Click Create User
The new user will appear in the user list immediately.
Resetting a User's Password
If a user forgets their password, an admin can reset it:
- In the Users table, find the user
- Click the Reset Password button on their row
- Enter a new password and confirm it
- Click Reset Password
Tip: Consider enabling Force Password Change so the user sets their own password on next login.
Changing a User's Role
To promote a regular user to admin, or demote an admin to a regular user:
- In the Users table, find the user
- Click the Change Role button on their row
- Select the new role
- Enter a confirmation password if required
- Click Save
Deleting a User
⚠️ Warning: Deleting a user is permanent. Their measurement records will remain in the system but will no longer be attributed to an active user.
- In the Users table, find the user
- Click the Delete icon on their row
- Confirm the deletion
Changing Your Own Password
Any logged-in user can change their own password:
- Click your user icon or go to Account in the navigation
- Enter your current password and new password
- Click Change Password
Alternatively, if you have been flagged for a forced password change, you will be redirected to the change password page automatically on login.
Troubleshooting
"Users" link not visible in navigation
The Users page is only visible to admins. If you do not see it, you are logged in as a regular user.
"Passwords do not match" error
Ensure both the password and confirm password fields contain exactly the same value.
User cannot log in after being created
Double-check the email address is correct. If Force Password Change was enabled, the user must change their password at their first login before they can fully access the app.