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

GIVE DOCS FEEDBACK

Flag links

Read time: 4 minutes
Last edited: Mar 04, 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. Find the feature flag you want to add a link to on the flags list.
  2. Click the flag's name. The flag's Targeting page opens.
  3. Click the Links tab.
  4. Click Add link. The "Add link to flag" screen appears:
The "Add link to flag" screen.
The "Add link to flag" screen.
  1. Enter the URL for the external resource you're linking the flag to.
  2. (Optional) Enter a title and description for the link.
  3. Click Save. The modal closes and the linked resource appears underneath the date you created the link.
A custom flag link on a flag's "Links" tab.
A custom flag link on a flag's "Links" tab.

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 Links tab.

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 Links tab.

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 Connecting an existing feature flag to a Jira issue from LaunchDarkly.

After you connect a feature flag to a Jira issue, you can navigate to the flag's Links tab to access the link.

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 Adding feature flags to Trello cards.

After you connect a feature flag to a Trello card, you can navigate to the flag's Links tab to access the link.

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 Links tab 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.