> For the complete documentation index, see [llms.txt](https://ztrust.gitbook.io/livestreamiq/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ztrust.gitbook.io/livestreamiq/readme/4.-administration/4.2.-users-and-access.md).

# 4.2. Users and Access

The Users and Access page allows administrators to manage users within the organization. From this section, administrators can: View all registered users, Add new users, Edit existing user information.

#### 1. Accessing User Management

1. **Navigation Path** 
   1. Log in to the application.
   2. From the left navigation menu, select Administration.
   3. Click Users and Access under the Authentication section.

You will be redirected to the Users and Access page.

#### 2. Users and Access Page

1. **Page Description:**\
   The Users and Access page displays a list of all users configured in the system.
2. **Available Features:**<br>

   <table data-search="false"><thead><tr><th>Field</th><th>Description</th></tr></thead><tbody><tr><td>Search Bar</td><td>Search users by username, email, or full name</td></tr><tr><td>Role Filter</td><td>Filter users based on assigned roles</td></tr><tr><td>User</td><td>Displays user name and email address</td></tr><tr><td>Status</td><td>Shows whether the account is Active or Inactive</td></tr><tr><td>Role</td><td>Displays the assigned user role</td></tr><tr><td>Last Active</td><td>Shows the user's latest login activity</td></tr><tr><td>Origin</td><td>Indicates the source of user creation</td></tr><tr><td>Actions</td><td>Edit user details</td></tr></tbody></table>

#### 3. User List Example

The user list contains:

1. User Avatar
2. Full Name
3. Email Address
4. Status
5. Assigned Role
6. Last Login Activity
7. Edit Action Button\
   Example:<br>

   | User           | Status | Role | Last Active       |
   | -------------- | ------ | ---- | ----------------- |
   | Sridhara Nayak | Active | User | Not Yet Logged In |

#### 4. Adding a New User

To create a new user account:

Step 1: Open Add User Form

1. Navigate to Administration → Users and Access.<br>

   ![](/files/VaWgiSMbZLQQq9ZSoR73)
2. Click the Add User button located in the top-right corner.<br>

   ![](/files/xFScZJWVZNescWczaKz1)
3. The Add User page will open.

Step 2: Enter User Information\
\
Complete all required fields marked with (\*).

1. User Nam&#x65;**:** Enter a unique username.\
   **Requirements:**

   1. Must start with a letter
   2. Can contain:
      1. Letters (A-Z, a-z)
      2. Numbers (0-9)
      3. Underscores (\_)
      4. Length must be between 8 and 16 characters

   Example: `john_admin`
2. Email: Enter the user's valid email address.\
   Example: `john.doe@company.com`
3. Full Name: Enter the user's complete name.\
   Example: `John Doe`
4. Password: Enter a secure password.\
   Requirements:
   1. Minimum 8 characters\
      Example: `MySecurePass123`
5. Confirm Password: Re-enter the password to verify accuracy.<br>

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><em><strong>Note:</strong> Both password fields must match.</em>      </p></div>
6. Role: Select an appropriate role from the dropdown list.\
   Examples: the available role are based on the autherization:

   1. Admin
   2. User
   3. SuperAdmin
   4. Custom role

   (Available roles depend on system configuration.)
7. Active Status: The Active checkbox determines whether the user can log in.

   | Status    | Description                                   |
   | --------- | --------------------------------------------- |
   | Checked   | User account is active and login is allowed   |
   | Unchecked | User account is inactive and login is blocked |
8. Default value: `☑ Active`

Step 3: Save User

1. Review the entered information.
2. Click Add User.
   1. Result
3. If validation succeeds:
   1. User account is created.
   2. User appears in the Users and Access list.
   3. User can log in if the account is active.

#### 5. Editing an Existing User

Step 1: To modify user details

1. Navigate: **Administration → Users and Access**

Step 2: Locate the desired user.

Step 3: Click the Edit icon under the Actions column.

![](/files/MHmESIQ0Ma14xmb3wD13)

Step 4: Update the required information:

1. Full Name
2. Email Address
3. Password
4. Role
5. Status

Step 5: Save the changes.

&#x20;Result: Updated information is immediately reflected in the user list.

#### 6. Searching Users

1. Use the search box to quickly locate users.<br>

   ![](/files/HxobB23DYD8RB1E7RlCx)
2. Search Criteria\
   The user can search by:
   1. Username
   2. Full Name
   3. Email Addres\
      Example: \
      Search: `john`

Results will display all matching users.

#### 7. Filtering Users by Role

1. To filter users:
   1. Click the Role dropdown.
   2. Select a role.\
      Example: `Admin`\
      \
      Only users assigned to the Admin role will be displayed.
2. To view all users again:
   1. Open the role dropdown.
      1. Select All Roles.

#### 8. User Status Management

1. **Active User:**
   1. Can log in to the system
   2. Can access assigned features
   3. Appears with an Active status badge
2. **Inactive User:**
   1. Cannot log in
   2. Retains account information
   3. Can be reactivated later

#### 9. Password Visibility

The password and confirm password fields contain a visibility icon.

1. **To View Password**
   1. Click the eye icon.
   2. Passwords become visible.
2. **To Hide Password**
   1. Click the eye icon again.
   2. Passwords become masked.

#### 10. Validation Rules

<table data-search="false"><thead><tr><th>Field</th><th>Validation</th></tr></thead><tbody><tr><td>User Name</td><td>Must start with a letter</td></tr><tr><td>User Name</td><td>Length between 8–16 characters</td></tr><tr><td>User Name</td><td>Letters, numbers, and underscores only</td></tr><tr><td>Email</td><td>Must be valid email format</td></tr><tr><td>Password</td><td>Minimum 8 characters</td></tr><tr><td>Confirm Password</td><td>Must match Password</td></tr><tr><td>Role</td><td>Required</td></tr><tr><td>Full Name</td><td>Required</td></tr></tbody></table>