# π₯ Users
The Users module gives you full control over who can access your system, what they can do, and how they interact with the platform. You can create new users, assign roles, activate or deactivate access, and manage account details with ease.
This helps maintain a secure, role-based environment for your business operations.
***
#### π§° Key Features
* Create new users with role-based access
* Assign roles (e.g., Admin, Technician, Staff)
* Toggle user status (Activate/Deactivate)
* Edit user info, including password
* Delete users from the system
* Prevent login for deactivated users
* Email uniqueness enforced β one account per email address
***
#### π User Management Actions
**β Create a New User**
To add a user to your system:
1. Enter a unique name
2. Provide a valid, unique email address
3. Set a secure password
4. Assign a user role
5. Set status to either Activated or Deactivated
> π« Deactivated users are stored in the system (email is reserved) but cannot log in until reactivated.
***
**βοΈ Edit User**
You can update a userβs:
* Name
* Email
* Password
* Role
* Status (Activate/Deactivate)
Changes are applied immediately and affect the userβs access and permissions.
***
**ποΈ Delete User**
Remove a user from the system permanently. This is useful when:
* An employee has left your organization
* An account was created in error
* You want to clean up unused accounts
> β οΈ Note: Deletion is permanent and cannot be undone.
***
#### π€ User Details
*This information may be visible to others where applicable.*
* Name β Full name of the user *(Required)*
* Email β Unique and valid email address *(Required)*
* Password β A secure password for login *(Required)*
***
#### βοΈ User Settings
*Manage access and role-based permissions.*
* Role β Select the appropriate role for this user. Roles control permissions and access across the system *(Required)*
* Status β Toggle to activate or deactivate the user.
* β Activated β User can log in
* π« Deactivated β User cannot log in, but the account remains stored (email is reserved)
***
#### π§ Actions
* Cancel β Return to the user list without saving
* Save β Save the new user and apply all entered details
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://codehas.gitbook.io/repair-box/administration/users.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.