> For the complete documentation index, see [llms.txt](https://learn.withessential.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.withessential.com/administration/settings/review-users-and-their-roles.md).

# Add and manage users and their roles

The Users page lists everyone who can log in to Essential. Filter by status - All, Active, Invited, or Deactivated - or search by name or email, and click a row to open a person's details and effective access.

If you hold the Manage users permission, user management is self-serve from this page:

* **Add a user.** Click Add user, enter their first name, last name, and email, and pick their roles. They receive an invite email to set their password, and show as Invited until they first sign in. You can resend the invite from their detail drawer.
* **Change a user's roles.** Open the user, assign or remove roles, and save. You can only assign roles whose permissions you hold yourself.
* **Deactivate or reactivate.** Deactivating immediately removes a user's access and clears their roles; if they're a technician, their seat is released too. To bring someone back, reactivate them and assign their roles again.

## Technician setup

When the roles you pick grant access to the technician mobile app, Essential asks for two more things at that moment:

* **Color** (required) - the color that identifies the technician on the schedule and map. The picker flags colors already in use by another technician.
* **Starting location** (optional) - where they start the day, used to estimate drive time to their first job. Reuse a saved address or enter a new one.

Adding or removing a technician changes your billable technician seats, so those changes are reported to Essential for billing.

> **Where to find it:** Settings -> Users

## Related guides

* [Roles and permissions](/administration/settings/roles-and-permissions.md)
* [Set a user's license number, expiration, and seal](/administration/settings/set-a-users-license-number-expiration-and-seal.md)
* [Contact Essential for setup changes](/getting-started/getting-started/contact-essential-for-setup-changes.md)
* [Add or edit a pricebook item](/administration/settings/add-or-edit-a-pricebook-item.md)
* [Add the intake form to your website](/administration/settings/add-the-intake-form-to-your-website.md)
* [Automate task statuses with Task Automations](/administration/settings/automate-task-statuses-with-task-automations.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://learn.withessential.com/administration/settings/review-users-and-their-roles.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.