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

    EDIT ON GITHUB

    Managing teams

    Read time: 6 minutes
    Last edited: Mar 30, 2023
    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, Update a team

    Adding members to a team from the Members dashboard

    This is an Admin-only feature

    The bulk editing feature is only accessible if you're a LaunchDarkly Admin or Owner. To learn more, read Understanding member roles.

    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.
    The Members dashboard checkboxes
    The Members dashboard checkboxes
    1. Select all the members that you want to add to the teams. Next to the Export CSV button, another button appears that says Edit X members, where X 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.
    The Edit X members button
    The Edit X members button
    1. Click the "Edit x members" button and select the Add to teams option. A modal will appear.
    The Add to teams option
    The Add to teams option
    1. 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.
    The Add to teams option
    The Add to teams option

    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.

    A successful attempt
    A successful attempt

    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:
    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.