Embedded Layout

Prev Next

The embedded layout feature of Rocket.Chat is a powerful tool for creating focused, immersive communication experiences within a single room. When combined with iframe integration, it allows for seamless interaction with a specified channel embedded within an application. With Iframe integration, you can log in the user and display a specified channel embedded within your application. This means the user can interact with the channel as if they were on the Rocket.Chat platform, but within the context of your own application. This seamless integration provides a cohesive user experience, allowing for focused communication and collaboration.

When embedding Rocket.Chat in your site, you can change the layout by adding ?layout=embedded after your server URL. For example, https://open.rocket.chat/channel/general?layout=embedded. It changes the workspace layout to a more "simplistic" view, hiding the left sidebar menu and the room’s top navbar.

To enable the top navbar of the room in the embedded layout,

  • Go to Administration > Workspace > Settings > Layout > User Interface

  • Enable Show top navbar in embedded layout.

When a URL is set to embedded mode, the view will be restricted to a single room, and the user won't have access to the channel lists.

To prevent users from accessing other channels, relying on the embedded layout alone won't suffice. Users could alter the URL using browser tools. Therefore, it's recommended to edit the user permissions to restrict access to other channels.

Whether you're looking to enhance the communication capabilities of your application or provide a distraction-free environment for focused discussions, the embedded layout feature is a valuable addition to your toolkit.