Skip to main content
Add and manage workspace members in Settings > Members. A member can belong to more than one workspace and switch between them using the workspace selector in the top-left corner.

​
Roles

Manage roles in Settings > Roles & Permissions and assign them in Settings > Members. A member can hold several roles at once and gets the combined permissions of all of them. They start with a first role when invited, and more can be added or changed afterward.
What a member can do comes from two things: the roles they hold, and the resource access they’re granted on individual apps and knowledge bases.See Permissions for details.

​
Add Members

The Owner, Admins, Editors, and custom roles with the Manage members permission can add members.
Prerequisites:
  • Set CONSOLE_WEB_URL to an address invitees can reach, not localhost. Every invitation link is built from it.
  • Configure an email service with MAIL_TYPE. Invitations are delivered by email, so this is required to add members. See CONSOLE_WEB_URL and Mail Configuration for details.
Select Add, enter one or more email addresses, choose a role, and send the invitation. An invitation link will be emailed to each address. Invitation links expire after 72 hours by default (configurable via INVITE_EXPIRY_HOURS); if someone doesn’t accept in time, invite again to send a fresh link.

​
Manage Members

The Owner, Admins, Editors, and custom roles with the Manage members permission can change member roles and remove members. Change a member’s roles: Assign one or more roles to a member. The change takes effect on the member’s next action, even if they’re currently signed in. The Owner’s role can only be changed through an ownership transfer. Remove a member: Removing a member revokes their workspace access right away. The apps and knowledge bases they created stay in the workspace. The Owner can’t be removed. Transfer ownership: Only the Owner can transfer ownership. The transfer is confirmed with a verification code emailed to the Owner. Once verified, the chosen member becomes the new Owner and the previous Owner becomes an Admin.
Because the verification code is sent by email, ownership transfer requires a configured email service (MAIL_TYPE). See Mail Configuration for details.

​
Troubleshooting

SymptomWhat to check
Invitees don’t receive the invitation emailInvitations are delivered only by email, which works only when MAIL_TYPE is configured. In split deployments, the worker container needs the mail settings too.
An invitation link won’t open, or points to localhostEvery link is built from CONSOLE_WEB_URL. Set it to an address invitees can reach.
An invitation link has expiredLinks last 72 hours by default. Invite the same email again to issue a new one.
Ownership transfer never sends a codeThe code is emailed to the Owner, so MAIL_TYPE must be configured.