> For the complete documentation index, see [llms.txt](https://docs.subsalt.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.subsalt.io/administration/user-management.md).

# User management

Administrators can add or remove users from the organization from the **Organization > Accounts** section of the portal.

### Add a user

Add a new user by clicking the "add" button in the upper left. Complete the form in the next step, then click "add user". An email will be sent to the invited user with the subject *"You have been added to \[your organization name] organization"*. 

For Subsalt managed organizations using SSO, the email will provide a login link. If the organization account is Subsalt managed (*not* using SSO), the email will prompt the new user to set their password via a link prior to logging in.

#### External Users <a href="#external-user" id="external-user"></a>

Users can be marked as `External` during user creation via the **External User** checkbox. This allows creation of Subsalt managed (*not* using SSO) user accounts that have limited access to the organization's datasets. Guest users will not have access to any databases by default; access can be granted as needed via [Access control and sharing](/administration/access-control-and-sharing.md) functionality.

### Modify user roles

You can assign a new role to a user by clicking on their existing role on the **Accounts** page, and selecting a new role from the dropdown. You can read more about available roles in [Access control and sharing](/administration/access-control-and-sharing.md).

### Remove a user

Remove a user by clicking the "x" icon to the far right of a user's entry on the **Accounts** page. Confirm deletion by clicking the "remove" button. Removed users will immediately lose access to the Subsalt system.


---

# 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://docs.subsalt.io/administration/user-management.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.