You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/pages/docs/releases/issue-tracking/jira.md
+8-3Lines changed: 8 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
layout: src/layouts/Default.astro
3
3
pubDate: 2023-01-01
4
-
modDate: 2025-04-03
4
+
modDate: 2025-06-06
5
5
title: Jira issue tracking
6
6
description: Configure Jira Cloud and Jira Server issue tracking with Octopus.
7
7
navOrder: 20
@@ -24,6 +24,11 @@ Octopus integrates with Jira issues. The integration includes the ability to:
24
24
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).
25
25
5. As the release is deployed to each environment, Octopus notifies Jira to update the issue.
26
26
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
+
27
32
:::figure
28
33

29
34
:::
@@ -54,7 +59,7 @@ The following steps explain how to integrate Octopus with Jira.
54
59
55
60
## Configure your build server to push build information to Octopus {#configure-your-build-server}
56
61
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.
58
63
59
64
To supply the commit messages:
60
65
@@ -217,7 +222,7 @@ Navigate to **Infrastructure ➜ Environments**, and next to each environment cl
217
222
218
223
### Ensure casing on issue/work item IDs match {#troubleshooting-check-case-on-ids}
219
224
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.
221
226
222
227
### Push build information before creating a release {#troubleshooting-push-build-info-first}
0 commit comments