# How to View Users List?

Viewing the users list allows you to see all system users, their roles, and profile information.

## When You'll Need This

- You need to see all users in the system.
- You need to find a specific user for editing or role assignment.
- You need to check user roles and their access rights.

## What's Important to Know

- **Users list** — table with all system users.
- **Roles** — user access rights to different system modules and functions.
- **User profile** — information about the user (name, email, phone, etc.).

## Before You Start

- [x] You are logged in with administrator rights.
- [x] You have permission to view users (`canShow`).

## Step-by-Step Instructions

### 1. Open Users List

1. Go to the **Settings** module through the menu or directly at `/settings-page`.
2. In the side menu, find the **"Users"** section and expand it.
3. Click on **"Users"** (`/settings-page/users`).

### 2. View Users List

1. The system displays a table with all users in the system.
2. In the table you will see:
   - **ID** — unique user identifier
   - **Name** — user first and last name
   - **Email** — user email address
   - **Role** — user role in the system
   - **Status** — active/inactive (if available)
   - **Actions** — buttons for editing or other actions

### 3. Filter or Search Users

1. In **Search**, type a name, email, or other text to filter the table.
2. In **Active**, show only active or inactive users (or clear the filter).
3. In **Role**, pick one role to narrow the list.
4. Use **Test accounts only** to list test users when needed.

### 4. View User Details

1. Click on the user row or the **"Edit"** button — user details open.
2. Review user information and their role.

## What Happens Next

You see the full list of users and can perform actions with them:
- View user information
- Edit user profiles
- Assign roles to users

## How to Verify Everything Worked

- Check that the table displays all users in the system.
- Check that user information is displayed correctly.
- Try finding a specific user through search.

## Related Materials

- [Configure roles](/en/settings/how-to/configure-roles.md)

