Support for Atlassian Server Products (and apps like BigPicture) is has ended in February 2024.

Are you planning a migration to Cloud? Make sure you don't lose your BigPicture data/configurations in the process. Check out this page for information on how to migrate BigPicture's data to Cloud. If you have any questions please email

App widget

Table of contents

The App widget allows access to the app directly from a Jira project. 


Creating a ‘Matching box’ is allowed when a user meets the combination of the two permission conditions:

  • the user must have permission to create boxes under the Root box in BigPicture (App Admin or Sub-box Creator)

  • the user is a Jira Admin or Jira Project Admin 

You can use BigPicture directly from the Jira project screen when the relationship between a Box and a Jira project is simple - the scope of a Box is the exact match to a project, and only the project (no other Filters/ Boards/ projects are in scope. The 'narrow down' option is allowed.)


When the "Own" scope Box is a perfect match, child Boxes with "sub-scope" can also be managed directly from Jira.

Boxes that do not meet the preconditions (aren't a match for a project) are not shown in the Box Switcher (unless they are sub-boxes of a matching Box).

A project can potentially be in multiple Boxes with this simple matching setup.

Accessing Existing Boxes

Go to a Jira project page. Click the App icon on the left.

The App view will be displayed if a matching Box has been found. 

A project, or even part of the project, can be in more than one Box. Only the simple 1:1 matches are detected; therefore, if some tasks are in a Box with a more complex scope definition, you may not be aware of this fact. A simple match will be shown. When no simple direct matches are found, you are presented with a screen allowing Box creation


The Box switcher can be found at the top. It allows you to navigate the Box structure, including sub-Boxes. 

Modules and operations

Full module functionality is available to you directly from a Jira project page. 

Use the module dropdown to switch between modules. 

Creating a Box

If a perfect match Box already exists, you won't be allowed to create one. 

If no perfect match Box has been detected for a project, you are given the possibility to create it:

  • New Box name = project name

  • Nested directly under the Home (Root) Box in the App (you can later move it if needed)

Select a Box type - available options depend on your Box type setup. Only "Own" scope Boxes can be selected (BigPicture Enterprise users may see multiple options since they don't have a limit for how many Box types can be created).

When you click on a Box Type, you will see the list of modules that will be automatically active (module settings can be changed after a Box has been created).

Click the Start working button to create a perfect match Box.

The Box is ready. You can create Timeboxes to subdivide the scope further and change the Box configuration to match your needs best.


Requirements for Box types used to create a matching Box in the context of a Jira Project:

Go to BigPicture

  1. Click the BigPicture icon at the top left to be taken to the App. 

    You will be taken to the Home Box (Root Box). 

  2. Use the Box switcher to go directly to a selected Box (open a Box link in a new tab, for example, by right-clicking on an item).


A new box can't be created.

If you want to create a Box using a particular Box type and can't find it on the list of available options, Box type settings don't meet one or more of the conditions outlined above. 

Missing permissions

Make sure to verify App and Box permissions and roles.