Managing teams

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.

Adding members to a team from the Members dashboard

To add members to an existing team:

1. Navigate to Account settings and click into the Members tab.
2. Select the checkbox to the left of a member's name to choose that member.
3. Select all the members that you want to add to the teams. Next to the Export CSV button, another button appears that says Edit N members, where N is the number of members that you selected. 3a. Alternatively, if you wish to select all the members, click the checkbox next to the Name column in the table.

5. Click the Edit N members button and select the "Add to teams" option. A modal appears.
6. Select one or multiple teams from the input field and then click Add members to teams. LaunchDarkly attempts to add each of the selected members to the selected teams.

When you select all members, the number of members may not match the number of members that appears at the top of the Members tab. This happens because you cannot perform bulk edit actions on yourself or the owner of the account.

Adding members in bulk to an existing team from a CSV

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:

5. Click Select file. A prompt to choose a file appears.
6. Choose a CSV file. You are returned to the "Upload CSV" dialog.
7. Click Upload file.

A success indicator appears with the number of team members successfully added to your 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:

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:

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.

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.