How to manage organization owners and teams

Note

This feature is only available on Read the Docs for Business.

Read the Docs uses teams within an organization to group users and provide permissions to projects. This guide will cover how to manage both organization owners and team members. You can read more about organizations and teams in our Organizations documentation.

Managing organization owners

Organization owners have full administrative access to the organization and all its projects. They can manage settings, teams, members, and other owners.

Adding an owner to an organization

To grant someone full administrative access to your organization, add them as an owner.

Note

You must be an owner of the organization to add another owner.

Follow these steps:

Navigate to the organization management page.
Select your organization from the list.
Click on Settings.
In the sidebar, click on Owners.
Click Invite owner.
Enter the user’s Read the Docs username or email address.
Click Invite owner.

The user will receive an invitation and must accept it to become an owner.

Removing an owner from an organization

To revoke administrative access from an organization owner:

Follow these steps:

Navigate to the organization management page.
Select your organization from the list.
Click on Settings.
In the sidebar, click on Owners.
Click Remove next to the owner you want to remove.

Note

You cannot remove the last owner from an organization. There must always be at least one owner.

Managing team members

Adding a user to a team

Adding a user to a team gives them all the permissions available to that team, whether it’s read-only or admin.

Follow these steps:

Navigate to the teams management page.
Click on a <team name>.
Click Invite Member.
Input the user’s Read the Docs username or email address.
Click Add member.

Removing a user from a team

Removing a user from a team removes all permissions that team gave them.

Follow these steps:

Navigate to the teams management page.
Click on <team name>.
Click Remove next to the user.

Granting access to import a project

Make the user a member of any team with admin permissions, they will be granted access to import a project on that team.

Automating team management

You can manage teams more easily using our single sign-on features.