Skip to content

Teams

Fine-tune individual database access with teams

Overview

PlanetScale allows you to create teams within organizations. This allows you to easily manage administrator access to one or multiple databases all in one spot.

Create and manage Teams

You can manage teams straight from your PlanetScale dashboard by going to "Settings" > "Teams".

Note

Only Organization Administrators can create and manage Teams.

Once you add databases to a team, any members on that team will have Database Administrator access to those databases. Review our Access control documentation to understand the full scope of Database Administrator access.

Create a team

  1. On your PlanetScale overview page, click "Settings".
  2. Click "Teams" in the left nav. Dashboard UI - Create a PlanetScale teamDashboard UI - Create a PlanetScale team
  3. Give your team a name and description (optional).
  4. Click "Create team".

Add members

  1. Click "Add a member".
  2. You'll see a list of your Organization members. Select the member(s) one at a time that you wish to add to the team.

Add databases

  1. Click "Add databases".
  2. Select the databases you want this team to have database administrator access to.

Now, when you go to the Settings page for any databases you've added to a team, you'll also be able to view and revoke access straight from the database Administrators page.

Dashboard UI - Database Administrators settings pageDashboard UI - Database Administrators settings page

Remove members and databases

To remove a member from a team, find their name in the member list and click "Remove". At this time, you'll also be able to delete any passwords this member has created to ensure you've completely revoked their access to the database.

Dashboard UI - Delete a member from a teamDashboard UI - Delete a member from a team

To remove a database from a team, click the "x" next to the database name under "Administrator permissions". This will remove database administrator access for all members of the team.

Dashboard UI - Delete a database from a teamDashboard UI - Delete a database from a team

Directory Sync with Teams

If you have SSO with Directory Sync enabled, all Teams will be managed by your Directory Sync directory. You can add and remove database access to teams, but member management must be done through your directory.

Dashboard UI - Directory-managed Teams pageDashboard UI - Directory-managed Teams page

Need help?

Get help from the PlanetScale support team, or join our GitHub Discussion board to see how others are using PlanetScale.

Was this page useful?
Last updated on August 4, 2022
Help us improve this page
PrivacyTerms© 2022 PlanetScale Inc.