• Home
  • Integrations
  • SDKs
  • Guides
  • API docs
No results for ""
EXPAND ALL

EDIT ON GITHUB

Managing teams

Read time: 5 minutes
Last edited: May 13, 2022
Teams is an Enterprise feature

Teams is available to customers on an Enterprise plan. To learn more, read about our pricing. To upgrade your plan, contact Sales.

Overview

This topic explains how to manage team members, team maintainers, and team permissions in LaunchDarkly. It explains how to use the Teams tab.

Managing team members

If you have an Admin role, you are a maintainer of the team, or you have the required custom role permissions, you can add and remove team members from new and existing teams.

Adding a member to an existing team

If you have an existing team and you want to add a member to it:

  1. Navigate to Account settings.
  2. Click into the Teams tab.
  3. Click on the name of the team to navigate to that team's page. The team's Team members tab appears.
  4. Click Add members. The "Add members" dialog appears.
  5. Select the members to add to the team.
  6. Click Add members.

You can also use the REST API: Add a member to teams

Adding members in bulk to an existing team

You can add multiple members to an existing team by uploading a CSV file of member email addresses. Your CSV file must include email addresses in the first column. You can include data in additional columns, but LaunchDarkly ignores all data outside the first column. Headers are optional.

To upload a CSV file:

  1. Navigate to Account settings.
  2. Click into the Teams tab.
  3. Click on the name of the team you want to add members to. The team's Team members tab appears.
  4. Click Upload CSV. The "Upload CSV" dialog appears:
The "Upload CSV" dialog.
The "Upload CSV" dialog.
  1. Click Select file. A prompt to choose a file appears.
  2. Choose a CSV file. You are returned to the "Upload CSV" dialog.
  3. Click Upload file.

A success indicator appears with the number of team members successfully added to your team.

You can also use the REST API: Add multiple members to team

If the file upload was not successful, an error message appears with information about the errors in the file.

There are two types of CSV file upload errors:

  • Global errors are errors at the file level preventing LaunchDarkly from processing the file.
  • Line errors are errors on one or more individual lines in your CSV file.

Troubleshooting global errors

Global errors mean that something is wrong at the file level preventing LaunchDarkly from processing the file. You must resolve the errors in your file and try uploading again.

This table includes a list of global errors and how to resolve them:

Error messageResolution
Unable to process fileLaunchDarkly could not process the file for an unspecified reason. Review your file for errors and try again.
File exceeds 25mbBreak up your file into multiple files of less than 25mbs each.
All emails have invalid formattingNone of the email addresses in the file are in the correct format. Fix the formatting and try again.
All emails belong to existing team membersAll listed members are already on this team. Populate the file with member emails that do not belong to the team and try again.
File is emptyThe CSV file does not contain any email addresses. Populate the file and try again.
No emails belong to members of your LaunchDarkly organizationNone of the email addresses belong to members of your LaunchDarkly account. Invite these members to LaunchDarkly, then re-add them to the team. To learn how, read Adding members to LaunchDarkly.

Troubleshooting line errors

Line errors mean that something is wrong with one or more individual lines in your CSV file. You can either add only the valid entries from your CSV file, or upload a new file.

This table includes a list of line errors and how to resolve them:

Error messageResolution
Empty rowThis line is blank. Add an email address and try again.
Duplicate entryThis email address appears in the file twice. Remove the email from the file and try again.
Email already exists in the specified teamThis member is already on your team. No action needed.
Invalid formattingThis email address is not formatted correctly. Fix the formatting and try again.
Email does not belong to LaunchDarkly memberThe email address doesn't belong to a LaunchDarkly account member. Invite them to LaunchDarkly, then re-add them to the team. To learn how, read Adding members to LaunchDarkly.

Removing a member from a team

You can remove a member from a team in two ways. You can remove them from the team management page or from the Members page.

To remove a member from a team using the team management page:

  1. Navigate to Account settings.
  2. Click into the Teams tab.
  3. Click on the name of the team you want to remove members from. The team's Team members tab appears.
  4. Find the member in the list of team members.
  5. Click the overflow menu at the right of the row of the member you want to remove.
  6. Select "Remove member." A confirmation dialog appears.
  7. Click Remove member in the dialog to confirm.

To remove a member from a team using the Members page:

  1. Navigate to Account settings.
  2. Click into the Members tab.
  3. Find the member in the list of team members.
  4. Click on the member's name.
  5. Click the Teams tab.
  6. Find the team that you want to remove this member from.
  7. Click the overflow menu at the right of the row of the team you want to remove the member from.
  8. Select "Remove member." A confirmation dialog appears.
  9. Click Remove member in the dialog to confirm.

Managing team permissions

If you have an Admin role, or you have the required custom role permissions, you can add and remove custom roles that grant permissions to members of the team.

Adding a custom role to an existing team

You can add custom roles to a team from the Permissions tab for the team you manage.

To add a custom role to a team:

  1. Navigate to Account settings.
  2. Click into the Teams tab.
  3. Click on the name of the team. The team's Team members tab appears.
  4. Click on the team's Permissions tab.
  5. Click Add custom roles. The "Add custom roles" dialog appears.
  6. Select the roles you want to add to the team.
  7. Click Add custom roles.

Removing a custom role from a team

To remove a custom role from a team:

  1. Navigate to Account settings.
  2. Click into the Teams tab.
  3. Click on the name of the team. The team's Team members tab appears.
  4. Click on the team's Permissions tab.
  5. Find the role you want to remove in the list of roles.
  6. Click the overflow menu at the right of the row of the role you want to remove.
  7. Click Remove custom role. A confirmation dialog appears.
  8. Click Remove custom role in the dialog to confirm.

Managing team maintainers

If you have an Admin role, you are a maintainer of the team, or you have the required custom role permissions, you can add and remove team maintainers.

Adding a team maintainer to an existing team

You can add maintainers to a team from the Settings tab for the team you manage.

To add a maintainer to a team:

  1. Navigate to Account settings.
  2. Click into the Teams tab.
  3. Click on the name of the team. The team's Team members tab appears.
  4. Click on the team's Settings tab.
  5. In the "Team maintainers" section, click Add team maintainers. The "Add team maintainers" dialog appears.
  6. Select the members you want to designate as team maintainers.
  7. Click Add team maintainers.

Removing a team maintainer from a team

To remove a maintainer from a team:

  1. Navigate to Account settings.
  2. Click into the Teams tab.
  3. Click on the name of the team. The team's Team members tab appears.
  4. Click on the team's Settings tab.
  5. In the "Team maintainers" section, find the maintainer you want to remove.
  6. Click the overflow menu at the right of the row of the maintainer you want to remove.
  7. Click Remove team maintainer. A confirmation dialog appears.
  8. Click Remove team maintainer.

Deleting a team

LaunchDarkly account members with the Admin role can delete teams from the Teams tab.

To delete a team:

  1. Navigate to Account settings.
  2. Click into the Teams tab.
  3. Click on the name of the team. The team's Team members tab appears.
  4. Click on the team's Settings tab.
  5. In the "Delete team" section, click Delete team. A confirmation dialog appears.
  6. Click Delete team.

You can also use the REST API: Delete team

Viewing an individual member's teams

Members of your organization can belong to multiple teams.

To view the teams that a member belongs to:

  1. Navigate to Account settings.
  2. Click into the Members tab.
  3. Filter the list of members for the member you're looking for.
  4. The "Teams" column lists the teams the members belongs to. There may be additional teams in the overflow menu. Click the overflow menu to view the Teams tab on that member's page. It has a complete list of that member's teams, and indicates if the member is a team maintainer for each team.
Maintained teams do not necessarily appear in the "Teams" column

Team maintainers are not members of the team, so the teams they maintain do not appear in the "Teams" column on the Members tab.