> 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"*.&#x20;

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](https://docs.subsalt.io/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](https://docs.subsalt.io/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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.subsalt.io/administration/user-management.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
