--- title: "Invite and Add Users" slug: "add-users-to-your-workspace" description: "Learn how to invite and add users in Rocket Chat. Enable secure collaboration and team growth." status: "update" updated: 2026-11-17T18:20:36Z published: 2026-11-17T18:20:36Z canonical: "docs.rocket.chat/add-users-to-your-workspace" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.rocket.chat/llms.txt > Use this file to discover all available pages before exploring further. # Add Users to Your Workspace Once your workspace is set up and secured, you can bring in your users. This guide shows you the ways to add users and how to choose the right one for your organization. To view and manage users, go to **Manage** → **Workspace** → **Users**. The **Users** screen lists all workspace users, including app and bot accounts. ## Before you begin - **Email**: Email invitations and random passwords sent by email only work if email is configured. For instructions, see [Configure Email](https://docs.rocket.chat/docs/configure-email). - **Sign-up settings**: Decide who can create an account before you invite anyone. For instructions, see [Secure Sign-up and Sign-in](https://docs.rocket.chat/docs/secure-sign-up-and-sign-in). - **Seats**: Each user occupies a seat on your plan. For details, see [Seats FAQ](https://docs.rocket.chat/docs/seats-faq). ## Choose a method | Method | Best for | | --- | --- | | [Invite users by email](/docs/add-users-to-your-workspace#invite-users-by-email) | A small group of people who create their own accounts | | [Add a new user manually](/docs/add-users-to-your-workspace#add-a-new-user-manually) | Creating accounts yourself, with roles and passwords set in advance | | [Share an invite link](/docs/add-users-to-your-workspace#share-an-invite-link) | Inviting people to a specific room with one link | | [Import users in bulk](/docs/add-users-to-your-workspace#import-users-in-bulk) | Moving many users at once, for example from Slack or a CSV file | | [Connect LDAP or SSO](/docs/add-users-to-your-workspace#connect-ldap-or-sso) | Organizations that already manage users in a directory or identity provider | ## Invite users by email > [!WARNING] > If your SMTP server is not configured, a warning appears asking you to set it up. To complete the setup, follow the steps in [Configure Email](https://docs.rocket.chat/docs/configure-email#configure-smtp-settings). > > The invitation email links to your workspace, and invitees create their own account there. Make sure they can: either set the registration form to **Public**, or let them sign in with SSO. For details, see [Secure Sign-up and Sign-in](https://docs.rocket.chat/docs/secure-sign-up-and-sign-in). To invite users: 1. Go to **Manage** → **Workspace** → **Users**. 2. Click **Invite** in the top-right corner. The **Invite members** panel appears. 3. In the **Send invitation email** field, enter one or more email addresses. You can paste multiple emails separated by commas or line breaks. 4. Click **Send**. A confirmation message indicates that the invitations are being sent. 5. Each invited user receives an email with the subject "You have been invited to [workspace name]" and a **Join chat** button. The email invitation includes: - the workspace name - a link to join using the **Join chat** button - a brief message inviting the user to access the workspace After a user accepts the invitation and logs in, their account appears on the **Users** screen. ## Add a new user manually To manually create a user account: 1. Go to **Manage** → **Workspace** → **Users**. 2. Click **New user** in the upper-right corner. The form to add a user appears. 3. Complete the user information form with the required details: | Field | Description | | --- | --- | | **Email*** | Enter the email address for the user. This email is used for login notifications and workspace communication. If email is required for login in your workspace, this field is mandatory. | | **Mark email as verified** | Marks the email address as already verified. This prevents the user from needing to verify it themselves. Use this if [email verification](https://docs.rocket.chat/v1/docs/accounts#configure-user-registration-settings) is required in your workspace settings. | | **Name*** | The full name of the user as it will appear in the workspace. | | **Username*** | A unique identifier used for mentions and login. - Usernames can include letters, numbers, hyphens, underscores, and periods. - Spaces and other special characters are not allowed. | | **Voice call extension** | Enter the voice call extension for the user, if required for [Rocket.Chat Voice](/v1/docs/configure-voice-via-sip-integration#step-4-assign-extensions-to-users). | | **Password** | 1. **Set randomly and send by email:** Generates a random password automatically and emails it to the user. - This option requires [SMTP email](https://docs.rocket.chat/v1/docs/configure-email#configure-smtp-settings) to be configured. - The user receives a temporary password and will be prompted to change it after the first login. 1. **Set manually:** Manually enter and confirm a password for the user. If [password policies](https://docs.rocket.chat/v1/docs/set-password-policy-and-history) are enabled, password strength validation appears during entry. | | **Require password change** | Forces the user to change their password the first time they log in. This option applies only when a manual password is set. | | **Roles*** | Assign one or more [roles](https://docs.rocket.chat/v1/docs/roles-in-rocketchat) to the user. Roles define permissions and the level of access the user has in the workspace. | | **Join default channels** | Automatically adds the user to the workspace’s default channels on first login. For example, `#general` is commonly configured as a default channel. | | **Send welcome email** | Sends an email inviting the user to join the workspace. This feature requires [SMTP email configuration.](https://docs.rocket.chat/v1/docs/configure-email#configure-smtp-settings) | | **Bio** | A short description or introduction that appears in the user’s profile. | | **Nickname** | An alternate display name the user can use instead of their full name. | | **Phone number** and **Label** | Optional phone numbers for the user, in the **Phone Numbers** section. The form starts with one empty row. If you leave it empty, the user is created without a phone number. - In **Phone number**, enter the number, for example `+15550100101`. - In **Label**, you can name the number, for example Home. A label can have up to 50 characters. In the user's details, each label appears above its number. - To add another number, click **Add number**. A user can have up to 10 phone numbers. - To remove a number, click the **Remove** icon next to it. - If a number is invalid or a label is longer than 50 characters, an error appears under that field when you save, and nothing is saved until you correct it. | | **User Status** | | **Show status** | Turn off to make the user always appear Offline to everyone. The user can't change their status while it's off. | | **Status message** | A short message shown alongside the user's status (for example, "In a meeting"). | 1. Click **Add user**. The account is created immediately. Manually created users are shown as **Pending** until they log in for the first time, after which they appear as **Active**. > [!NOTE] > To modify any user details, select the user and edit the information in the **User Info** panel. You can also update the user’s profile picture from the same panel. For details, see [Manage Workspace Users](/v1/docs/manage-workspace-users). ## Share an invite link An invite link adds people to a specific room. If they don't have an account yet, the link prompts them to sign up first. To create a link, open a room, go to the **Members** panel, and click **Invite link**. You can set how long the link stays valid and how many times it can be used. For instructions, see [Manage Room Members](https://docs.rocket.chat/docs/manage-room-members). To see and revoke all invite links in the workspace, go to **Manage** → **Workspace** → **Invites**. ## Import users in bulk To add many users at once, import them from another platform or a file. 1. Go to **Manage** → **Workspace** → **Import**. 2. Click **Import new file**, and choose the import type that matches your data, such as **Slack**, **Slack's Users CSV**, or **CSV**. For the full steps and file formats, see [Data Migration](https://docs.rocket.chat/docs/data-migration). ## Connect LDAP or SSO If your organization manages users in a directory or an identity provider, connect it to Rocket.Chat. Users then sign in with their existing accounts, and you don't have to create accounts one by one. For instructions, see [LDAP](https://docs.rocket.chat/docs/ldap) and [Authentication & SSO](https://docs.rocket.chat/docs/authentication). If third-party [authentication services](/v1/docs/oauth) (such as GitHub or Google) are enabled, users can also register using those services. ## About the `rocket.cat` bot The `rocket.cat` bot is included by default in Rocket.Chat workspaces. It provides administrators with updates, alerts, and notifications about version changes and other important events. Like any other workspace user, the bot account can be customized, deactivated, or deleted if required. > [!NOTE] > Rocket.Chat supports REST API endpoints that enable you to manage users. In the REST API, a user's phone numbers are a `phones` list. Each entry has a `number` and an optional `label`. A `users.update` request that sends the single `phone` field fails with a `400` error. Send `phones` instead. For details, see [Users API](https://developer.rocket.chat/apidocs/users-api). ## Next steps Help your users sign in and install the apps. For instructions, see [Help Your Users Connect](https://docs.rocket.chat/docs/help-your-users-connect).