--- title: "Invite and Add Users" slug: "invite-and-add-users" description: "Learn how to invite and add users in Rocket Chat. Enable secure collaboration and team growth." updated: 2026-05-05T16:17:55Z published: 2026-05-06T14:14:42Z canonical: "docs.rocket.chat/invite-and-add-users" --- > ## 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. # Invite and Add Users This guide describes the available options for adding users to your workspace. You can: - send an email invitation - manually create a user account You can also share your workspace URL so users can register themselves. For details, see the [Access Your Workspace](https://docs.rocket.chat/v1/docs/access-your-workspace) user guide. To view and manage users as an administrator, go to **Manage** ![Screenshot 2025-12-23 130522.png](https://cdn.us.document360.io/6ae79a05-7252-45d0-96e8-8f375e07b1b2/Images/Documentation/Screenshot%202025-12-23%20130522.png) **→ Workspace → Users.** The **Users** page lists all workspace users, including app and bot accounts. ## Inviting a new user via email > [!WARNING] > If your SMTP server is not configured, a warning will appear asking you to set it up. Follow the steps in the [**SMTP Configuration guide**](https://docs.rocket.chat/docs/configure-email#configure-smtp-settings) to complete the setup. You can invite users to your workspace by sending email invitations directly from the Administration area. To invite users: 1. Go to **Manage** ![Screenshot 2025-12-23 130522.png](https://cdn.us.document360.io/6ae79a05-7252-45d0-96e8-8f375e07b1b2/Images/Documentation/Screenshot%202025-12-23%20130522.png) **> 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 titled “Welcome to ” containing 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 If third-party [authentication services](/v1/docs/oauth) (such as GitHub or Google) are enabled, users can register using those services. After a user accepts the invitation and logs in, their account appears on the **Users** page. ## Add a new user manually To manually create a user account: 1. Click **New User** in the upper-right corner. The **New User** form appears. 2. 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. **Sent 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) | | **Status message** | Optional status text shown next to the user's name in the workspace. | | **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. | 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 more information, see [Manage Workspace Users guide](/v1/docs/manage-workspace-users). ## 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. Refer to the [Users API](https://developer.rocket.chat/apidocs/users-api) guide for details.