# 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.

Section: Guides · Web page: https://visualbacklog.app/docs/guides/choose-what-to-map

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.

[Screen recording: Opening the source menu and choosing a release, then a JQL search](https://visualbacklog.app/landing/clips/sources.mp4)

*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](https://visualbacklog.app/docs/source-menu.webp)

*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.

## Map a search

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](https://visualbacklog.app/docs/jql.webp)

*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.

> **A search from a space stays in that space:** When you open Visual Backlog from a space, a JQL search is kept to that space: what
> you type narrows it. To search across several spaces, use Visual Backlog’s own page
> in Jira’s **Apps** menu; see [Saved views, the work item and space settings](https://visualbacklog.app/docs/reference/views-work-item-and-space-settings.md).

## 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](https://visualbacklog.app/docs/guides/filter-the-map.md).
- 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](https://visualbacklog.app/docs/reference/sources.md).
