Azure Git Listener Documentation

Installation

Azure Git Listener is available for all Jira Cloud installations. To install the app, sign in to your Jira account, open the Azure Git Listener for Jira page on the Atlassian Marketplace, and click Install.

Configuration

After installation, you will be prompted to configure Azure Git Listener.
You can also access the configuration page at any time by navigating to your organization’s app management page, selecting the appropriate Atlassian site, and opening the Connected apps section. Locate Azure Git Listener in the list of installed apps, click the three-dot menu on the right, and select Configure.

To link your Azure repositories to Jira, select your Azure DevOps instance type (Cloud or Self-hosted), enter your Personal Access Token (PAT), and click Save. The token must include Code (Read) permissions and be scoped to All accessible organizations.

Azure Git Listener will automatically detect all Git repositories that your Microsoft account can access and display them on the configuration page. From there, you can choose which repositories should be linked to Jira and view when each repository was last checked for updates.

If you need to update or replace your Personal Access Token, simply return to the Azure Git Listener configuration page and update your integration settings.

Using Azure Git Listener for Jira

Once configuration is complete, Azure Git Listener is ready to use. Open any issue in your Jira project and you will see the Azure Git panel on the right-hand side of the issue view.

Expanding the panel displays all Git commits, branches, and pull requests associated with the Jira issue. Linking is performed using issue keys (for example, PROJ-123). To ensure items are detected correctly, include the issue key in your commit messages, pull request titles, or branch names.

Further information

If you have any questions or need assistance, please contact us via our feedback form.