> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-home-button.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage cloud users

> This page describes how administrators can add users, manage assignments, and remove users

export const EnterprisePlanFeatureBadge = ({feature = 'This feature', support = false, linking_verb_are = false}) => {
  return <div className="enterprisePlanFeatureContainer">
            <div className="enterprisePlanFeatureBadge">
                Enterprise plan feature
            </div>
            <div>
                <p>{feature} {linking_verb_are ? 'are' : 'is'} available in the Enterprise plan. {support ? `Contact support to enable this feature.` : 'To upgrade, visit the plans page in the cloud console.'}</p>
            </div>
        </div>;
};

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

This guide is intended for users with the Admin role in ClickHouse Cloud.

<h2 id="add-users">
  Add users to your organization
</h2>

<h3 id="invite-users">
  Invite users
</h3>

Administrators may invite multiple users at a time and assign one or more roles at the time of invitation.

<Steps>
  <Step>
    <h3 id="users-and-roles-1">
      Access organization settings and select Users and roles
    </h3>

    From the services page, select the name of your organization. Select the `Users and roles` menu item from the popup menu.

    <Image img="https://mintcdn.com/private-7c7dfe99-home-button/QFSnpjldnDouvOz3/images/cloud/guides/control_plane/1_users_and_roles.png?fit=max&auto=format&n=QFSnpjldnDouvOz3&q=85&s=7c849a08ae2c5f92eae6a1c4f54ec3c7" size="lg" width="3418" height="1702" data-path="images/cloud/guides/control_plane/1_users_and_roles.png" />
  </Step>

  <Step>
    <h3 id="invite-members">
      Select 'Invite members' in the upper left corner
    </h3>

    Click the `Invite members` button in the upper left corner.

    <Image img="https://mintcdn.com/private-7c7dfe99-home-button/QFSnpjldnDouvOz3/images/cloud/guides/control_plane/manage_cloud_users/2_invite_user.png?fit=max&auto=format&n=QFSnpjldnDouvOz3&q=85&s=e86c7d247047cd9c513612d9da04c1ce" size="lg" width="3416" height="978" data-path="images/cloud/guides/control_plane/manage_cloud_users/2_invite_user.png" />
  </Step>

  <Step>
    <h3 id="add-email-and-roles">
      Enter the email address of new members and assign roles
    </h3>

    Enter email addresses at the top of the invitation screen. Select one or more roles to assign the users.

    <Image img="https://mintcdn.com/private-7c7dfe99-home-button/QFSnpjldnDouvOz3/images/cloud/guides/control_plane/manage_cloud_users/3_invite_user.png?fit=max&auto=format&n=QFSnpjldnDouvOz3&q=85&s=b3296d1ca4a35f6e7e9380093a0b1c26" size="lg" width="3416" height="1710" data-path="images/cloud/guides/control_plane/manage_cloud_users/3_invite_user.png" />
  </Step>

  <Step>
    <h3 id="send-invites">
      Click `Send invites`
    </h3>

    Click `Send invites` at the bottom of the screen. Users will receive an email from which they can join the organization. For more information on accepting invitations, see [Manage my account](/products/cloud/guides/security/cloud-access-management/manage-my-account).

    <Image img="https://mintcdn.com/private-7c7dfe99-home-button/QFSnpjldnDouvOz3/images/cloud/guides/control_plane/manage_cloud_users/4_invite_user.png?fit=max&auto=format&n=QFSnpjldnDouvOz3&q=85&s=2aae743e787e69e4a40c616c50bee476" size="lg" width="3416" height="1696" data-path="images/cloud/guides/control_plane/manage_cloud_users/4_invite_user.png" />
  </Step>
</Steps>

<h3 id="add-users-via-saml">
  Add users via SAML identity provider
</h3>

If your organization is configured for [SAML SSO](/products/cloud/guides/security/cloud-access-management/saml-sso-setup), follow these steps to add users to your organization.

1. Add users to your SAML application in your identity provider. The users won't appear in ClickHouse until they have logged in once.
2. When the user logs in to ClickHouse Cloud, they will automatically be assigned the default role selected in your SAML configuration.
3. Follow the instructions in the `Manage user role assignments` below to grant permissions

<h3 id="enforce-saml">
  Enforcing SAML-only authentication
</h3>

Once you have at least one SAML user in the organization assigned to the Admin role, remove users with other authentication methods from the organization to enforce SAML only authentication for the organization.

<h2 id="manage-role-assignments">
  Manage user role assignments
</h2>

Users assigned the Admin role may update permissions for other users at any time.

<Steps>
  <Step>
    <h3 id="users-and-roles-2">
      Access organization settings and select Users and roles
    </h3>

    From the services page, select the name of your organization. Select the `Users and roles` menu item from the popup menu.

    <Image img="https://mintcdn.com/private-7c7dfe99-home-button/QFSnpjldnDouvOz3/images/cloud/guides/control_plane/1_users_and_roles.png?fit=max&auto=format&n=QFSnpjldnDouvOz3&q=85&s=7c849a08ae2c5f92eae6a1c4f54ec3c7" size="lg" width="3418" height="1702" data-path="images/cloud/guides/control_plane/1_users_and_roles.png" />
  </Step>

  <Step>
    <h3 id="select-user-to-update">
      Select the user to update and select Edit
    </h3>

    Select the menu item at the end of the row for the user that you wish to modify access for. Select `edit` from the popup menu.

    <Image img="https://mintcdn.com/private-7c7dfe99-home-button/QFSnpjldnDouvOz3/images/cloud/guides/control_plane/manage_cloud_users/5_edit_user.png?fit=max&auto=format&n=QFSnpjldnDouvOz3&q=85&s=1ee4b0228b68db44d6022e05d820af49" size="lg" width="3410" height="1706" data-path="images/cloud/guides/control_plane/manage_cloud_users/5_edit_user.png" />
  </Step>

  <Step>
    <h3 id="update-permissions">
      Update permissions
    </h3>

    Click in the `Roles` box to expand the menu. Select the check boxes to add or remove roles from the user. Refer to [Console roles and permissions](/products/cloud/reference/security/console-roles) for a listing of roles and associated permissions.

    <Image img="https://mintcdn.com/private-7c7dfe99-home-button/QFSnpjldnDouvOz3/images/cloud/guides/control_plane/manage_cloud_users/6_edit_user.png?fit=max&auto=format&n=QFSnpjldnDouvOz3&q=85&s=f6be0584dc2c852ef25ac54fae66b2bd" size="lg" width="3414" height="1700" data-path="images/cloud/guides/control_plane/manage_cloud_users/6_edit_user.png" />
  </Step>

  <Step>
    <h3 id="save-changes">
      Save your changes
    </h3>

    Save your changes with the `Save changes` button at the bottom of the tab.
  </Step>
</Steps>

<h2 id="remove-user">
  Remove a user
</h2>

<Info>
  **Remove SAML users**

  SAML users that have been unassigned from the ClickHouse application in your identity provider aren't able to log in to ClickHouse Cloud. The account isn't removed from the console and will need to be manually removed.
</Info>

Follow the steps below to remove a user.

1. Select the organization name in the lower left corner
2. Click `Users and roles`
3. Click the three dots next to the user's name and select `Remove`
4. Confirm the action by clicking the `Remove user` button
