Skip to content

Guides

Map a board, a release, a saved filter or a search

Change where the map’s work comes from: the whole space, one of its boards, a release, a saved filter, or a search written in JQL.

A map starts with the whole space. Most days you care about a slice of it. The source is where the map’s work comes from, and you change it from the source menu.

From a whole space to a release, then to a search.

Open the source menu

  1. Click the source menu at the left end of the toolbar. It shows the current source, usually the space’s key.
The source menu open at the top left: a search box, the space NOVA, two releases, JQL, and four epics
The source menu: the space, its releases, a search, and work items.

Map a board

  1. Open the source menu.
  2. Under Board, pick the board. If the space has many, type the board’s name to find it.

The map shows the work items the board’s own filter finds.

Map a release

  1. Open the source menu.
  2. Under Release, pick the release, or type its name to find it.

Map a saved filter

  1. Open the source menu.
  2. Type the filter’s name.
  3. Under Saved filter, pick it.

The filters you starred in Jira are listed without typing. You can find any other filter you are allowed to open by its name.

  1. Open the source menu.
  2. Choose JQL. A search box replaces the source menu.
  3. Type a query in JQL, Jira’s search language. The box colours your query and suggests fields and values, as Jira’s own search does.
  4. Press Enter. Use Shift + Enter to add a new line instead.
The JQL search box open in the toolbar with project = NOVA AND typed in, and the hint Enter to search, Shift+Enter to add a new line
The JQL search box takes the place of the source menu.

If the query has a mistake, Jira’s own message is shown under the box.

Go back to the whole space

  1. Open the source menu.
  2. Under Space, pick the space.

Or click Back at the top left of the map.

Good to know

  • Changing the source is a step: Back returns to the source you had before.
  • The filters in the toolbar work with every source, and only offer what the source brought in. See Filter the map.
  • Work items from other spaces that the source’s work is linked to are drawn too, unless you turn External work items off in the space filter.
  • Every kind of source is described in the sources reference.