Skip to content

Commit 48a7310

Browse files
authored
Add branch name parsing to jira integration docs (#2740)
1 parent 98e3a31 commit 48a7310

File tree

1 file changed

+8
-3
lines changed
  • src/pages/docs/releases/issue-tracking

1 file changed

+8
-3
lines changed

src/pages/docs/releases/issue-tracking/jira.md

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
layout: src/layouts/Default.astro
33
pubDate: 2023-01-01
4-
modDate: 2025-04-03
4+
modDate: 2025-06-06
55
title: Jira issue tracking
66
description: Configure Jira Cloud and Jira Server issue tracking with Octopus.
77
navOrder: 20
@@ -24,6 +24,11 @@ Octopus integrates with Jira issues. The integration includes the ability to:
2424
4. When creating the release which contains the package version, the issues are associated with the release. These are available for use in [release notes](/docs/packaging-applications/build-servers/build-information/#build-info-in-release-notes), and will be visible on [deployments](/docs/releases/deployment-changes).
2525
5. As the release is deployed to each environment, Octopus notifies Jira to update the issue.
2626

27+
:::div{.hint}
28+
From 2025.3 the Jira issue-tracker extension in Octopus will parse both commit messages and branch names for Jira issue references.
29+
:::
30+
31+
2732
:::figure
2833
![Octopus release with Jira issues](/docs/releases/issue-tracking/images/octo-jira-release-details.png)
2934
:::
@@ -54,7 +59,7 @@ The following steps explain how to integrate Octopus with Jira.
5459

5560
## Configure your build server to push build information to Octopus {#configure-your-build-server}
5661

57-
To integrate with Jira issues, Octopus needs to understand which issues are associated with a [release](/docs/releases). Octopus does this by inspecting commit messages associated with any packages contained in the release.
62+
To integrate with Jira issues, Octopus needs to understand which issues are associated with a [release](/docs/releases). Octopus does this by inspecting commit messages and branch names associated with any packages contained in the release.
5863

5964
To supply the commit messages:
6065

@@ -217,7 +222,7 @@ Navigate to **Infrastructure ➜ Environments**, and next to each environment cl
217222

218223
### Ensure casing on issue/work item IDs match {#troubleshooting-check-case-on-ids}
219224

220-
The commits that are pushed to Octopus as build information need to have the exact same case as the issue/work item found in Jira. For example, if the work item in Jira is `OBJ-123`, but your commit message includes the work item as `obj-123` (notice the lower-case value) you will need to remediate the case in your commits. This will allow the deployment status update to appear in Jira successfully.
225+
The commits that are pushed to Octopus as build information need to have the exact same case as the issue/work item found in Jira. For example, if the work item in Jira is `OBJ-123`, but your commit message or branch name includes the work item as `obj-123` (notice the lower-case value) you will need to remediate the case in your commits. This will allow the deployment status update to appear in Jira successfully.
221226

222227
### Push build information before creating a release {#troubleshooting-push-build-info-first}
223228

0 commit comments

Comments
 (0)