---
title: "Populate a box with tasks (work items from Jira)"
canonical: "https://support.appfire.com/space/SPM/1918634319/Populate%20a%20box%20with%20tasks%20(work%20items%20from%20Jira)"
format: markdown
---
> Macro (aura-html)

## Box scope (old navigation)

<details>
<summary>Click to expand the guide</summary>

## About box scope

The box scope is a defined collection of tasks. Tasks can be added to the scope manually or automatically synchronized with Jira or connected tools such as Trello. 

In the scope definition, you can specify what range of tasks is included in the scope of a given box (or a sub-box) - those are the tasks you will be able to work on in the App (visualize them on a Gantt chart, manage risks, distribute workload, etc.). You can include multiple Jira projects, simultaneously include tasks from different external tools (such as Trello and Jira), or include only some tasks that meet your particular specifications. The flexibility of the setup ensures that a box can be configured to contain exactly the tasks you need to fit your work.

Less frequently used settings have been hidden under **Advanced configuration**.

There are three different scope types (those settings are [adjusted for a box type](https://appfire.atlassian.net/wiki/spaces/SPMDRAFT/pages/1858864073)):

- [Own-scope](https://appfire.atlassian.net/wiki/spaces/SPM/pages/1918765868)
- [Sub-scope](https://appfire.atlassian.net/wiki/spaces/SPM/pages/1918799715)
- [None (aggregations only)](https://appfire.atlassian.net/wiki/spaces/SPM/pages/1918537743)

![image-20251201-090442.png](media://fa86a7d1-ac1f-420d-8a26-454c6542b09c)

See the video explaining the scope definition.

 

## Security and access

Keep in mind:

- A box type contains the default settings applicable to multiple boxes (all boxes of a given type). Those settings are adjusted in the BigPicture Administration. See the [https://appfire.atlassian.net/wiki/spaces/SPMDRAFT/pages/1858864073](https://appfire.atlassian.net/wiki/spaces/SPMDRAFT/pages/1858864073) page for more information.
- Box configuration refers to the settings of a single, individual box. They are dependent on the box type settings.

The table presents what you can configure on the box configuration page. 

| **Area** | **Security and access** | **What can be configured** |
| --- | --- | --- |
| Box configuration | Box admins, Jira admins, and BigPicture admins can access and manage the box configuration.<br>There are a few ways to access the **Scope definition** page of an individual box.<br>![image-20251201-091045.png](media://eed27c9d-4be5-4f30-89f1-8f569449796a) | For a particular box, you can configure:<br>- Scope definition elements
- Automatic rules
- Manually added tasks
- Additional task types
- Scope of sub-boxes
- Timeboxes
- New integrations |

The sections on the Scope definition page will differ depending on the box hierarchy and the scope type (remember that every box type has a scope definition setting). A box with two levels of sub-boxes will show all possible sections.

## Scope definition elements and actions

Visit the [https://appfire.atlassian.net/wiki/spaces/SPM/pages/1918766444](https://appfire.atlassian.net/wiki/spaces/SPM/pages/1918766444) page for more information. 

## Add new integration

Visit the [https://appfire.atlassian.net/wiki/spaces/SPM/pages/1918405249](https://appfire.atlassian.net/wiki/spaces/SPM/pages/1918405249)  page to learn how to add a new integration from the Scope definition page.
</details>

## Populate a box with tasks (new navigation)

<details>
<summary>Click to expand the guide</summary>

## Populate a box with tasks

A defined collection of tasks makes up the box scope. Tasks can be added to the scope manually or automatically synchronized with Jira or connected tools such as Trello. 

In **Work items from Jira**, you can specify what range of tasks is included in the scope of a given box (or a sub-box) - those are the tasks you will be able to work on in the App (visualize them on a Gantt chart manage risks, distribute workload, etc.). You can include multiple Jira projects, simultaneously include tasks from different external tools (such as Trello and Jira), or include only some tasks that meet your particular specifications. The flexibility of the setup ensures that a box can be configured to contain exactly the tasks you need to fit your work.

Less frequently used settings have been hidden under **Advanced configuration**.

There are three different scope types (those settings are [adjusted for a box type](https://appfire.atlassian.net/wiki/spaces/SPM/pages/1918766536)):

- [Own-scope](https://appfire.atlassian.net/wiki/spaces/SPM/pages/1918765868)
- [Sub-scope](https://appfire.atlassian.net/wiki/spaces/SPM/pages/1918799715)
- [None (aggregations only)](https://appfire.atlassian.net/wiki/spaces/SPM/pages/1918537743)

![work-items-from-jira.png](media://d0a1ed42-627c-4206-9216-8e6001ac402c)

See the video explaining the scope definition.

## Security and access

Keep in mind:

- A box type contains the default settings applicable to multiple boxes (all boxes of a given type). Those settings are adjusted in the BigPicture Administration. See the [https://appfire.atlassian.net/wiki/spaces/DLPDRAFT/pages/2022963779](https://appfire.atlassian.net/wiki/spaces/DLPDRAFT/pages/2022963779) page for more information.
- Box configuration refers to the settings of a single, individual box. They are dependent on the box type settings.

The table presents what you can configure on the box configuration page. 

| **Area** | **Security and access** | **What can be configured** |
| --- | --- | --- |
| Box configuration | Box admins, Jira admins, and BigPicture admins can access and manage the box configuration.<br>There are a few ways to access **Work items from Jira** of an individual box.<br>![work-items-from-jira-main.png](media://9e9055f2-1f11-4eab-bbeb-ad88c5836915)<br>Method 1 - Box configuration<br>Go to **box configuration** >** Tasks** >** Scope definition**.<br>Method 2 - Gantt module<br>Click **Tasks** > **Add work items from Jira (Scope definition)**.<br>![Screenshot of the Add work items from Jira option in the Gantt module.](media://78877ed6-68ab-4884-bbe9-514e0957a347)<br>Method 3 - Scope module<br>Click **Tasks** > **Add work items from Jira (Scope definition)**.<br>![Screenshot of the Add work items from Jira option in the Scope module.](media://a11b412d-153e-4156-b191-379556225b61)<br>Method 4 - Risks module<br>Click **Risks** > **Add work items from Jira (Scope definition)**.<br>![Screenshot of the Add work items from Jira option in the Risks module.](media://6713655c-1ce9-4596-96ff-450b194a1bbc) | For a particular box, you can configure:<br>- Work items from Jira
- Automatic rules
- Manually added tasks
- Additional task types
- Scope of sub-boxes
- Timeboxes
- New integrations |

The sections on **Work items from Jira** differ depending on the box hierarchy and the scope type (remember that every box type has a scope definition setting). A box with two levels of sub-boxes  shows all possible sections.

## Work items from Jira elements and actions

See the [https://appfire.atlassian.net/wiki/spaces/SPM/pages/1918766444](https://appfire.atlassian.net/wiki/spaces/SPM/pages/1918766444)  page for more information. 

## Add new integration

See the [https://appfire.atlassian.net/wiki/spaces/SPM/pages/1918536760](https://appfire.atlassian.net/wiki/spaces/SPM/pages/1918536760)  page to learn how to add a new integration from the Scope definition page.
</details>