Account

In this document, learn how to access and manage your Rocket.Chat account settings through the browser, desktop, and mobile apps.

• Login to your Rocket.Chat server with a valid username and password.

• Click your avatar.

• Under Account, select any of the settings to access the account settings — Profile, Preferences, Accessibility and appearance.

• On the left-hand pane, you can find the following tabs:

  • Profile

  • Preferences

  • Security

  • Integrations

  • Personal Access Tokens

  • Omnichannel

  • Feature Preview

  • Accessibility and appearance

  • Manage devices

Updating account settings is unique to your workspace and does not affect your account on other workspaces.

Let's look at the settings for each tab in detail.

The settings displayed depend on your workspace account settings configured by the administrator. See Accounts to learn about the settings.

Profile

You can update the following settings for your Profile:

• Profile Picture: You can also upload a picture or enter a URL.

• Name and Username

• Status Message

• Nickname

• Bio

• Email

• Team

• Designation

• Click Logout from other Logged In Locations to log out of your account from other clients.

• Click Delete my account to delete your account from this workspace.

Preferences

On the Preferences tab, you can configure and set your preferences for your account on the workspace. These preferences include the following:

Localization

• Language: Set the language to use for the Rocket.Chat user interface.

Rocket.Chat determines the language displayed in your workspace based on the following priority:

1. User preference: This is the language you choose for your account under the user preferences. It takes priority over all other options.

2. Browser language: If you haven't selected a language under user preferences, Rocket.Chat will use the language configured in your web browser.

3. Server language: This is the default language set by the Rocket.Chat workspace administrator. It's only used as a last resort if neither your user preference nor browser language is available.

Global

This displays a list of all the actions for which you selected “Don’t ask me again.”

User Presence

• Enable Auto-Away: Enable the auto-away functionality, which changes the status to away after an idle period.

• Idle time limit: Set the time in seconds to wait before the status changes to away.

Notifications

• Desktop Notifications: Click the Test Desktop Notification to see how notifications will be displayed on the desktop.

• Require Interaction to Dismiss Desktop Notification: When enabled, notifications must be attended to before they can be dismissed. i.e., they will remain in the notification panel until they are visited.

• Show Desktop Notifications For: Allows you to select the type of messages that should trigger desktop or browser notifications.

• Send Push Notifications For: Allows you to select what type of messages should trigger push notifications.

• Offline Email Notifications: Allows you to set the type of message notifications you want to receive by email.

• Receive login detection emails: Get an email notification whenever a login is made to your account.

To receive email notifications, you must verify your email address.

Messages

• Unread Tray Icon Alert: Toggles if the tray icon highlights when you have unread messages.

• Always show thread replies in the main channel: When enabled, all replies under a thread will also be displayed directly in the main room. When disabled, they're displayed based on the sender's choice.

• Also send thread messages to channel behavior: When replying to a thread, select how your replies should be sent to the room.

  • Selected for the first reply, unselected for the remaining: The first reply to the thread is displayed in the main room, while subsequent replies are not.

  • Selected by default: The Also send to channel checkbox is always selected when replying to a thread. When the reply is sent, it's also displayed in the main room.

  • Unselected by default: The Also send to channel checkbox is not selected when replying to a thread, and the reply is not displayed in the main room when it is sent.

When replying to a thread, you can select or unselect the Also send to channel checkbox based on your preference.

• Use Emojis: Enable this to allow the use of emojis.

• Convert ASCII to Emoji: Toggles emoji conversion when inputting ASCII characters.

• Auto Load Images: Enable to autoload images and avoid clicking on them to preview.

• Save Mobile Bandwidth: Saves mobile data when the app is open. Commonly known as Data Saver.

• Collapse embedded media by default: Toggles if messages with

• Hide Contextual Bar by clicking outside of it: Automatically closes the right sidebar in rooms when you click outside them.

• Display Avatars: Hides avatars on the channels, showing only the users' usernames.

• Enter key behavior: Configure what the Enter key does.

  • Normal mode (send with Enter)

  • Alternative mode (send with Enter + Ctrl/Alt/Shift/CMD)

  • Desktop mode (only sends with Enter on desktop)

Highlights

• Highlight words: Specify a comma-separated list of words or phrases to trigger notifications when mentioned by anyone in public or private channels of which you are a member.

Sound

• New Room Notification: Select the sound to play when added to a new room.

• New Message Notification: Select the sound to play for every new message.

• Mute Focused Conversations: When enabled, open and active rooms will not create notifications.

• Notifications sound volume: Set the volume of the notification sound.

My Data

You can download your personal data on the workspace as HTML or export it as JSON. When you click any of the download options, you'll be notified that your data file is being generated and will receive a link to download it via email once it's ready. Additionally, you're informed of how many other operations are queued ahead of yours. Refer to the User Data Download Settings to configure this feature appropriately.

Security

You can update the following account security settings depending on your workspace settings.

Password

This tab is displayed if the settings to change passwords in Accounts are enabled.

• Update your password and confirm the new password.

• Then, click Save Changes.

Two-factor authentication

This tab is displayed if 2FA is enabled in the workspace settings.

Refer to the Two Factor Authentication User Guide to comprehensively understand two-factor authentication in Rocket.Chat.

E2E Encryption

This tab is displayed if E2E encryption is enabled in the workspace settings.

You can create encrypted private groups and direct messages. You may also update existing private groups or DMs to encrypted. It is end-to-end encryption, so the key to encode/decode your messages isn't saved on the server. For that reason, you need to store your password somewhere safe. You must enter it on other devices where you want to use E2E encryption.

Change Encryption Password

To create an encryption password,

• Enter a new encryption password.

• Confirm the new encryption password and click Save Changes.

You can't set a password for your encryption key if your private key is not present in the workspace. To set a new password, you must load your private key using your existing password or use a workspace where the key has already been loaded.

Reset E2E Key

This option will remove your current E2E key and log you out. A new key will be generated upon logging back in, and you'll regain access to any encrypted rooms where at least one member is online. If no members are online, access will be restored once a member logs in.

• For users with passwords: Users with a password will be prompted to enter it before resetting the E2E key.

• For SSO users (no password): Users who log in through Single Sign-On (SSO) do not have a password. They can reset their E2EE key without being prompted to insert a password.

For each of these different users, if 2FA is enabled, you may be required to enter the TOTP code sent to your email or from your authentication app.

Refer to the E2E Encryption user guide for more details.

Integrations

• WebDAV Accounts: Select a webdav account for integrations.

Integration is only available if enabled by the workspace administration in the Webdav Integration.

Personal Access Tokens

To make API calls easily, you can create personalized access tokens.

Create a Personal Access Token

To create a personal access token,

• Enter the token name and click Add.

• You can configure whether or not to require 2FA when using this token by selecting between the Ignore Two Factor Authentication and Require Two Factor Authentication drop-down options.

• Enter your password or 2FA code to Verify.

• Your access token is generated successfully. It displays Your User Id and an Access Token.

Remember to store the user Id and access token in a safe place as you can only view it once.

Delete Personal Access Token

To delete an access token,

• From the Personal Access Token list, click the Delete icon against the token you choose to delete.

• Then, click Delete.

Regenerate Personal Access Token

To regenerate an existing access token,

• From the Personal Access Token list, click the refresh icon against the token you choose to regenerate.

• Then, click Regenerate.

Omnichannel

Hide conversation after closing: Redirect agents to the home page after closing a conversation.

Conversational Transcript

• Export chat transcript as PDF: Always export the transcript as PDF at the end of conversations.

• Send chat transcript via email: Always send the transcript to contacts at the end of the conversations.

To learn about feature preview, device management settings, and accessibility and appearance, see the upcoming topics.