---
title: "Timeboxes."
canonical: "https://support.appfire.com/space/DLP/868975113/Timeboxes."
format: markdown
---
| **Contents:**<br>> Macro (toc) |
| --- |

## Introduction

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](https://appfire.atlassian.net/wiki/spaces/DLP/pages/297538577) settings)

> ℹ️ App admins can configure timebox schedules to define a reusable timebox hierarchy (e.g., Year → Quarter → PI → Iteration) and apply it across multiple boxes. See more on the [https://appfire.atlassian.net/wiki/spaces/DLP/pages/1989148938](https://appfire.atlassian.net/wiki/spaces/DLP/pages/1989148938) page.

![Timeboxes configuration on the box scope definition page.](media://e674c1c4-2368-4f5a-9650-8e61e0c3532a)

## Set box type sequentiality

To prevent the period of consecutive timeboxes from overlapping, set the box type's sequentiality to **Sequential** on the box type configuration page (**Administration** > **Box types** > click the **box type** name > **General** > **Advanced** > **Sequentiality**).

![Sprint box type settings.](media://c5fb87cb-5a62-442f-a973-74b3f390110d)

## Automatic timeboxes (synced with Jira sprints)

Before you start working with the [Board module](https://appfire.atlassian.net/wiki/spaces/DLP/pages/297667675), you need to configure timeboxes first. Here’s a short video showing you the process. 

 To create timeboxes based on Jira sprints from a selected Jira board:

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

1. Open the **Board module**.
2. Click **Synchronize Jira Sprints.**
3. Select the Jira board to synchronize and the box type (default: Iteration).
4. Click **Create**.
5. The Jira board is now synchronized with the Board module, and timeboxes have been created.
  **Important: **If consecutive sprints overlap, the start date of the second sprint in the sequence will be postponed. If there are no sprint dates, they will be filled in based on the previous sprint in the sequence.
</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://13aa72d4-df49-43fc-98cc-6cdee79b9cc2)

### 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://929e65d3-5b5a-4311-b11a-dfedcc44fcb6)

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 in the Board module.   
> ⚠️ You can adjust synchronization settings based on the [field mapping](https://appfire.atlassian.net/wiki/spaces/DLP/pages/297635027), including specific rules for teams. 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 or directly in the **Board module**. Learn more in the [Manually added timeboxes ](#manually-added-timeboxes)section.

![image-20240214-113825.png](media://1a402942-8671-4fb1-a314-36d909c75b94)

> Macro (anchor)



## Manually added timeboxes

To start working with the [Board module](https://appfire.atlassian.net/wiki/spaces/DLP/pages/297667675), you need to configure timeboxes. 

### **Create first timeboxes**

To create first timeboxes manually:

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

1. Open the **Board module**.
2. Click **Create new timeboxes **and select the template.   
The drop-down menu displays possible options based on the box type settings. To change the box type settings, click **Manage templates**.
3. Add as many timeboxes as you need.
4. Click **Create.**
5. Timeboxes are visible in the Board module.
</details>

### Create next timeboxes

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

- Create next timeboxes on the Scope definition page
- Create next timeboxes directly in the Board module

**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>

**Method 2 (the Board module):**

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

1. Go to the **Board module**.
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://523f292b-8d39-4b5b-9ba1-51ac8ab06852)

## 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://2f102973-a5ea-4191-93cc-3db77deeac0c)

## Actions on timeboxes

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

| **Action** | **Screenshot** |
| --- | --- |
| Navigate the timeline | Use the arrows to navigate the timeline:<br>![image-20240216-083754.png](media://3b9ed9e4-febd-4722-bda6-f5fdcf8a5c82) |
| Zoom in/out | ![image-20240216-084011.png](media://43795e88-8d1c-4a99-b7dd-cd883e8de615) |
| Go to today’s date | ![image-20240216-084138.png](media://83a0d0da-ea4f-4366-b65a-d95249f214ba) |
| 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://a5e87751-2c5a-402d-b194-691b2a86e7f5) |