---
title: "Use case: Create timeboxes based on Jira sprints"
canonical: "https://support.appfire.com/space/BPEdc/2509013226/Use%20case%3A%20Create%20timeboxes%20based%20on%20Jira%20sprints"
format: markdown
---
| **Goal** | **Create and automatically sync consecutive sub-boxes with Jira sprints**<br>BigPictures timeboxes let you divide and structure your work. Learn how to create timeboxes and sync their dates and tasks with Jira Sprint boards. |
| --- | --- |
| **Scenario** | A Project Manager runs an Agile or Hybrid project and wants to manage tasks for each sprint in their respective timeboxes. |
| **Key benefits** | - Boxes are created automatically whenever a new sprint is added to Jira
- Change in tasks is updated bi-directionally
- Change in sprint/timebox status is updated bi-directionally
- Easy task assignment for individual sprints (for example, you can drag tasks from the backlog and drop them onto the board in the Board module) |

## Preconditions

- [box admin] [sub-box creator]  You are a Home [Box Admin or Sub-Box Creator](https://appfire.atlassian.net/wiki/spaces/BPEdc/pages/2534375822) (to create boxes under the Home box), or
- [box admin]  If the Agile project box already exists, you are its Box Admin.
- You have a project with Sprints and a backlog of tasks set up in Jira.

## Create Sprint-based timeboxes step-by-step

1. Create a new Agile Project box under the Home box in the Overview module:
  1. Select Agile or Hybrid **project type.**
  2. **Name** your box.
  3. Define the box **start** and **end dates**. Make sure these two dates encompass dates for all sprints you have planned to have in Jira.
  4. Select the **Jira project** to add it to the scope of the box, or leave it blank if you want to define your box scope with Jira **board** and/or **filters** later.
  5. Optionally: Change the **box icon** and **color.**
  6. Click **Create**.

> ✅ Remember that your Jira board can contain tasks, tasks of assignees, and task types from other projects. 
> ✅ 
> ✅ For that reason, if the scope of the Jira board differs from the scope of the Jira project, add the project's board name to the **Board** in the scope definition. This will ensure all tasks from this board are included in the scope of the box.
> ✅ 
> ✅ ![Box scope based on jira project and jira board.](media://79bd8b4e-e13f-443f-a7cf-8b7bdf596ab6)

![Create new box modal where you fill in box details.](media://3200c158-b272-48cf-ac6e-17264dc08f64)

Your box is now created, and you are the Box Admin of this box.

2. Open your box and go to the **box configuration** > **Tasks** > **Scope definition **page.
3. Enable the **Timeboxes** option at the bottom of the page, and leave the **Automatic sprint-based timeboxes** checked.
4. Add the Jira board under the **Board** and leave the **Box type** set to *Iteration*.

![Timeboxes settings on the scope definition page.](media://6f431657-bc86-4320-ab06-c3d28809e451)

Once BigPicture finds the selected Jira board, it will list the sprints that were created so far.

![A list of Jira sprints detected by BigPicture on the box scope definition page.](media://3cde1f9b-a075-4e94-8018-ed4e51f44dfd)

6. **Save** your settings.

Your Jira sprints are now organized into Iteration boxes and visible in the Overview module (on the Home and parent project box levels).

![A list of timeboxes based on Sprints under a parent project box.](media://54adb7f9-a9c3-416e-b8d4-8a43603930f0)

The video below recaps the entire process of creating sprint-based timeboxes in BigPicture.

> Macro (iframe)

## What’s next?

- BigPicture will add a corresponding timebox under your project box whenever you create a new sprint in Jira.
- If you update a task in Jira, the change will be reflected in BigPicture and other way around.
- When you change the status of a sprint, the box status will also be updated.
- You can change individual timeboxes' names by [editing them inline](https://appfire.atlassian.net/wiki/spaces/BPEdc/pages/2534802721) or using the **Edit** option in several modules.

## Additional resources

- [Create a box](https://appfire.atlassian.net/wiki/spaces/BPEdc/pages/2533754012)
- [Timeboxes](https://appfire.atlassian.net/wiki/spaces/BPEdc/pages/2534507931)
- [Box scope types](https://appfire.atlassian.net/wiki/spaces/BPEdc/pages/2534278271)
- [Box scope definition](https://appfire.atlassian.net/wiki/spaces/BPEdc/pages/2509406406)
- [Board module](https://appfire.atlassian.net/wiki/spaces/BPEdc/pages/2534769055)