No results for ""
EXPAND ALL
  • Home
  • API docs

Tags

Read time: 4 minutes
Last edited: Oct 02, 2024

Overview

This topic explains how to use tags with LaunchDarkly resources. Tags are customizable labels that help you categorize flags, segments, metrics, projects, environments, and other resources.

Tags are useful in the following ways:

  • Categorizing: You can add the same tag to different kinds of resources. This lets you easily understand which resources are associated with which projects or teams.
  • Filtering: You can filter the Flags list, environments list, and projects list by tag.
  • Permissions: You can allow or deny account members access to resources with specific tags. To learn how to use tags with custom role policies, read Using tags.

Tag names can include only letters, numbers, periods ., underscores _, and dashes -. You can add tags to a resource when you create the resource, or you can add tags to existing resources later. The following sections explain how to add tags to existing resources.

Flags

To add tags to a flag:

  1. Navigate to the Flags list.
  2. Click on the name of the flag you want to add tags to. The flag's targeting page appears.
  3. Click on the pencil icon in the "Tags" section of the right sidebar. The "Choose tag(s)" list appears.
  4. Create a new tag or select a tag from the list.

To learn how to add tags to flags when you create them, read Creating new flags.

You can also use the REST API: Update feature flag

Filter the Flags list by tag

You can filter the Flags list by one or more tags.

To filter your flags:

  1. Click Filters.
  2. Select Add tag(s).
  3. Search for or select a tag from the list.

Your Flags list now displays only the flags that match the filter you specified.

Segments

To add tags to a segment:

  1. Navigate to the Segments list.
  2. Click on the name of the segment you want to add tags to. The segment's Targeting page appears.
  3. Click on the pencil icon in the "Tags" section of the right sidebar. The "Choose tag(s)" list appears.
  4. Create a new tag or select a tag from the list.

To learn how to add tags to segments when you create them, read Creating segments.

You can also use the REST API: Patch segment

Metrics

To add tags to a metric:

  1. Navigate to the Metrics list.
  2. Click on the name of the metric you want to add tags to. The metric details page appears.
  3. Click on the pencil icon in the "Tags" section of the right sidebar. The "Choose tag(s)" list appears.
  4. Create a new tag or select a tag from the list.

To learn how to add tags to metrics when you create them, read Metrics.

You can also use the REST API: Patch metric

Projects

To add tags to a project:

  1. Click the project dropdown. The project menu appears:
The project menu.
The project menu.
  1. Select Project settings. The General list appears.
  2. Under Tags, click Add tags.
  3. A menu with the list of tags appears.
  • To add existing tags to your project, check the checkbox next to one or more tags in the list.
  • To add a new tag to your project, type the new tag into the search box. Then check the checkbox next to "Create new tag."

To learn how to add tags to projects when you create them, read Create projects.

You can also use the REST API: Update project

Filter the projects list by tag

You can filter the projects list by tag.

To filter your projects:

  1. Click the gear icon in the left sidenav to view Organization settings.
  2. Click Projects.
  3. Select a tag to filter by from the Tags menu.

Your projects list now displays only the projects that match the tag you specified.

Environments

To add tags to an environment:

  1. Click the project dropdown. The project menu appears:
The project menu.
The project menu.
  1. Select Project settings.
  2. Select Environments. The Environments list appears.
  3. Next to the environment you want to add tags to, click the three-dot overflow menu.
  4. Select Edit environment.
  5. Select or create a new Tag.
  6. Click Save environment.

To learn how to add tags to environments when you create them, read Create environments.

You can also use the REST API: Update environment

Filter the environments list by tag

You can filter an environments list by tag.

To filter your environments:

  1. Click the project dropdown. The project menu appears:
The project menu.
The project menu.
  1. Select Project settings.
  2. Select Environments. The Environments list appears.
  3. Select a tag to filter by from the Tags menu.

Your environments list now displays only the environments that match the tag you specified.