Invite External Users to Your Rocket.Chat Server

Prev Next

Native Federation is currently in Alpha and not recommended for production use. Expect breaking changes and limited functionality. Use in testing environments only.

To invite an external user from another federated server to a DM, multi-user DM, or channel, use their full federated address when adding them as a member.

Federated user format

@username:server.domain

Components:

  • @username - the user’s name on their home server.

    :- the colon separating the username from the server name.

  • server domain - the domain of the external server where the user’s account exists.

How it works

When you invite a federated user, Rocket.Chat automatically creates a local reference for that user within your workspace. You don’t need to repeatedly use their full federated address (@username:server.domain) to invite them again, once they appear in your local user list, you can simply search and select them like any other user.

Currently, Rocket.Chat automatically adds invited users to federated rooms. There’s no invite approval step in the native federation implementation, invitations are automatically accepted on behalf of the recipient.

If the invited user belongs to a different platform that still uses Matrix (for example, Element), they may receive an invite prompt on their end and can choose whether to accept or decline it.

Notes:

  • Federated users cannot currently be deleted from workspaces (as of version 6.12).

  • The same syntax applies to all federated rooms, whether DMs, group DMs, or channels.