In this document, learn how to access and manage your Rocket.Chat account settings through the browser, desktop, and mobile apps.
To access the account settings on the web browser or the desktop app, follow these steps:
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:
To access the account settings on the mobile app, tap the hamburger menu next to the workspace name.
Tap Settings, and you can view and manage the following app configurations:
Language: Set your preferred language from a range of Rocket.Chat supported languages.
Default browser: Select the browser option where the links in Rocket.Chat should be opened by default. You can select the system default browser or the in-app browser option.
Theme: Choose between using your device's default or a light or dark theme.
Media auto-download: Select the auto-download options for images, videos, and audio. You can choose whether media is downloaded automatically when using Wi-Fi and mobile data, Wi-Fi, or Never.
Security and privacy: Modify security and privacy settings. You can reset your end-to-end encryption key, set a screen lock for devices that support biometrics, log analytics events, and send crash reports to our backend. Crash reports help us track and solve bugs. We never track the content of your chats. The crash report and analytics events contain only the relevant information for us to identify and fix issues.
Get help: This directs you to the Rocket.Chat help options—the documentation, accessibility statement, and glossary of terms used.
Share this app: Share the Rocket.Chat app link from the store to others so they can visit the link to install the mobile app.
Legal: This directs you to the Rocket.Chat Terms of Service and the Privacy Policy.
Contact Us: Email Rocket.Chat support team for your worries or inquiries. It redirects you to your default email client.
Review this app: Review Rocket.Chat on either Google Play Store or Apple App Store. Depending device's operating system, you are taken to the respective store.
License: Open and read Rocket.Chat mobile's MIT License.
App version: Displays the version of Rocket.Chat mobile app that you are using.
Workspace version: Displays the current Rocket.Chat workspace version.
Clear local server cache: Delete cached information from your workspace.
Logout: Logout from your workspace.
For more account settings, access the workspace from the browser or the desktop app and manage the options as described below.
Updating account settings is specific to your workspace and does not impact your account on other workspaces. Click Save changes for your updates to take effect.
Let's look at the settings for each tab in detail.
Before you proceed, keep in mind that 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 upload a picture or enter a URL to change the avatar. Generally, the avatar is the first letter of your first name.
Name and Username
Status message
Nickname
Bio
Email
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:
User preference: This is the language you choose for your account under the user preferences. It takes priority over all other options.
Browser language: If you haven't selected a language under user preferences, Rocket.Chat will use the language configured in your web browser.
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
You can choose to set your status automatically to active
and away
based on your activity.
Enable Auto-Away: Enable the auto-away functionality, which changes the status to
away
after an idle period. When you are active again, the status is automatically set toactive
.Idle time limit: Set the time in seconds to wait before the status changes to
away
.
You do not receive push notifications on your mobile device when using your web or desktop client. If you are idle for 60 seconds, you will be considered away, and all your mentions will be pushed to your mobile client after 60 seconds. However, if you disable auto-away, you won't receive any push notifications unless your screen goes off due to your computer settings.
If you do not see any changes in the user presence after enabling auto-away and setting an idle time limit, try refreshing the page.
Notifications
Select the general notification types and preferences.
Desktop Notifications: Click the Test Desktop Notification to see how notifications will be displayed on the desktop. If you are using a web browser, ensure the web notifications are enabled. You can check this by clicking the settings icon next to the URL in the browser’s address bar.
Require Interaction to Dismiss Desktop Notification: When enabled, notifications must be attended to before they can be dismissed. They will remain in the notification panel until they are visited.
Show Desktop Notifications For: Select the type of messages that should trigger desktop or browser notifications. Upon starting Rocket.Chat in a browser, you are asked to allow desktop notifications.
The notification options are as follows:Default: This selects the default user preferences set in the workspace account settings by the workspace admin.
All messages: You will receive notifications for all messages.
Mentions: You will receive notifications only when you are mentioned in any room.
Nothing: You do not receive any notifications.
Send Push Notifications For: Select the type of messages that should trigger push notifications for the mobile app. The options are as follows:
All messages: You will receive notifications for all messages.
Mentions: You will receive notifications only when you are mentioned in any room.
Nothing: You do not receive any notifications
Offline Email Notifications: Set the type of message notifications you want to receive by email. These notifications are only sent to your email address if you are offline.
The options are as follows:Default: This selects the default user preferences set in the workspace account settings by the workspace admin.
Every Mention/DM: You will receive email notifications for every mention and DM.
Disabled: Email notifications are disabled.
Receive login detection emails: Enable this option to get an email notification whenever a login is made to your account.
Mentions in rooms include using
@username
,@here
, and@all
.To receive email notifications, you must verify your email address. You can do this by going to the Profile tab and clicking Resend verification mail. If you don’t see this option, contact your workspace administrator for assistance in verifying your email.
If you are using the mobile app, you can access the notification settings by tapping the hanburger menu > Profile > click the settings icon on the top-right.
Messages
Select how you want the messages and media to be displayed.
Unread Tray Icon Alert: Enable this option to highlight 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: Enable this option to convert ASCII characters to emojis.
Auto Load Images: Enable this option 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: Enable this option to collapse media such as link previews, screenshots, videos, and audio messages.
Hide Contextual Bar by clicking outside of it: Automatically closes the right sidebar in rooms when you click outside them.
Display Avatars: Enable this option to view users’ avatars. If disabled, you can only view the usernames.
Enter key behavior: Configure what the
Enter
key does.Normal mode (send message with
Enter
)Alternative mode (send message with
Enter + Ctrl/Alt/Shift/CMD
)Desktop mode (only sends messages 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. Highlight words are not case-sensitive.
Sound
Configure audio and notification sounds.
Master volume: Control the volume for all sounds coming from your workspace.
Notification volume: Adjust the volume for message notifications, whether the workspace is open or minimized.
Caller ringer volume: Set the volume for all incoming voice call and video conference call notifications.
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.
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.
Manage devices
The Manage Devices menu lets you monitor and log out of your devices remotely. Here, you can see a list of all the devices you’ve used to log into your Rocket.Chat workspace. Click on any device to view the client, device operating system, your last login activity, and device ID.
To log out of a device, select the device you want to disconnect and then click Logout. Your device will be logged out from the workspace, and the current session will end. You can log back into your account whenever you need it.
To learn about the accessibility and appearance settings and the feature preview options, see the next topics.