> 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/what-your-customers-see-in-the-customer-portal/managing-portal-users-inviting-access-scope-and-editing.md).

# Managing portal users (inviting, access scope, and editing)

Portal users are managed by customers themselves from the Portal Users card on their dashboard. Add User invites a colleague by email. If that email already matches a contact, the invite simply grants portal access to that contact. If it is new, the inviter fills in a first name and chooses roles.

Roles come at two scopes. Customer-level roles apply to every property on the customer and are only offered to inviters who themselves have customer-level access. Property-level roles apply only to the specific properties selected, so a user can be limited to one site.

At least one role must be chosen to add the user. The important rule is that you can only grant what you already have. A property-level user can invite people only to the properties they can see, and only customer-level users can hand out customer-level access.

The Portal Users card lists everyone who shares your access scope, marks your own row with (You), and shows an Edit link only on users you are allowed to change. Editing opens the contact details so the user's name, phone, title, portal access, and their property or customer roles can be updated.

Removing a contact's portal access revokes their entry immediately. Newly added or edited users appear after the change saves.

> **Where to find it:** The Portal Users card on the right side of the Customer Portal dashboard, and the Add User and Edit dialogs it opens.

## Related guides

* [Roles and permissions: how access works](/administration/basics/roles-and-permissions-how-access-works.md)
* [How your customers sign in to the Customer Portal](/administration/what-your-customers-see-in-the-customer-portal/how-your-customers-sign-in-to-the-customer-portal.md)
* [What your customers see in the Customer Portal](/administration/what-your-customers-see-in-the-customer-portal.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/what-your-customers-see-in-the-customer-portal/managing-portal-users-inviting-access-scope-and-editing.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.