Enable the project issue navigator

This page is for team-managed projects

If the lower-left of your project sidebar says you're in a company-managed project, check out these company-managed project articles instead.

Learn more about the difference between company-managed and team-managed projects.

The project issue navigator lets you view a list of the issues in your project, and filter them to find what you need. You can search for one or more issues using the text search field and built-in filters.

Using the issue navigator, you could search for all issues in your project that:

  • are bugs

  • are assigned to Jane

  • were reported by Fred

  • are in the in progress status

  • have “pizza” in a text field

To enable the issue navigator for your team-managed or company-managed project:

  1. Go to Project settings > Features.

  2. Toggle on the switch for Issue navigator.

You can toggle this feature on and off any time without affecting any of your project’s issues.

The issue navigator page with a list of issues and an issue selected. There is a text field and other filters.
  1. The Issues link in the project sidebar

  2. The list of issues in the issue navigator

  3. Issue field filters

  4. The link to advanced search

  5. List view or Detail view toggle

  6. Basic or JQL toggle

Learn more about searching in Jira Cloud.

Search for issues in a team-managed project

In the project issue navigator, you can use the text search and field filters to quickly find an issue or a set of issues in your project.

When you open the issue navigator, the list of issues defaults to showing all issues ordered from newest to oldest (by created date).

Before you begin, you’ll need to enable the issue navigator for your project.

To find issues in your project:

  1. From your project’s sidebar, select Issues.

  2. Use the text search field or built-in filters to refine your search criteria.

  3. Order and sort the issues using the options at the top of the list of issues.

  4. Select an issue to view or edit it.

  5. Select Reset to clear your search criteria.

Select More+ to refine your search criteria in a project. We don’t support filtering for all fields in the project issue navigator just yet, but we’re working on it. Select Go to Advanced search for more filtering options.

To broaden your search to more projects, select the Project dropdown and pick your projects. Alternatively, you can also select Go to advanced search.

If you're searching against a field, you can select Show full list to view the list of available options against your search criteria. If your list is too long, you can start typing to get to your option faster.

 

Search for issues using JQL in a project

You can build structured queries using the Jira Query Language (JQL) to search for issues in a project. You can specify criteria that you can't define in the quick or basic searches (the ORDER BY clause, for example). 

JQL is not a database query language, even though it uses SQL-like syntax. Learn more about advanced JQL search.

To search for issues using JQL:

  1. From your project’s sidebar, select Issues.

  2. If you're in the Basic search mode, select JQL.

  3. Enter your JQL query.

  4. Press Enter or click to run your query. Your search results will be displayed in the issue navigator.

As you type your query, Jira will offer a list of "autocomplete" suggestions based on the context of your query. The autocomplete suggestions only include the first 15 matches, displayed alphabetically, so you may need to enter more text if you can't find a match. Jira will also let you know if there’s an error in your query.

Using JQL, you could search for all issues in your project “Assassin’s guild” that:

  • have “weaponry” in a text field, and

  • are ordered by when they were created in ascending or descending order

Search for issues using JQL
  1. Basic or JQL toggle

  2. JQL editor

  3. Expand/Collapse editor

  4. Syntax help

  5. Search button

  6. Line numbers when your JQL query is longer than a line

  7. Autocomplete suggestions based on context

Share your issue search results in a team-managed project

You can share your refined issue searches with your colleagues. For example, you can track all the issues that are in progress, and share this URL with your team so that they can track them as well.

Want to come back to issues that are assigned to you later? You can also bookmark your issue searches to visit your issues later on.

Before you begin, you’ll need to enable the issue navigator for your project.

To bookmark or share your issue search in your project:

  1. From the project’s sidebar, select Issues.

  2. Use the text search field or built-in filters to refine your search criteria.

  3. Save the query with a browser bookmark, or share the URL with your team.

We don’t support filtering for all fields in the project issue navigator just yet, but we’re working on it. If your query is too complex for the project issue navigator, click Go to advanced search for more filtering options.

Last modified on Jul 28, 2021
Cached at 8:45 AM on Aug 5, 2021 |

Additional Help

Ask the Community