Create Federated Rooms

Prev Next

Federation is currently in its final stability and performance tuning phase. While the feature is already suitable for evaluation and non-critical use cases, you may occasionally encounter intermittent behavior as we complete ongoing audits and optimizations. For this reason, we currently recommend avoiding Federation for mission-critical workloads until the final stabilization phase is complete.

Federated rooms allow users from different servers to communicate seamlessly within the same Rocket.Chat environment. With federation, rooms are created and managed directly in Rocket.Chat.

You can create and participate in the following types of federated rooms:

  • 1:1 Direct Messages (DMs): Chat privately with one user from another server.

  • Multi-user DMs: Start a group DM with multiple users across servers.

  • Channels: Create shared spaces that include both local and federated users.

Federated rooms are marked with a globe icon next to the room name. Their names also include the home server where the room is hosted.

For details on federated user address structure and invitation rules, see the Invite External Users to Your Rocket.Chat Server user guide.

Create a 1:1 direct message (DM)

To create a federated DM:

  1. Click the + button next to your room list and select Direct message .

  2. In the New direct message dialog, search for or enter the federated user’s full address, for example:

    @username:server.domain

  3. Select the user and click Create.

Here @username:server.domain represents the federated user you want to start a DM with.

If your workspace has an allowed federation domain list configured, the domain part of the federated user ID (for example, server.domain) must be included in that list.

Create a multi-user direct message

With federation, you can create multi-user DMs (group direct messages) that include users from your own workspace and external federated servers, all within the same chat.

To create a federated group DM:

  1. Click the + button next to your room list and select Direct message.

  2. In the New direct message dialog, search for or enter the federated users’ full addresses, for example:

    @username1:server1.domain
@username2:server2.domain

  3. Select all the users you want to include and click Create to start the group DM.

Each @username:server.domain represents a federated user you want to add to the group DM.

Create a channel

With federation, you can create channels that include both local and federated users from other servers, directly from the creation dialog.

To create a federated channel:

  1. Click the + button next to your room list and select Channel.

  2. Enter a name for your channel.

  3. (Optional) Add a topic to describe the purpose of the channel.

  4. In the Members field, add users from your workspace or external federated users using their full addresses.

  5. In Advanced settings, enable Federated which allows users from other servers to join and participate.

Notes:

  • Once federation is enabled for a room, encryption, read only and broadcast features cannot be turned on.

  • Discussions aren’t supported inside federated channels yet.

  • When you join a federated room hosted on another server, that server’s name appears next to the room title to help distinguish similarly named rooms.

Edit a federated room

After a federated room is created, only certain details can be modified. This ensures the room’s identity and federation links remain stable across all connected servers.

To edit a federated room

  1. Open the room you want to update and click Edit in the room header.

  2. Make your desired changes to the name, avatar, or topic.

  3. Click Save.

You can update the following details:

  • Name: Change the room’s display name.

  • Avatar: Upload a new image or remove the current one.

  • Topic: Edit the room’s topic or description.

To leave a federated room

If you want to leave completely:

  1. Open the federated room and click the kebab menu (⋮) next to Edit.

  2. Select Leave to exit the room.

    • After leaving, the room will no longer appear in your list

Notes:

  • Federation can be enabled or disabled by workspace administrators. If federation is disabled, the room will no longer participate in federation.

  • Deleting federated rooms and sharing invite links are not supported yet.