How to invite teammates

How-to guide

Invite someone by email, pick a role, and land them in the workspace. Ownership is not transferred here.

Goal

Invite a person by email, assign a role, and land them in this workspace when they accept.

Conditions

You are a workspace owner or admin.
You know the invitee email and the role they should have.
An owner can invite an owner, an admin, an editor, or a viewer. An admin can invite an admin, an editor, or a viewer.

Procedure

In the team panel, enter the email and choose a role. An owner can invite an owner, an admin, an editor, or a viewer. An admin can invite an admin, an editor, or a viewer. Send the invitation.
If you want another channel, copy the accept link from the dashboard and send it yourself.
The invitee opens the link, sees the workspace and role, signs in if needed (a sign-in link returns them here), and lands as a member.
If you want to cancel before accept, revoke the pending invitation.

Verification

The person appears in the member list with the role you picked. The accept link granted exactly that role.

Tip

Treat the accept link as a credential. Send it only to the person you mean to invite. It expires if unused and can be revoked until accepted.

Failures

Expired or revoked link: send a new invitation. The old link does nothing.
Owner invite needs an owner: if you are an admin, the owner role is not in the picker. Ask an owner to send that invitation.
Admin cannot change their own membership: another owner or admin must do that, so no one locks themselves out.
UI allowed a bad request: the server still rejects it. Roles are enforced on the server, not only in the interface.

The roles

Four roles. An owner can invite an owner, an admin, an editor, or a viewer. An admin can invite an admin, an editor, or a viewer.

Role	Can do
Owner	Full control, including team, branding, and insights. An owner can invite another owner.
Admin	Manage the team, set branding, and view analytics and the activity log. An admin cannot assign the owner role.
Editor	Work on documentation content and the settings around publishing it.
Viewer	Read access to the workspace, without the ability to make changes.

Analytics and the activity log are owner and admin only. *(see Reference: Analytics)* *(see Reference: Activity log)* *(see How-to: How to brand a site)*