Invite and Add Users

Prev Next

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 user guide.

To view and manage users as an administrator, go to Manage Screenshot 2025-12-23 130522.png → Workspace → Users. The Users page lists all workspace users, including app and bot accounts.

Invite users via email

If your workspace is self-managed (deployed on your own infrastructure), ensure that email is configured before sending invitations. See Configure Email Settings.

To invite users via email:

  1. Click Invite in the upper-right corner. The Invite Members panel appears.

  2. Enter one or more email addresses (comma-separated or on separate lines) and click Send.

Invitees receive an email containing a link to access the workspace. They can create an account by entering their details. If third-party authentication services (such as GitHub or Google) are enabled, users can register using those services.

Once a user registers 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 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.

Password

  1. Sent randomly and send by email: Generates a random password automatically and emails it to the user.

  • This option requires SMTP email 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 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 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.

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.

For detailed descriptions of all fields and options in the New User form, see the Inviting Users to Your Workspace user guide.

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.

Rocket.Chat supports REST API endpoints that enable you to manage users. Refer to the Users API guide for details.