Demo Mode — You are viewing a live demo. Data may be reset periodically and changes are not saved.

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

  1. On the Users page, click Add New User
  2. Fill in the required fields:
Field Description
Email 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)
  1. 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:

  1. In the Users table, find the user
  2. Click the Reset Password button on their row
  3. Enter a new password and confirm it
  4. 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:

  1. In the Users table, find the user
  2. Click the Change Role button on their row
  3. Select the new role
  4. Enter a confirmation password if required
  5. 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.

  1. In the Users table, find the user
  2. Click the Delete icon on their row
  3. Confirm the deletion

Changing Your Own Password

Any logged-in user can change their own password:

  1. Click your user icon or go to Account in the navigation
  2. Enter your current password and new password
  3. 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.