Why flagging Jira issues is so cool?

Adding a flag to an issue is a cool way to say it is blocked. Also, you can add a comment as part of the same action from a board. But what if you want to do the same from the issue detail view?

This article will guide you through the usage of flags and will provide a native solution to emulate the feature of adding a flag along with a comment from the issue detail view.

 

In this article

  • The two native ways to add a flag
  • What makes flags so cool?
  • Blocked status vs adding a flag
  • Building a solution to flag & comment from the issue detail view

 

The two native ways of adding a flag

First things first, how can you add a flag to an issue?

Natively, there are two ways of adding a flag to an issue.

Adding a flag from the issue detail view

For adding a flag from the issue detail view, just click on the ellipsis button [...] > Add flag on the top-right corner:

add-flag-issue-detail-view.png

This will just add a flag with no way of adding a comment as part of the same action, unlike when you add a flag from a board.

Adding a flag from a board

For adding a flag from a board, either a Kanban or a Scrum one, right-click a card > Add flag:

add-flag-board.png

Note this time a dialog will pop-up so that you can also add a comment along with the flag, explaining why the issue is blocked:

add-flag-dialog.png

A flagged issue is highlighted to easily detect it among unflagged issues:

flagged-card.png

But hey! That's not all! The comment added through the previous dialog is also included to the issue detail view and is also marked with a flag at the begining of the comment:

flagged-comment.png

 

What makes flags so cool?

Flagging an issue is a cool way to say it is blocked:

  • Flags look great on a board and the card gets a convenient background color which makes them highlighted and easier to detect, so that someone takes action to remove this impediment.

  • Adding a flag from a board allows to add a comment which will also be marked with a flag. Suggesting to add a comment improves the chances that the user explains why the issue is blocked.

  • Flagged issues are searchable in JQL:
    flagged = Impediment

    And this is for finding issues without a flag:
    flagged is EMPTY

    Not to confuse with flagged != Impediment wich always returns no issues!
    This is because in != means "with a value distinct from", and there is no value in that field for unflagged issues; it is empty instead.
  • Flags allow to quickly see the status where an issue became blocked.

 

Blocked status vs adding a flag

Blocked status advantages

Reporting the time an issue was blocked is an easier task if you use the Blocked status instead of a Flag.

Furthermore, the Jira native field Status also supports powerful JQL operators like WAS and CHANGED, which are useful for several use cases.

Flag advantages

On the other hand, flagging an issue does not produce its status to change, so you can still quickly see where in the workflow the issue became blocked.

This fact provides the advantage that you can know which of your blocked issues is more likely to be completed with less additional effort.

Besides of that, it also means that you need one less column on your board, reducing the likelihood that you have to use the horizontal scrollbar.

From the Jira Admin perspective, the usage of Flags is better than transitioning to the Blocked status, since the very same workflow will then be valid both for users who want to mark issues as blocked as well as for users who don't.

Conclusion

The Blocked status advantages rely on configuring anything else.

You get the Flag advantages merely by using them, with no need for configuring anything else.

Also, I have noticed quite oftenly than a Blocked column tends to be set aside, so that those blocked issues don't disturb the vision of issues in which users can continue working, with the risk of forgetting about them.

Blocked issues should be highlighted to see if there is anything that could be done to unblock them.

In my opinion, Flags are better than transitioning to the Blocked status unless there's a very specific requirement to think otherwise.

 

Building a solution to flag & comment from the issue detail view

The step by step solution is described in this article!

Thanks for reading!

19 comments

Jérémy B_ November 27, 2021

Thanks for this article ! Especially pros for each options

Like Ignacio Pulgar likes this
Walter Buggenhout
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
November 28, 2021

Totally agree that the most important advantage of using flags is that you can see where in the process an issue is blocked. As an additional benefit of using flags instead of a blocked status - in properly built workflows - is that you don't need to provide paths to several different statuses to unblock an issue. When an impediment gets resolved, all you need to do is remove the flag. 

Like # people like this
Avinash Bhagawati _Appfire_
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
November 29, 2021

Hi @Ignacio Pulgar ,

Thanks for this article!

Like Ignacio Pulgar likes this
Alexander Bondarev
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.
November 30, 2021

@Ignacio Pulgar , thanks for the well structured article. I think it will be useful to many! 👍

Like Ignacio Pulgar likes this
Jack Nolddor _Sweet Bananas_
Marketplace Partner
Marketplace Partners provide apps and integrations available on the Atlassian Marketplace that extend the power of Atlassian products.
December 3, 2021

Thanks for sharing @Ignacio Pulgar !
Hope you are doing well mate, we miss you a lot.

Like Ignacio Pulgar likes this
Ignacio Pulgar
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.
December 3, 2021

Hey @Jack Nolddor _Sweet Bananas_ !

Long time no see! I miss you all as well!

We should go for a beer one of these days.

Hugs!

Jette Jepsen January 19, 2022

A helpfull description. 

I just have one questions from my users - How can I see in Issue search that an issue is flagged?

I can find the Impediment, however it would be mush nicer if the issue search also colored the line as in backlog.

Do you know whether this is possible?

I am running a data server version

BR Jette 

Ignacio Pulgar
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.
February 1, 2022

Hi @Jette Jepsen ,

Highlighting the row of a flagged issue in the Issue Navigator is not doable natively.

Theoretically, it would be possible to achieve that behavior in Data Center, provided the Flagged field where shown as a column in the Issue Navigator. However, please note this would be a workaround and a bad pratice which may result in unexpected bugs and glitches popping-up.

Potential solutions to be researched further could be based on any of these approaches, which are based on somehow injecting your own JavaScript and/or CSS:

  • Add custom JavaScript and/or CSS to the Announcement Banner (executed for all users). See this example on how to inject your custom code. This code would be executed for all users in your instance.
  • Inject JavaScript and/or CSS just on your own web browser by installing an extension for that purpose. Custom JavaScript and/or CSS would need to be added as well. One popular browser extension for Chrome is Tampermonkey.
  • Possibly too, inject JavaScript and/or CSS through Script Fragments (requires ScriptRunner).

Please, note these kind of changes are not recommended at all.

Best regards

Like Jette Jepsen likes this
Jette Jepsen February 1, 2022

Hi @Ignacio Pulgar 

Thank you very much for your answer. I'll report back to the requestor that there is no recommended solution  

Best regards

Like Ignacio Pulgar likes this
Dylan Davis February 3, 2022

Hi @Ignacio Pulgar,

When adding a flag via the context menu, using the little comment box which pops up, it doesn't correctly display special HTML characters when viewing the comment later on the issue. For example, flagging an issue with the following comment using that menu: "I'm unable to progress with this task." would be displayed on the issue as "I'm unable to progress with this task.".

As we're on a JIRA free plan, we don't have a dedicated support line, so I hope it's okay to raise with you here.

Kind Regards,

Dylan

Ignacio Pulgar
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.
February 15, 2022

Hi @Dylan Davis ,

That's a known bug: https://jira.atlassian.com/browse/JRACLOUD-76549

Feel free to watch it.

Regards

Mubashir paray April 3, 2022

can we use flag feature in jira work management!

Like Giovanni Giazzon likes this
Ignacio Pulgar
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.
April 4, 2022

@Mubashir paray the flag feature is only available in Jira Software boards at the moment.

Giovanni Giazzon June 14, 2022

+1 to have this feature in Jira Work Management

Like # people like this
Mike Alexander January 13, 2023

It would also be great to have the same yellow highlighting in Epics (see JRACLOUD-73999), filter search results, and Jira query tables in Confluence.

My one frustration is that the Priority icon is replaced by a red flag icon in board and backlog views such that I have to view the issue to determine the priority.

Like Ignacio Pulgar likes this
CC January 30, 2023


Is it possible to query the date the flag was added and the the person who added the flag?

Also we have a use case for a follow up date?  The person who added the flag wants a reminder notification of the issue?

Ignacio Pulgar
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.
January 31, 2023

Hi @CC ,

Here you have one potential way for covering that requirement:

  1. Create a custom field named Flagged by of "User Picker (single user)" type.
  2. Create a global automation rule with the following logic:
    • Trigger: Field changed: select the Flagged field for all issue operations.
    • Condition: If-else condition
      • IF block - Add condition: Field Condition > If Flagged is empty
        • Action: Edit Field > Flagged by > None (clear the field value)
      • ELSE block (if the issue is flagged)
        • Action: Edit Field > Flagged by > User who triggered the event
  3. Create a filter with this JQL: "Flagged by" = currentUser()
    Save the filter with the name "Flagged by me".
    Share the filter with your Organization.
    Let user(s) know that they can subscribe to that filter.

Hope it helps.

Like Maryna KAZAKOVA likes this
Björn Eriksson February 16, 2023

Very good article!

Like Ignacio Pulgar likes this
Maciej Wojciechowski September 26, 2023

Especialy that you cant search with jql for items that were flagged.
Only for those that current have or not have a flag.
So good by metric about blocked items!

If you want to have some visual representation and (for some reason) don't want to use blocked column (or even if you want to) you can change card color for status in board settings. 


Like Ignacio Pulgar likes this

Comment

Log in or Sign up to comment
TAGS
AUG Leaders

Atlassian Community Events