# Permissions and data

> What Visual Backlog can read and change in Jira, what each person can see and do, and where data is kept.

Section: Reference · Web page: https://visualbacklog.app/docs/reference/permissions-and-data

## What you can see and do

Visual Backlog acts as you. It never shows or changes more than Jira lets you.

| To | You need |
| --- | --- |
| See a work item on the map | Permission to see it in Jira. Work you cannot see is not drawn. |
| Create, change or remove a link | Permission to link the work items in Jira. |
| Create a work item | Permission to create work items in that space. |
| Change settings for everyone in a space | To be an administrator of the space. |
| Install the app | To be an administrator of the Jira site. |

Links between work items have to be turned on for the Jira site. If they are off, the
app says that it *needs work item linking turned on to work properly*.

## What the app is allowed to do in Jira

When the app is installed, Jira lists the permissions it asks for:

| Permission | Used for |
| --- | --- |
| Read Jira work (`read:jira-work`) | Reading work items, links, releases and filters to draw the map. |
| Write Jira work (`write:jira-work`) | Saving the links and work items you create or change on the map. |
| Read spaces (`read:project:jira`) | Reading the space’s name, key and work types. |
| Read workflows (`read:workflow:jira`) | Reading statuses, to group them into to do, in progress and done. |
| Read boards (`read:board-scope:jira-software`, `read:board-scope.admin:jira-software`) | Listing a space’s boards and reading a board’s filter. |
| Read sprints (`read:sprint:jira-software`) | Reading sprints, for the sprint filter, lanes and cards. |

## Where data is kept

- Visual Backlog runs on Atlassian Forge, inside Atlassian’s cloud.
- **Your work items and links stay in Jira.** The app reads them when you open a map
  and writes a change straight back to Jira.
- **Your own preferences**, such as the layout settings, grouping, filters and the
  level a space is folded to, are remembered for you.

The [privacy notice](https://visualbacklog.app/privacy) and the
[Marketplace listing](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)
have the full details.

## Saved views and space settings

Saved views and settings for everyone in a space keep their data in the app’s own
storage on Atlassian Forge, and sharing a view with named people uses one more
permission, to read people’s names. See
[Saved views, the work item and space settings](https://visualbacklog.app/docs/reference/views-work-item-and-space-settings.md).
