Documentation for JIRA 5.2. Documentation for other versions of JIRA is available too.

The issue navigator displays the search results from an issue filter, a quick search, a basic search or an advanced search. The Issue Navigator only displays one set of search results at any one time, even if you have multiple browser windows open. However, you can easily save your searches (see 'issue filters'), then display them as needed.

Screenshot: Example basic search results in the issue navigator (click to view full size image)

Working with the issue navigator

The Issue Navigator provides convenient ways to work with the search results and perform many of JIRA's most useful functions.

To navigate to the issue navigator: Choose Issues > Search for Issues.

FunctionScreenshotDescription
Switch to advanced search

Click to switch from basic search to advanced search. For details on advanced searching, see Advanced Searching.

Switch to basic search

Click to switch from advanced search to basic search . For details on basic searching, see Basic Searching.

Keyboard shortcutsUse the 'j' and 'k' keys on your keyboard to move between issues on the Issue Navigator. The row for the currently selected issue is highlighted in blue and any 'Issue Navigator' keyboard shortcuts will be performed on this issue.
Sort

Click any field header in the search results to sort by that field in ascending order. Click again to sort in descending order. Please note:

  • You cannot sort by the 'Images' column nor the sub-task aggregate columns (i.e. all columns beginning with '∑').
  • If you sort the search results from an advanced search, an 'ORDER BY' clause will be added to your JQL query to reflect the order of issues in your search results. If the JQL query already has an 'ORDER BY' clause, it will be updated.
  • You can choose different fields to display in your Issue Navigator. See Customising your Issue Navigator.
Filters

Click a filter name to run the filter. The JIRA system filters (My Open Issues, Reported by Me, Recently Viewed, All Issues) and your favourite filters are displayed in the list.

You can find filters shared with you by clicking Find Filters. You can view and manage your filters by clicking Manage Filters.

For details, see Saving Searches ('Issue Filters').

Favourite filters actions

Hover over a filter in the 'Favourite Filters' section. Click the blue arrow and select an action from the dropdown menu.

For details, see Saving Searches ('Issue Filters').

Favourite

Displays for issue filter results only.

Click to select (if star is grey) or de-select (if star is yellow) the issue filter as a favourite.

Issue filter details

Displays for issue filter results only.

Click to view a dropdown menu of information about the issue filter, i.e. name, description, permissions (sharing), subscriptions. You can also edit this information via this menu. For details, see Saving Searches ('Issue Filters').

Issue filter actions


Displays for issue filter results only.

  • Save as — Displays for new search results or unedited filter results. Click to save search as a new filter.
  • Save — Displays when you change one of your own issue filters. Click to save your changes.
  • Edited menu — Displays when you change one of your own issue filters.
    • Click and select Save as to save your changed search as a new filter.
    • Click and select Discard changes to discard your changes.
PermalinkRight-click and save the link to get the permanent URL link to your search results
Share

Click to email the search results to other users or email addresses. For details, see Sharing a Search Result.

ViewsClick and select from the dropdown menu to view/export your search results in various formats, e.g. XML, MS Excel, etc. For details, see Working with Search Results.
Search results actions

This is the actions menu for the search results (located above search results), not for individual issues.

Click and select from the dropdown menu to action your search results, e.g. bulk change issues, clear sorting, configure columns, etc. For details, see Working with Search Results.

Refresh search results

Click to refresh search results without reloading the page.

Issue actions

This is the actions menu for an issue (located next to an issue in the search results), not for all of the search results.

Click and select from the dropdown menu to action the issue. If the icon is not showing, hover over the issue. For details, see Working with an Issue.

Note, some options in this menu will only be available if you have the necessary permissions, or if certain features have been enabled by your JIRA administrator. Options which change an issue's Status (Resolve issue, Close issue, Reopen issue) may differ, depending on your organisation's workflow.

Viewing individual issues

When an issue from a search result set is selected and displayed, a mini-navigator is shown at the right of the issue's title bar:

This mini-navigator indicates the current issue's position within the result set. It also provides linked arrow icons to the previous and next issues in the result set (as shown in the image above), along with a 'Return to search' link that leads you back to the search results. You can also navigate through the search results by using the shortcut keys: 'p' (previous) and 'n' (next).

Accessing protected data

When accessing data generated from JIRA, you may find that access to some resources requires user authentication (i.e. requires you to login). There are three options for this:
  1. To enable access to data without logging in, your JIRA administrator may specify the 'Browse' permission for Anyone.
  2. You can provide the parameters os_username and os_password in the request URL (e.g. http://jira.atlassian.com/browse/TST-1?os_username=tester&os_password=tstpassword). The problem with this method is that it transmits your username and password across the wire in clear text, which may not be an option for some users.
  3. You can provide the request parameter os_authType=basic (e.g. http://mycompany.com/anypage?os_authType=basic). This will force the server to issue a challenge for user credentials (i.e. a login prompt) via the basic http authentication protocol. If you are running over SSL, you still need to specify the os_authType=basic parameter if you require the user to authenticate.