# Viewing & Searching Users

The Users page shows all users in your tenant with tools to search, filter, and manage them.

## User Lifecycle

Every user account moves through a series of states from the moment they are invited. The diagram below shows each state and who triggers the transition.

```mermaid
stateDiagram-v2
    [*] --> Invited : Admin sends invitation
    Invited --> Active : User accepts invitation
    Active --> Suspended : Admin suspends user
    Suspended --> Active : Admin reactivates user
    Suspended --> Deactivated : Admin deactivates user
    Active --> Deactivated : Admin deactivates user
    Deactivated --> [*]
```

* **Invited** — The user has been sent an invitation but has not yet accepted it.
* **Active** — The user has accepted their invitation and can sign in normally.
* **Suspended** — A tenant admin has temporarily disabled the account (e.g., for a policy review). The user cannot sign in, but their data is preserved and access can be restored.
* **Deactivated** — The account has been permanently disabled. This is a terminal state.

## Browsing Users

Navigate to **User Management > Users** to see a paginated list of all users. Each entry shows:

* **Name** — User's display name
* **Email** — Their email address
* **Status** — Active, Suspended, or Inactive
* **Roles** — Assigned roles
* **Last Login** — When they last signed in

## Searching

Type in the search bar to find users by name or email. The search queries the server directly, so it works across all users — not just the ones visible on the current page.

## Filtering by Status

Use the status dropdown to filter users:

* **All Statuses** — Show everyone
* **Active** — Currently active users
* **Suspended** — Temporarily suspended users
* **Inactive** — Deactivated accounts

## User Actions

For each user, you can:

* **Activate** — Enable a suspended or inactive user
* **Suspend** — Temporarily disable access (with a reason)
* **Impersonate** — Sign in as this user to see what they see (admin only)

## Pagination

Users are displayed 20 per page. Use the pagination controls at the bottom to navigate between pages.


---

# 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://accessiq.gitbook.io/accessiq-docs/managing-users/viewing-and-searching.md?ask=<question>
```

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.