Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

Unlock the power of search with the new JQL editor


Hi All!

We’re excited to share the launch of a new issue search experience in Jira that makes pulling data more intuitive, effective, and faster for teams. Today, customers use Jira Query Language (JQL) to create tailored views of issues for dashboards, reporting, and more. Our recent updates to JQL editor make it easier for any team to dive deep into data, and build powerful searches. 


πŸ– Fix errors in real time

The new JQL editor is now faster, and can validate syntax on the fly. We also included messages that highlight errors in red, with detailed information on how to fix them!



βœ… After βœ…


🎨 Search with smart syntax highlighting

When writing JQL queries, users used to see long strings of text. The new JQL editor helps you build queries in real time by analyzing your query structure, identifying entity types, and highlighting them as you type. This makes queries more readable, and easier to edit as you write.




βœ… After βœ…


πŸ€“ Build queries with enhanced autocomplete

We’ve improved the autocomplete experience to give more helpful feedback as you type. The editor shows keywords and functions at the top, while providing an indicator of the data loading in the background.


Jul-15-2021 16-50-42.gif

βœ… After βœ…

Jul-15-2021 16-51-15.gif

πŸ“– Expand the editor for longer queries

Now you can expand and collapse the editor to allow space for editing multiline queries. New numbered lines make it easier to read the query, and find where potential errors are. Plus, we’ve included onscreen instructions to let you know to add a new line as you type (Shift+Enter).



βœ… After βœ…


πŸ‘‹πŸΌ See coworkers instead of user ids

Some time ago we had to change the way user names are shown in JQL to comply with GDPR, which resulted in users being represented as account identifiers. The new JQL editor can now recognize these entities and replace them with a more visual representation, while keeping the underlying JQL query untouched, and PII free! Now you can see usernames in search, and we even added icons!



βœ… After βœ…


πŸ”Ž Search across multiple projects

In addition to the new JQL editor, we’ve enhanced issue search at the project level with an improved project selector. Now you can stay within the project view to search outside your immediate project, across your whole Jira instance. This is especially helpful for people who work across multiple projects.



βœ… After βœ…


Watch our demo!

Want a quick video run through of these updates? Look no further! See the tools in action from our very own Kyle Painter. 



πŸ“¬ Share your feedback

We are committed to improving the issue search experience, and would love to hear your feedback in comments section of the post below!


When will this feature come to "Advanced search"?

We are iteratively improving the issue navigator and it will replace Advanced search sometime in 2022, To stay updated on the latest, please watch this ticket.

Is this available in server or data center?

We are afraid this feature is being released to Jira cloud only

Where can I find the new JQL editor?

Company managed project (formerly classic projects)

You can find the new editor in the issue navigator under the Issues item in your project side bar.

Team managed project (formerly next-gen projects)

Enable the issue navigator via the features page under team-managed project settings. After you have enabled the issue navigator, Issues will appear in the project sidebar on the left.


Pavel Junek Community Leader Jul 15, 2021


So this looks really great. JQL Editor already needed such a change :)

Like β€’ # people like this

Thank you @Pavel Junek many more improvements are coming to issue search, watch this ticket for details smile

Like β€’ # people like this

Nice one, any plans of making it available in Advanced Search outside of project view?

Like β€’ # people like this

Hi @Daniel Turczanski - __JQL Search Extensions , Yes! New issue navigator(with new JQL editor) will replace advanced search next year - stay tuned for the latest updates here  

Like β€’ # people like this
Jack Brickey Community Leader Jul 15, 2021

Nice! This area was long overdue for some attention so thanks thanks thanks!!

Like β€’ # people like this

Great visual enhancements but wish we could've received new JQL functions to provide more search capabilities like searching within ALL epics and responding back with epics that have All their stories completed.  Tired of fighting for a company to buy extra add-ons for basic excel functionality.

Like β€’ # people like this

Hi @Jack Brickey , thank you for the comment and very true - we were excited to attack one of the areas of Jira that has not been touched in a while.


@Colton_Kosicek thank you for your feedback, that's a fair point. We are aware of this concern but I am afraid we do not have immediate plans to attack this now. It will be prioritised together with other feature requests for search and JQL. 

This looks amazing! 🀩 

Is there any chance this new JQL search can be used by your Atlassian marketplace partner apps as well? Maybe as an Atlaskint component or npm module? πŸ™ Thank you!

Like β€’ # people like this


Will this functionality be extended to the Advanced Search window too?

Like β€’ # people like this

Hi @Nikki Zavadska _jexo_ , thank you for sharing the excitement :) We do have a standing feature request to extend a new JQL editor to marketplace apps. It's currently prioritised together with other feature request, I am afraid I do not have a timeline I could share with you at this point.


Thank you @David Bakkers Yes, yes and yes! 🎯 We are building a new and better advanced search. And there are still a few things we need to build, but this new JQL experience will be rolled out to Advanced search next year among other things. Follow this ticket for more details smile

Like β€’ # people like this

Finally we can see the names of searched people in JQL ;)

Like β€’ # people like this

How do you get statuses to show up as red?

Hi @Markus , thank you for your question, I am afraid we currently do not show statuses in red colour in JQL. 

@Yerbol Nisanbayev  Why is it in the screenshot then? "closed" is in red?

Hey @Markus - thank you for catching that, the colours on the screenshot were wrong, fixed it now. 

@Yerbol Nisanbayev When will this be a feature? I would love having closed and other statuses show in red. It seems like you may be testing internally, so maybe soon.

Jack Brickey Community Leader Jul 29, 2021

Regarding @Markus request, please do not implement unless fully configurable. I would not want my Done issues showing in red, especially since any Done status category is green. Red to me = something is wrong.

Like β€’ # people like this

@Jack BrickeyWell yeah, I would hope its a status category you can mark your status by like you currently can with the current colors.

Like β€’ Yerbol Nisanbayev likes this

Following the thinking of @Nikki Zavadska _jexo_ ,

@Yerbol Nisanbayev will the new editor be made available to forge applications either as a UI Kit component or a react component for Custom UI's? This would be very nice productivity boost for Marketplace partner applications.

Like β€’ # people like this

Hey @Jeff Ryan _Appfire_ , thank you for upping that comment. We are aware of the need there and it is currently prioritised together with other feature request for the upcoming JQL work. 

Like β€’ Jeff Ryan _Appfire_ likes this

great I was so looking for this. I can't wit to experience it!

Like β€’ Yerbol Nisanbayev likes this

More functions to the JQL itself would be more welcome. Syntax coloring is nice enhancement but by no means changes the everyday struggle to build complex queries. Things like "relative search" with WHERE keyword would be a killer, think about it :)

Like β€’ # people like this

Is it just for cloud? if not, in which data center version is it available on?

Like β€’ # people like this
G subramanyam Community Leader Aug 17, 2021

I'm not well versed with JQL and always depending on a colleague when the need arises. These new features seems to be more user friendly and I think I can excel. Thank you @Yerbol Nisanbayev for the details. May I know if this new additions are included or updated or replaced in the Atlassian University JQL course? If yes, could you please share that course link.

Is it available for Server version?

Like β€’ # people like this


Log in or Sign up to comment

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you