Managing teams
Read time: 7 minutes
Last edited: Dec 20, 2024
Teams are only available to customers on select plans. To learn more, read about our pricing. To upgrade your plan, contact Sales.
Overview
This topic explains how to manage team members in LaunchDarkly.
Manage 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.
Add a member to an existing team
If you have an existing team and you want to add a member to it:
- Click the gear icon in the left sidenav to view Organization settings.
- Click Teams.
- Click on the name of a team to navigate to that team's page. The team's Team members tab appears.
- Click Add members. The "Add members" dialog appears.
- Select the members to add to the team.
- Click Add members.
You can also use the REST API: Add a member to teams, Update a team
Add members to a team from the Members dashboard
The bulk editing feature is only accessible if you're a LaunchDarkly Owner or Admin, or have a custom role that allows the updateTeamMembers
action. To learn more, read About member roles and Team actions.
To add members to an existing team:
- Click the gear icon in the left sidenav to view Organization settings.
- Click Members.
- Select the checkbox to the left of a member's name to choose that member.
- Select all the members that you want to add to the teams. Next to the Export CSV button, another button appears. It is labeled Edit N members, where N is the number of members that you selected.
- Alternatively, if you wish to select all the members, click the checkbox next to the Name column in the table.
- Click the Edit N members button and select the "Add to teams" option. A modal appears.
- 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.
Add 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:
- Click the gear icon in the left sidenav to view Organization settings.
- Click Teams.
- Click on the name of the team you want to add members to. The team's Team members tab appears.
- Click Upload CSV. The "Upload CSV" dialog appears:
- Click Select file. A prompt to choose a file appears.
- Choose a CSV file. You are returned to the "Upload CSV" dialog.
- 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.
Troubleshoot 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 message | Resolution |
---|---|
Unable to process file | LaunchDarkly could not process the file for an unspecified reason. Review your file for errors and try again. |
File exceeds 25mb | Break up your file into multiple files of less than 25mbs each. |
All emails have invalid formatting | None of the email addresses in the file are in the correct format. Fix the formatting and try again. |
All emails belong to existing team members | All 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 empty | The CSV file does not contain any email addresses. Populate the file and try again. |
No emails belong to members of your LaunchDarkly organization | None 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 Add members to LaunchDarkly. |
Troubleshoot 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 message | Resolution |
---|---|
Empty row | This line is blank. Add an email address and try again. |
Duplicate entry | This email address appears in the file twice. Remove the email from the file and try again. |
Email already exists in the specified team | This member is already on your team. No action needed. |
Invalid formatting | This email address is not formatted correctly. Fix the formatting and try again. |
Email does not belong to LaunchDarkly member | The 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 Add members to LaunchDarkly. |
Remove 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:
- Click the gear icon in the left sidenav to view Organization settings.
- Click Teams.
- Click on the name of the team you want to remove members from. The team's Team members tab appears.
- Find the member in the list of team members.
- Click the overflow menu at the right of the row of the member you want to remove.
- Select Remove member. A confirmation dialog appears.
- Click Remove member in the dialog to confirm.
To remove a member from a team using the Members page:
- Click the gear icon in the left sidenav to view Organization settings.
- Click Members.
- Find the member in the list. Optionally, use the "Team" filter to narrow the list.
- Click on the member's name.
- Click the Teams tab.
- Find the team that you want to remove this member from.
- Click the overflow menu at the right of the row of the team you want to remove the member from.
- Select Remove member. A confirmation dialog appears.
- Click Remove member in the dialog to confirm.
View an individual member's teams
Members of your organization can belong to multiple teams.
To view the teams that a member belongs to:
- Click the gear icon in the left sidenav to view Organization settings.
- Click Members.
- Filter the list of members for the member you're looking for.
- 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 any team.
Team maintainers may or may not be members of the team, so the teams they maintain may or may not appear in the "Teams" column on the Members tab.