Overview

This topic explains how to change the built-in and custom roles assigned to members in LaunchDarkly.

Change individual member roles

To change an individual member’s roles, first find the member:

  1. Click the gear icon in the left sidenav to view Organization settings.
  2. Click Members. The Members list appears.
  3. Find the account member you wish to give a custom role.
  4. Click that account member’s name. The member’s Access tab opens.

To add an additional role to this member:

  1. In the “Assigned directly” table, click Assign access. The “Assign access” dialog appears:

A member's "Assign access" dialog.

A member's "Assign access" dialog.
  1. Choose the additional role that you want to assign. Choose a built-in project role, or choose Custom.
  2. If you choose Custom, a menu containing your organization’s custom roles appears. Choose the custom role you wish to give the member.
  • If the custom role includes a role attribute, enter a value. For example, if the custom role includes a project role scope with a role attribute of developerProjectKey, enter a project key in the Resources field:

    A member's "Assign access" dialog, with a role attribute and resource specified for the custom role being assigned to this member.

    A member's "Assign access" dialog, with a role attribute and resource specified for the custom role being assigned to this member.
  1. Click Assign access. The member’s access is updated.

To change an existing role assigned to this member:

  1. In the “Assigned directly” table, find the role that you want to change.
  2. Click the three-dot overflow menu next to that role.
  3. Select Edit access. The “Assign access” dialog appears:

A member's "Assign access" dialog.

A member's "Assign access" dialog.
  1. Select a different role for the member, or update the existing role:
  • Choose a different built-in project role, or choose Custom. Follow the procedure above to add a new role to this member, starting at step 3.

  • If an existing custom role includes a role attribute, you can update the resource for that role attribute without changing the custom role. For example, if the custom role includes a project role scope with a role attribute of developerProjectKey, enter a new project key in the Resources field, or click the x to remove an existing project key:

    A member's "Assign access" dialog, with a role attribute and resource specified for the custom role being assigned to this member.

    A member's "Assign access" dialog, with a role attribute and resource specified for the custom role being assigned to this member.
  1. Click Assign access. The member’s access is updated.

You can also use the REST API: Modify an account member

Change multiple members’ roles

Changing multiple members' roles is an Admin-only feature

This feature is only accessible if you’re a LaunchDarkly Owner or Admin, or have a custom role that allows the updateCustomRole action. To learn more, read About member roles and Member actions.

To change multiple members’ roles:

  1. Click the gear icon in the left sidenav to view Organization settings.
  2. Click Members. The Members list appears.
  3. Select the checkbox to the left of a member’s name to choose that member. Select all members whose roles you wish to edit. Alternatively, if you wish to select all the members, click the checkbox next to the Name column in the table.
  4. Next to the Export CSV button, another button appears that says Edit N members, where N is the number of members that you selected:

The "Edit N members" button.

The "Edit N members" button.
  1. Click the Edit N members button and select the “Edit member roles” option. A dialog appears.

The "Edit member roles" option

The "Edit member roles" option
  1. Select one of the built-in roles or any existing custom role and click Replace role. LaunchDarkly attempts to replace any of the roles on the members that you selected to the new role(s). Roles that have been assigned at the team level do not change.

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.

Built with