# Install and open your first map

> Install Visual Backlog from the Atlassian Marketplace, open it in a Jira space, and learn where everything is on the screen.

Section: Tutorials · Web page: https://visualbacklog.app/docs/tutorials/first-map

In this tutorial you install Visual Backlog, open the map of one of your spaces, and
move around it. It takes about five minutes. You need a Jira Cloud site; to install the
app you need to be an administrator of that site.

## 1. Install the app

1. Open [Visual Backlog on the Atlassian Marketplace](https://marketplace.atlassian.com/apps/1233915/visual-backlog?tab=overview&hosting=cloud&utm_source=visualbacklog.app&utm_medium=referral&utm_campaign=website&utm_content=docs).
2. Use the button on the listing to add the app.
3. Pick your Jira Cloud site and confirm.

Visual Backlog is free for up to 10 users. See [Pricing and limits](https://visualbacklog.app/docs/reference/pricing-and-limits.md).

> **Links have to be switched on in Jira:** Visual Backlog draws Jira’s links between work items. If linking is turned off for
> your site, the app says so when it opens, and a Jira administrator has to turn it on
> in Jira’s settings.

## 2. Open the map

1. In Jira, open a space that has some work items in it.
2. In the space’s menu, choose **Visual Backlog**.

The map of that space is drawn. A space with more than 150 work items opens folded to
its epics the first time, so it is readable straight away. You will learn to fold and
unfold in [Fold a space to its epics](https://visualbacklog.app/docs/guides/fold-to-epics.md).

![The Visual Backlog screen: a toolbar along the top, the map in the middle, zoom controls at the bottom left and panel icons at the right](https://visualbacklog.app/docs/map.webp)

*The whole screen, with the sample space Nova open.*

## 3. Find your way around the screen

- **Along the top: the toolbar.** From the left: where the map’s work comes from (it
  shows the space’s key, here **NOVA**), the mode (**Full**), **Group**, the filters,
  and **Find…**. Every control is described in the [toolbar reference](https://visualbacklog.app/docs/reference/toolbar.md).
- **Top left of the map:** the fold button, and the **Back** and **Forward** arrows.
- **Bottom left:** the zoom controls.
- **Bottom middle:** how many work items are on the map.
- **Right of the map:** four icons that open the panels: **Navigator**,
  **Backlog health**, **Legend** and **Settings**.
- **Far right:** the layout settings, a column of buttons that change how the map is
  drawn.

## 4. Move around

1. Scroll to move the map up and down. On a trackpad, slide two fingers in any
   direction.
2. Drag an empty spot of the map to move it.
3. Hold **Ctrl** (**Cmd** on a Mac) and scroll to zoom. On a trackpad, pinch.
4. Click **Fit to view** in the zoom controls at the bottom left to see the whole map
   again.

As you zoom in, cards show more: the work item’s key, its status, who it is assigned to
and its story points. As you zoom out, they simplify.

## 5. Look at one work item

1. Click a card. Two or more icons appear above it.
2. Point at each icon to read what it does. The first opens the work item in Jira.

![A selected card at the right of the map with two icons above it; the pointer is on the second, labelled Show what this is waiting on](https://visualbacklog.app/docs/waiting-on-card.webp)

*The icons above a selected card.*

## 6. Find a work item by name

1. Click **Find…** in the toolbar.
2. Type part of a work item’s title or key.
3. Pick it from the list. The map moves to that card.

![Find in the toolbar with check typed in, listing four work items whose titles contain it](https://visualbacklog.app/docs/find.webp)

*Find lists the work items on the map that match.*

## What you have learned

You installed the app, opened a map, and know where the controls are. Next:
[Read the map](https://visualbacklog.app/docs/tutorials/read-the-map.md).
