Manage Guest Users

Prev Next

Guest users are external users with limited access to your workspace, for example, partners, contractors, or customers.

Guest users can:

Guest users can join a maximum of one room apart from DMs.

Add a guest user

To add a guest user, create a new user and assign the guest role to the new user.

  1. Go to Manage → Workspace → Users and click New user.

  2. Enter the guest user's information as follows:

Field

Description

Email*

Enter the email address associated with the user. This is a required field. This email will be used for notifications and communications within the workspace.

Mark email as verified

Enable this option to automatically verify the user upon creation, eliminating the need for them to manually verify their email. This is important if your workspace requires email verification for user logins.

Name*

The full name of the user as it should appear within the workspace.

Username*

A unique identifier for the user within the workspace, used for login and mentions. Usernames can include alphanumeric characters, hyphens, underscores, and periods, but no spaces or other characters. They must be at least one character long.

Set password randomly and send by email

Automatically generate a random password and send it to the user via email. This requires an SMTP configuration.

The user receives a temporary password in an email. Once they use the password on the workspace, they are prompted to change their password.

Set password manually

Manually enter and confirm a password for the user, setting a specific login password. If password policies are enabled, there’ll be real-time verification to show how well the password adheres to the rules.

Require password change

If the Set password manually option is selected, you can enable this option if you want to force users to change their password upon login.

Roles*

Select the guest role option from the drop-down menu.

Join default channels

Enable this setting to automatically add the user to the default channels (rooms) upon their first login.

For example, #general is a default channel to which new users are added automatically.

Send welcome email

Send a welcome email inviting the user to join the workspace. This feature requires an SMTP configuration.

Status message

A custom status message to be displayed alongside the user’s name in the workspace.

Bio

A short biography or description that other users can view on the user's profile.

Nickname

An alternate name or alias that the user can choose to display instead of their full name.

Show/hide additional fields

Display/hide additional fields if custom fields are defined for users in the workspace.

  1. Click Save.

Once the guest user is added, you can edit, activate, and deactivate the guest user.

Edit guest users

To edit a guest user:

  1. Go to Manage → Workspace → Users.

  2. Click the guest user in the list to open the User Info panel.

  3. Click Edit to edit the user.

For other actions, such as activating, deactivating, and deleting the user, click the kebab menu (⋮).

View guest user permissions

To view the guest user permissions granted in a workspace:

  1. Go to Manage → Workspace → Permissions and locate the guest role.

  2. You can view the enabled permissions for the guest role. By default, the following permissions are enabled for guest users:

    • View Private Room

    • View Joined Room

    • Start Discussion

    • View Direct Messages

  • Guest role permissions cannot be modified for Rocket.Chat workspaces on version 6.0 and above.

  • You must be an administrator to manage guest users in your workspace.

  • If you need different permissions for temporary users, you can create custom roles and assign them to users.

Enable file upload on the mobile app for guest users

By default, guest users on the Rocket.Chat mobile app have restricted file upload capabilities (for example, sending images, documents, and audio messages). However, administrators can grant or revoke the Allow file upload on mobile devices permission for guests through the REST API.

To enable file upload for guests on the mobile app, use the Add Permission to a Role endpoint:

curl --location 'http://localhost:3000/api/v1/permissions.addRole' \
--header 'x-auth-token: xxxx' \
--header 'x-user-id: xxxx' \
--header 'Content-Type: application/json' \
--data '{
  "permissionId": "mobile-upload-file",
  "role": "guest"
}'

To disable file upload for guests on the mobile app, use the Remove Role from Permission endpoint:

curl --location 'http://localhost:3000/api/v1/permissions.removeRole' \
--header 'x-auth-token: xxxx' \
--header 'x-user-id: xxxx' \
--header 'Content-Type: application/json' \
--data '{
  "permissionId": "mobile-upload-file",
  "role": "guest"
}'

Next steps

To learn how presence and status work, and how to manage them for your workspace, see User Presence and Status.