Last updated Jul 11, 2025

Jira Software Feature Flag Information Provider

The devops:featureFlagInfoProvider module allows Forge apps to send feature flag information to Jira and associate it with an issue.

Supplied feature flag information will be presented in the development panel of the issue it is associated with.

Feature flag information is written and deleted via the Jira Software REST API which can be accessed by Forge apps using the requestJira function.

When a user uninstalls an app, all the data that the app sent to Jira is deleted immediately. If the app is reinstalled, this data won't be added back unless the app resends historical information to Jira.

Example

1
2
modules:
  devops:featureFlagInfoProvider:
    - key: my-feature-flag-info-provider
      name:
        value: My Feature Flag Info Provider
      homeUrl: https://www.my-feature-flag.com
      logoUrl: https://www.my-feature-flag.com/logo.svg
      documentationUrl: https://www.my-feature-flag.com/help
      actions:
        createFlag:
          urlTemplate: https://www.my-feature-flag.com/create?issueKey={issue.key}&issueSummary={issue.summary}
        linkFlag:
          urlTemplate: https://www.my-feature-flag.com/link?issueKey={issue.key}

Properties

Property	Type	Required	Description
key	string	Yes	A key to identify this module.
name	object	Yes	A human readable name.
name.value	string	Yes	Min length: 1 Max length: 255
homeUrl	string	Yes	URL to the provider's homepage. Min length: 1 Max length: 255 Regex: `^(http\|https):\/\/.*$`
logoUrl	string	No	The logo for the provider, will be displayed in an area 16 by 16 pixels. Min length: 1 Max length: 255 Regex: `^(([^:/?#]+):)?(//([^/?#]))?([^?#])(\\\\?([^#]))?(#(.))?`
documentationUrl	string	No	Optional URL to documentation about the provider's Jira integration. Min length: 1 Max length: 255 Regex: `^(http\|https):\/\/.*$`
actions	Actions	No	Feature flag actions that can be performed by Jira users. Each action is optional (unless indicated otherwise). The absence of an action indicates that the action is not supported by the provider.

Actions

Property	Type	Required	Description
createFlag	Action	No	Action for creating a feature flag and linking it with a Jira issue. The given URL will be used on the Jira issue development panel. The "Create feature flag" button will redirect the user to the URL.
linkFlag	Action	No	Action for linking an existing feature flag to a Jira issue. The given URL will be used on the Jira issue development panel. The "Connect feature flag" button will redirect the user to the URL.

Property

Type

Required

Description

createFlag

Action

Action for creating a feature flag and linking it with a Jira issue.

The given URL will be used on the Jira issue development panel. The "Create feature flag" button will redirect the user to the URL.

linkFlag

Action

Action for linking an existing feature flag to a Jira issue.

The given URL will be used on the Jira issue development panel. The "Connect feature flag" button will redirect the user to the URL.

Action

Property Type Required Description

urlTemplate

string

Yes

Property	Type	Required	Description
urlTemplate	string	Yes	Defines the URL template that is used when an action is invoked. The following context parameters are supported: `{issue.key}`, `{issue.summary}`, `{issue.flags}` Min length: 1 Max length: 255 Regex: `^(http\|https):\/\/.*$`

Defines the URL template that is used when an action is invoked.

The following context parameters are supported: {issue.key}, {issue.summary}, {issue.flags}

Min length: 1

Max length: 255

Regex: ^(http|https):\/\/.*$