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

GIVE DOCS FEEDBACK

Flag links

Read time: 5 minutes
Last edited: May 01, 2024

Overview

This topic explains how to create and use flag links to view external mentions of flags from other tools and services. Links to external conversations and references to your flags allow you to collaborate more easily and quickly review relevant flag information.

You can create flag links automatically using Slack, Jira, and Trello integrations. You can also create them manually using a URL to any system, tool, or site you wish.

There are four types of flag links:

  • URL flag links
  • Slack flag links
  • Jira flag links
  • Trello flag links
  • GitHub flag links

You can create URL flag links by associating an external URL with a feature flag.

To create a URL flag link:

  1. From the flags list, click on the name of the flag you want to follow. The flag targeting page opens.
  2. Click the + icon in the "Links" section of the right sidebar. The "Add link to flag" dialog appears.
  3. Enter the URL for the external resource you're linking the flag to.
  4. (Optional) Enter a title and description for the link.
  5. Click Save. The linked resource appears in the "links" section.

You can also use the REST API: Flag links

Slack flag links require the LaunchDarkly Slack app integration

The LaunchDarkly Slack app integration is required to use Slack flag links. To learn how to set up the integration, read Slack.

The LaunchDarkly Slack app automatically creates flag links when a flag's URL is mentioned in a public Slack channel. You can access the Slack conversation in LaunchDarkly on the flag's targeting page.

Additionally, you can manually associate a Slack conversation in a public channel with a flag using a flag link message shortcut.

To link a flag to a conversation in Slack:

  1. In Slack, locate the conversation you want to reference.
  2. Click more actions:
The "More actions" menu for a Slack conversation.
The "More actions" menu for a Slack conversation.
  1. Click More message shortcuts... The "Use a shortcut" screen opens.
  2. Enter "Create flag link" into the search field.
  3. Click Create flag link. The "Create flag link" screen opens.
  4. Select the project name and flag you would like to associate with the conversation:
The Create flag link menu.
The Create flag link menu.
  1. Click Create.

You can now view the Slack conversation on the flag's targeting page.

Jira flag links require the LaunchDarkly Jira Cloud integration

The LaunchDarkly Jira integration is required to use Jira issue flag links. To learn how to set up the integration, read Jira Cloud.

When you connect a feature flag to a Jira issue, LaunchDarkly automatically creates a flag link. To learn more, read Connect an existing feature flag to a Jira issue from LaunchDarkly.

After you connect a feature flag to a Jira issue, you can view the issue on the flag's targeting page.

Trello flag links require the LaunchDarkly Trello integration

The LaunchDarkly Trello integration is required to use Trello flag links. To learn how to set up the integration, read Trello.

When you attach a feature flag to a Trello card, LaunchDarkly automatically creates a flag link. To learn more, read Add feature flags to Trello cards.

After you connect a feature flag to a Trello card, you can view the Trello card on the flag's targeting page.

GitHub flag links require the LaunchDarkly Find Code References in Pull Request GitHub Action

The LaunchDarkly Find Code References in Pull Request integration is required to use GitHub flag links. To learn how to set up the integration, read Find Code References in Pull Request.

After you configure the LaunchDarkly Code References in Pull Request GitHub Action, LaunchDarkly automatically creates a flag link when you modify a flag in a pull request. To learn more, read Find Code References in Pull Request.

When LaunchDarkly detects a feature flag change in a pull request, you can navigate to the flag's targeting page to access the link.

To delete a flag link, click the trash can icon next to the link:

A flag link with the delete icon called out.
A flag link with the delete icon called out.