Skip to content

Reference

Permissions and data

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

What you can see and do

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

ToYou need
See a work item on the mapPermission to see it in Jira. Work you cannot see is not drawn.
Create, change or remove a linkPermission to link the work items in Jira.
Create a work itemPermission to create work items in that space.
Change settings for everyone in a spaceTo be an administrator of the space.
Install the appTo 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:

PermissionUsed 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 and the Marketplace listing 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.