---
title: "Timeboxes"
canonical: "https://support.appfire.com/space/BGdc/3525280272/Timeboxes"
format: markdown
---
## About timeboxes

Timeboxes define consecutive timeframes used for work planning. In BigPicture, they represent sprints, iterations, increments, and stages.

There are two types of timeboxes:

- Automatic (timeboxes synchronized with Jira sprints)
- Manual (timeboxes added manually. The timeboxes you can add depend on the [box type settings](https://appfire.atlassian.net/wiki/spaces/BGdc/pages/3525542433))

![Timeboxes configuration on the box scope definition page.](media://4f832290-badd-4e3a-813b-3392bf32dde2)

## Set box type sequentiality

To prevent the period of consecutive timeboxes from overlapping, the box type's sequentiality should be set to **Sequential**. See the [https://appfire.atlassian.net/wiki/spaces/BGdc/pages/3525739054](https://appfire.atlassian.net/wiki/spaces/BGdc/pages/3525739054)  page for more information. 

<details>
<summary>See the screenshot</summary>

![Sprint box type settings.](media://cc814cc7-e3ec-493b-80b3-f188d0b5c69e)
</details>

### Add missing sprint dates in Jira

When Jira sprints do not have dates, timeboxes **cannot** be created. In this case, you will see the message in the screenshot below.

You can fix it by adding the dates for the first Jira sprint and running the synchronization again.

![BigPicture warning that pop up when the Jira sprint dates are missing.](media://d9ee701b-8679-41ae-a7e6-d64dbc34c20b)

### Use Jira boards to create automatic timeboxes

You can choose a Jira board to create timeboxes automatically. The board you choose will be then automatically added to the scope of the box.

Thanks to this, you can be sure that all the tasks from the Jira board are in the box. This approach is especially helpful if your Jira boards are connected to different projects, and, for that reason, they have complex task structures. 

## Switch from automatically to manually added timeboxes

> ℹ️ If you set synchronization of timeboxes based on Jira sprints, timeboxes are created automatically. 
> ℹ️ 
> ℹ️ You **cannot** create the next timeboxes manually unless you change the settings (Box configuration > Tasks > Scope definition > Timeboxes).

![image-20240214-112947.png](media://e9d26802-70a9-4050-a66c-0a8d340bb21d)

To switch from automatically to manually added timeboxes:

> ⚠️ **IMPORTANT:** This action will **turn off** the synchronization of newly created Jira sprints to BigPicture, and enable the creation of iterations from the **Scope definition** page.   
> ⚠️ You can adjust synchronization settings based on the field mapping, including specific team rules. After the change, existing timeboxes will **remain unaffected **- sprints changes won't result in timebox creation/deletion.

1. Go to **Box configuration > Tasks > Scope definition > Timeboxes**.
2. Select **Manually created timeboxes**.
3. Click **Save**.

> ℹ️ After switching from automatically to manually added timeboxes, you can create timeboxes manually from the **Scope definition** page. Learn more in the Manually added timeboxes section.

![image-20240214-113825.png](media://aa7eace9-7482-4f24-a492-4f0e27a60c0e)

## Manually added timeboxes

### Create next timeboxes

If you already have timeboxes and want to create next timeboxes, you can:

- Create next timeboxes on the Scope definition page

**Method 1 (Scope definition page):**

<details>
<summary>See the steps</summary>

1. Go to **Box configuration > Tasks > Scope definition > Timeboxes**.
2. Use the **right arrow** to find the most recent timebox.
3. Click on the **+** icon next to the most recent timebox.
4. Add as many timeboxes as you need.
5. Click **Create**.
6. New timeboxes are visible.
</details>


### Next timebox template

If you want a new subsequent timebox to have its scope definition set based on the selected timebox:

1. Enable the **Next timebox template toggle** switch.
2. Click on the **cog button **and define if the **value name convention** will be based on:
  1. **Values of this timebox** - sprint names will be generated based on the setup of this timebox
  2. **New box name** - sprint names will be generated based on the newly created box

![image-20240214-131017.png](media://f65793db-fe83-4dbb-92f1-de696d2864f2)

## Project teams with separate sprints

If project teams have separate sprints:

1. Go to the **Scope definition** page.
2. Tick **Each team has a different mapping with value**.
3. Enter the sprint name and data for each team.
4. Click **Save.**

![image-20240214-142428.png](media://407d34da-c85d-44e9-85bf-6c402cff35c5)

## Actions on timeboxes

You can perform the following actions on timeboxes (available on the **Scope definition** page):

| **Action** | **Screenshot** |
| --- | --- |
| Navigate the timeline | Use the arrows to navigate the timeline:<br>![image-20240216-083754.png](media://4a131cd6-d351-49a0-aa1c-6a588c7d0d87) |
| Zoom in/out | ![image-20240216-084011.png](media://761eefc3-c3b6-47f5-ae69-c68f71fa4b0f) |
| Go to today’s date | ![image-20240216-084138.png](media://5af33819-2351-49b5-b443-4bd01ab10f6a) |
| More actions<br>- Edit
- Create timeboxes inside
- Delete
- Change status | Click on the **More actions** menu to:<br>- Edit
- Create timeboxes inside (divide a selected timebox into smaller chunks, for example, if a timebox works as a program increment, you may add iterations)
- Delete
- Change status (Not started, In progress, Closed)<br>![image-20240216-084257.png](media://5ac73e93-15e3-4657-b18d-694da533df59) |