Managing team permissions

Overview

This topic explains how to add and remove permissions from teams.

If you have an Owner / 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.

How team roles interact with individual member roles

Every organization using LaunchDarkly is made up of members. Members are people who work for your organization or use your organization's LaunchDarkly account. Every member must be individually assigned either one of LaunchDarkly's built-in roles or a custom role. To learn more, read Built-in roles and Custom roles.

Organizations use custom roles to gain more precise control over their feature flags, experiments, or LaunchDarkly administration. Custom roles are the granular permission scopes that an administrator can set up for their organization. An individual member may have a custom role. To learn more, read Custom roles.

If a member belongs to one or more teams, a member's roles, which includes either a built-in role or custom roles, will aggregate with the custom roles that are applied to their teams. Adding a member with a built-in Admin role will not affect their permissions. Those roles can perform all actions in LaunchDarkly.

A team can have one or more custom roles assigned to it. In cases where a team's custom roles have conflicting permission levels, or a team's custom role has conflicting permission levels with the permissions assigned to a member of that team, the more permissive set of permissions will be applied. For example, if a team has one custom role that allows access to a resource, and a member of that team has another custom role that restricts access to a resource, the team member will be able to access that resource.

Add 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. Click the gear icon in the left sidenav to view Organization settings.
2. Click Teams.
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.

Remove a custom role from a team

To remove a custom role from a team:

1. Click the gear icon in the left sidenav to view Organization settings.
2. Click Teams.
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.