LaunchDarkly Developer Documentation

Get started in under 30 minutes.
LaunchDarkly provides feature flags as a service for Java · Python · Ruby · Go · Node.js · PHP · .NET. Control feature launches -- who sees what and when -- without multiple code deploys. Easy dashboard for phased rollouts, targeting and segmenting.
Need more help? write us at

Get Started    Documentation

Custom roles

This feature requires an enterprise plan

Custom roles are only available to customers on our enterprise plans.

To learn more about enterprise plans, contact


This topic explains what custom roles are and how to create them.

Custom roles give you fine-grained access control to everything in LaunchDarkly, from feature flags to goals, environments, and teams. With custom roles, it's possible to enforce access policies that meet your exact workflow needs.


LaunchDarkly's role-based permission system provides global access control levels for team members based on a set of built-in roles. The built-in roles are:

  • reader
  • writer
  • admin / owner

If you're on an enterprise plan, you can also create flexible policies that cut across your entire project called custom roles.

With custom roles, you can:

  • Restrict view access for a project to a group of members. This has the effect of locking the project to only the members you specify. If a member cannot view a project, they cannot modify or configure any of the resources within it, including feature flags.
  • Lock your production environment down to a small set of trusted users
  • Differentiate infrastructure-level feature flags (controlled by your devOps team) from experiments (controlled by product management or marketing)
  • Allow team members to control feature flags on environments that are designated for their team only

Our custom role system is inspired by AWS Identity and Access Management (IAM), so if you're familiar with IAM, you'll see a few similarities.

Using custom roles

Implementing custom roles is a three step process. You must create the role itself, define actions that role can and cannot take by writing a policy, and finally give the role to one or more users.

To implement a custom role:

  1. Create a custom role
  2. Create one or more policies for that custom role
  3. Give one or more users that custom role

To learn more, read Configuring custom roles.

Custom roles are extremely configurable. The other topics in this section give more details about writing custom roles and the policies that power them.

To learn more about configuring custom roles, read the following topics:

Custom roles

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.