> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Users

> Create and manage the people in your directory - their profiles, their lifecycle statuses, and the difference between suspending and removing.

A **user** is a person in your directory. Each user has a sign-in identity, a
profile made up of attributes, and a status that reflects where they are in
their lifecycle. You manage users in **Directory → Users**, where the list shows
each person's name, status, username, domain, primary email, role, source, and
sign-in activity.

<Note>
  This page covers managing individual users by hand. To add many people at
  once, see [Importing users](/en/identity/directory/importing-users) or sync
  them from an HR system with
  [Directory Sync](/en/identity/directory/directory-sync).
</Note>

## Create a user

<Steps>
  <Step title="Open the user form">
    In **Directory → Users**, choose to add a **User**. A blank profile form
    opens.
  </Step>

  <Step title="Enter the essentials">
    Give the user a name, a username, and at least one email address. The
    username and a domain together form how the person signs in.
  </Step>

  <Step title="Fill in the rest of the profile">
    Add any other built-in details - phone numbers, addresses, a role - and fill
    in the custom attributes you have defined in your
    [schema](/en/identity/directory/schema).
  </Step>

  <Step title="Save">
    The user is created with a **pending** status. Invite them when you're ready
    for them to sign in.
  </Step>
</Steps>

A user created this way has a **source** of having been added manually, which
distinguishes them from people brought in by import or HR sync.

## The user profile

A profile is a collection of facets. Some are built in; the rest are the custom
attributes you define. Built-in facets include:

| Facet                   | Notes                                                                                                                                               |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**                | The person's name, used to build their display name.                                                                                                |
| **Emails**              | One or more email addresses, each with a label such as work or personal. One is the primary email.                                                  |
| **Phone numbers**       | Zero or more numbers, each labeled.                                                                                                                 |
| **Addresses**           | Zero or more addresses, each labeled.                                                                                                               |
| **Username and domain** | Together, the identifier the person signs in with.                                                                                                  |
| **Role**                | The role the user holds, which governs what they can do in Iru. See [Administrators & roles](/en/identity/administration/administrators-and-roles). |
| **Status**              | Where the user is in their lifecycle - pending, active, or suspended.                                                                               |
| **Source**              | Where the user originated - added manually, imported, or synced from an HR system.                                                                  |

Beyond these, every **custom attribute** you define appears on the profile in
its category. See
[Schema](/en/identity/directory/schema) for how
the schema is built.

<Info>
  The attributes on a profile are the raw material that applications and
  policies use. An application maps profile attributes into the identity details
  it receives, and an [Auto Group](/en/identity/directory/auto-groups) can
  compute its membership from an attribute's value.
</Info>

## Find and filter users

The users list can be filtered, searched, and saved as reusable **views** -
useful once your directory grows beyond a handful of people.

### Filters

Add a **filter** to narrow the list by any attribute - built-in (status, domain,
role, created date) or a custom attribute you have defined. Pick the attribute,
choose an operator such as **equals**, and set the value; add more than one filter
to combine conditions.

<Frame caption="A filter narrowing the list to a single domain.">
  <img src="https://mintcdn.com/iru/J9e4tdSSyFEuoQS_/en/identity/images/users-filter.webp?fit=max&auto=format&n=J9e4tdSSyFEuoQS_&q=85&s=a6bf7e5e8b860743a20ec2a8e66b0e23" alt="The Users list filtered by Domain equals accuhive.com, shown as a removable filter chip above the list." width="2000" height="1131" data-path="en/identity/images/users-filter.webp" />
</Frame>

### IQL filters

For more precise queries, switch the list from **Standard** to **IQL** and write
the filter as an [IQL](/en/identity/getting-started/iql-expressions) expression -
for example `domain == "accuhive.com"`. This is the same expression language that
powers Auto Group rules and mapping.

<Frame caption="The same filter written as an IQL expression.">
  <img src="https://mintcdn.com/iru/J9e4tdSSyFEuoQS_/en/identity/images/users-iql-filter.webp?fit=max&auto=format&n=J9e4tdSSyFEuoQS_&q=85&s=9ee15984e8d5fe828bbc89ffb6376d9d" alt="The Users list in IQL mode with the expression domain == accuhive.com in the search bar and a Revert button." width="2000" height="1135" data-path="en/identity/images/users-iql-filter.webp" />
</Frame>

### Saved views

Once you have built a filter you will reuse, open **Options → Create view**, give
it a name, and save it. The view remembers your filters, so you can return to the
same slice of the directory in one click.

<Frame caption="Saving the current filter as a named view.">
  <img src="https://mintcdn.com/iru/J9e4tdSSyFEuoQS_/en/identity/images/users-create-view.webp?fit=max&auto=format&n=J9e4tdSSyFEuoQS_&q=85&s=d156bd4d6a5f2d79cc067fd0684ea40e" alt="The Create view option with a name field set to Accuhive.com and a Save button." width="2000" height="1129" data-path="en/identity/images/users-create-view.webp" />
</Frame>

## User statuses

A user is always in one of three statuses, and you can filter the users list by
status.

<CardGroup cols={3}>
  <Card title="Pending" icon="hourglass-half">
    Created but not yet active. This is where a freshly added or imported person
    starts, before they finish setting up their account.
  </Card>

  <Card title="Active" icon="circle-check">
    Fully enabled. The person can sign in and reach the applications assigned to
    them.
  </Card>

  <Card title="Suspended" icon="ban">
    Access is blocked, but the record and history are preserved. The person
    cannot sign in until they are reinstated.
  </Card>
</CardGroup>

### Suspending vs. removing

Both stop a person from signing in, but they are different tools for different
situations.

<AccordionGroup>
  <Accordion title="Suspend - reversible" icon="user-lock">
    Suspending blocks a user's access while keeping their record, profile, and
    history intact. Reinstating a suspended user returns them to the status they
    held before, so this is the right choice when someone is on leave, under
    investigation, or being offboarded but not yet fully gone. You can suspend a
    user whether they are active or still pending.
  </Accordion>

  <Accordion title="Remove - permanent" icon="user-xmark">
    Removing a user deletes their directory record. Reach for this only when a
    person has left for good and you no longer need to keep their identity. When
    your HR system is connected, an offboarding there can remove people from the
    directory automatically - see
    [Directory Sync](/en/identity/directory/directory-sync).
  </Accordion>
</AccordionGroup>

<Warning>
  Removing a user cannot be undone. If there is any chance the person will
  return, or you need to retain their history, suspend them instead.
</Warning>

## Inviting users

A newly created user is **pending** until they finish setting up their account.
Inviting a user sends an invitation to their email with a secure link to
complete first-time setup, including registering an
[authenticator](/en/identity/authentication/authenticators) such as a passkey.

* You can invite a single user from their profile, or invite your pending users
  in bulk from the users list.
* Invitations expire **48 hours** after they are sent. You can resend one if it
  was missed or has expired; sending a new invitation supersedes any earlier one
  for that user.
* Invitations are sent to the user's primary email address.

<Tip>
  If a user loses access to their authenticators, **Reset** them from the user's
  profile. A reset removes their registered authenticators, ends their active
  sessions, and returns them to **pending** - then send a fresh invitation so they
  can register a new authenticator. (Sending an invitation is blocked while a user
  still has authenticators, which is why you reset first.)
</Tip>

## Next steps

<CardGroup cols={2}>
  <Card title="Shape your profiles" icon="table-list" href="/en/identity/directory/schema">
    Define the custom attributes every user profile can hold.
  </Card>

  <Card title="Organize people into groups" icon="users" href="/en/identity/directory/groups">
    Assign access to groups instead of individuals so it scales.
  </Card>

  <Card title="Import in bulk" icon="file-arrow-up" href="/en/identity/directory/importing-users">
    Add many users at once from a CSV file.
  </Card>

  <Card title="Automate the lifecycle" icon="building-user" href="/en/identity/directory/directory-sync">
    Let your HR system create, update, and remove users for you.
  </Card>
</CardGroup>
