Forums

Articles
Create
cancel
Showing results for 
Search instead for 
Did you mean: 

Is it necessary to update the story’s Fix Version if a related bug is fixed in a later patch release

Shehan Sandeepa May 29, 2025

Hi everyone,

I’d like to clarify a versioning question in Jira from a development and release management perspective.

We recently released a story as part of Fix Version 1.1.0. During QA verification, a bug related to that story was identified. We fixed the bug and included it in a patch release (Fix Version 1.1.1).

Our current approach is:

Keep the story’s Fix Version as 1.1.0, since that’s when the planned feature work was completed and released.

Assign the bug’s Fix Version as 1.1.1, reflecting the version where the unplanned fix was delivered.

However, there is an another perspective from my friend that we should also add 1.1.1 to the original story’s Fix Version, since the functionality wasn’t “complete” until the bug was resolved.

In my opinion, doing so could confuse release tracking and misrepresent what was actually delivered in 1.1.0. Bugs are part of the software lifecycle and are usually tracked and fixed separately without altering the original delivery story.

So my questions are:

  • Is it considered best practice to keep the story's Fix Version as 1.1.0 and only assign 1.1.1 to the bug?
  • Are there valid scenarios where adding 1.1.1 to the story is justified?
  • How do most teams handle this kind of situation while maintaining clean and accurate release reporting?

Would love to hear your thoughts or any official guidance from Atlassian.

Thanks in advance!

1 answer

1 accepted

4 votes
Answer accepted
Shawn Doyle - ReleaseTEAM
Community Champion
May 29, 2025

Hi @Shehan Sandeepa 

I would agree with you, and not update the original story. That story was delivered with the best intentions of completing the work item, the related bug fix and delivery should be tracked separately. 

 

Bill Sheboy
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
May 29, 2025

Hi @Shehan Sandeepa -- Welcome to the Atlassian Community!

Yes, and...to the suggestion from Shawn:

Perhaps consider using issue linking to associate the story and any defects found / fixed later.  That would enable analysis by the team to learn how they could improve to prevent such defect types later.

Kind regards,
Bill

Like # people like this
Shehan Sandeepa May 29, 2025

Hi @Shawn Doyle - ReleaseTEAM ,

Thanks a lot for your insight, really appreciate the confirmation!

It's reassuring to know that keeping the original story’s Fix Version as 1.1.0, while assigning 1.1.1 only to the bug fix, is in line with best practices. This separation definitely helps keep our release records clean and avoids confusion during post-release analysis.

Grateful for your support in clearing this up!

Shehan Sandeepa May 29, 2025

Hi @Bill Sheboy ,

Thank you for the warm welcome and for building on Shawn’s suggestion!

We’re actually already practicing issue linking between stories and any related defects, and I completely agree that it’s a great way to maintain traceability and support team learning during retrospectives. It’s reassuring to hear we’re on the right track.

Appreciate your input and support!

Like Bill Sheboy likes this

Suggest an answer

Log in or Sign up to answer