Customize the look of your workspace

The layout feature empowers you to personalize the appearance of your Rocket.Chat workspace. This includes defining content, applying custom CSS, and incorporating JavaScript, providing you with the means to tailor your workspace's visual aspects.

To access this setting, go to Administration > Workspace > Settings > Layout.

Remember to Save changes to apply any customization made.

Custom CSS

You can define custom CSS to modify your workspace's appearance.


The following CSS code snippet changes the color of your Rocket.Chat rooms and the hover color on the sidebar.

.rcx-content--main {
  --rcx-color-surface-room: #5d91f7;
.rcx-sidebar--main {
--rcx-color-surface-hover: #e07c41;

To learn more about the available classes and colors for easy customization in Rocket.Chat, you can refer to the Customizing Colors guide.

Custom Scripts

Custom Scripts allow you to execute JavaScript code in response to specific events in the workspace.

  • Custom Script for Logout Flow: Set a script to be executed during any logout process.

  • Custom Script for Logged Out Users: Define a custom script that will run ALWAYS and to ANY user that is NOT logged in. For example, when they access the login page.

  • Custom Script for Logged In Users: Set a custom script that will run ALWAYS and to ANY user that is logged in. For example, whenever they enter the chat and they're logged in.


Setting a custom script for logged-in users, as demonstrated in the example below, will trigger a "Welcome" alert when a user logs in and is on the /home page.

if(window.location.pathname == '/home'){

Home page content

The section allows you to change the content of your workspace homepage.

  • Home Title: The title on the header of the first screen that your users will see when they log in.

  • Show home page button on sidebar header: When enabled, the Home button will be shown on your server's navbar.

  • Block content: The content of the first screen that your users will see when logging in.

  • Show custom content to homepage: Enable to show custom content on the homepage.

  • Show custom content only: Turn this on to hide all other content blocks in the homepage.

The Show custom content to homepage settings is only available to workspaces on the enterprise plan. Show custom content only can be enabled only when Show custom content to homepage is enabled.

  • Terms of Service: Set the terms of service of your workspace. You can also redirect to YOUR-SERVER-URL/terms-of-service. This is shown by default on the links below your login page.

  • Login Terms: Specify the terms on which users are to accept before login in.

  • Privacy Policy: Set the privacy policy of your server. Can also be accessed via YOUR-SERVER-URL/privacy-policy. This is shown by default on the links below your login page.

  • Legal Notice: By default this screen is accessed on the links under the login page, here you can set the legal notice of your server. Can also be accessed via YOUR-SERVER-URL/legal-notice.

  • Side navigation footer: This is the logo or text on the bottom left of the sidebar. We recommend using the images set on your Assets for better consistency.


Customize your login page.

All the login settings except "Show Default Login Form" are only available to workspaces on the premium plan.

  • Hide Logo: Enable this to hide the Rocket.Chat.

  • Hide Title: Turn this on to hide the title on the login page.

  • Hide "Powered by": Enabling this hides the "Powered by" on the login page.

  • Login Template: Select the direction of the login page. Horizontal/Vertical.

  • Show Default Login Form: Enable to show the default login form.

User Interface

  • Display Roles: Toggles the display of user roles shown beside the usernames on messages.

  • Group Channels By Type: Enabling this separates the channels by category (Channel, Private Room, Direct Message or Discussion) on the left sidebar.

  • Use Full Name Initials to Generate Default Avatar: This setting changes default avatars to use the user's full name instead of username. For example, if the username is "blue.ducks" and the name is "Richards Nate", the default avatar displays "BD" by default. With this setting enabled, it displays "RN" instead.

  • Use Real Name: Enabling this changes the display of usernames to full names.

  • Click to Create Direct Message: Turn this on for workspace users to be able to create a direct message with another user when they click on their profile. This skips the viewing of the user's profile.

  • Number of users' autocomplete suggestions: Sets the number of autocomplete suggestions shown when you begin tagging any user with the @ symbol.

  • Unread Counter Style:

    • Different Style for user mentions: Makes the notification counter differentiate normal messages from mentions.

    • Same style for mentions: Makes the count mark mentions and normal messages the same.

  • Allow Special Characters in Room Names: When enabled, it allows for the use of special characters like ! @ # $ % ^ & * in room names

  • Show top navbar in embedded layout: If set to true, it shows the top navbar when embedding using ?layout=embedded at the end of the URL.

Last updated

Rocket.Chat versions receive support for six months after release.