Manage User Roles in Federated Rooms

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

In native federation, users in a federated room can have one of three roles: Owner, Moderator, or Member. These roles define what actions users can perform in that specific room.

Roles overview

• Owner: Has full control of the room, including inviting or removing users, assigning or revoking roles, and editing room details.

• Moderator: Can manage user interactions within the room, such as removing members, promoting others to moderators, or editing room information like the name or topic.

• Member: Can send and react to messages but cannot manage room settings or user roles. All new users start as members by default.

Viewing Roles

You can view all users and their current roles in the Members panel:

1. Open the federated room and click the Members icon in the room header.

2. The list is organized into three role groups:

   • Owners appear at the top.

   • Moderators are listed below the owners.

   • Members appear under the moderators.

3. Each federated user’s name is shown with a globe icon beside it, indicating that they belong to an external server.

Managing roles

You can manage user roles directly from the Members list within the room:

1. Open the federated room and click the Members icon in the room header.

2. Hover over a user and click the ⋮ (kebab) menu next to their name.

3. Choose one of the following options:

   • Set as owner

   • Set as moderator

   • Remove as owner/moderator

   • Remove from room

Each role update is immediately synchronized across all federated servers.

Role management rules

• Only Owners can assign or remove roles.

• All new members join as Members by default.

• Users with the same role cannot promote or demote each other.

• If an Owner promotes another user to Owner, the action cannot be undone by the original Owner unless they retain their own privileges.

• If an Owner demotes themselves, they’ll see a confirmation warning (Losing privileges). This action is permanent unless another Owner reassigns the role.

• The last remaining Owner cannot remove themselves or be removed until a new Owner is assigned. Attempting to do so will display a warning: “This is the last owner. Please set a new owner before removing this one.”

Notes:

• Global roles do not override room-level roles in federated rooms.

• All role changes are automatically propagated across participating servers to keep permissions consistent.