App widget

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

Preconditions

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.

If a matching Box has been found, the App view will be displayed.

A project, or even just 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 for Box creation.

Context

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

To create a Box you must have sufficient permissions within the App.

If a perfect match Box already exists, you won't be provided with an option 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 further subdivide the scope and change the Box configuration to best match your needs.

Conditions

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

"Own" scope Box → "Sub-scope" and "None" scope Boxes can't be created using this method
Can be created under the Root (parent Box set as Root) → Box type settings (General > Basics) related to parent types have to allow for a "Main" Box type to be a parent
Sequentiality set as "Overlapping allowed"

Go to BigPicture

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

You will be taken to the Home Box (Root Box).
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).

Troubleshooting

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.

Table of contents

BigPicture Suite

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