---
title: "Edit box details (name, start/end dates)"
canonical: "https://support.appfire.com/space/DLP/2211126467/Edit%20box%20details%20(name%2C%20start%2Fend%20dates)"
format: markdown
---
> Macro (aura-html)

## Overview

The **Edit** option lets you change the following box details:

- name
- start date
- end date

Each detail field is required—you will not be able to **Save** your changes if the box name or start/end dates are empty.

![Edit box details screen.](media://9b2d7bae-9086-44b7-81e7-ee8eb6fdf14e)

## Permissions

The box edit action requires one of the following [security roles](https://appfire.atlassian.net/wiki/spaces/SPMDRAFT/pages/1673724331):

- Jira Admin
- App Admin
- Box Admin
- Box Editor

## Edit box details in the Overview module

### Edit option on the context menu

In the [Overview module](https://appfire.atlassian.net/wiki/spaces/DLP/pages/2212233373), you can edit a box in all three [view modes](https://appfire.atlassian.net/wiki/spaces/DLP/pages/2211840925) (Hierarchy, Timeline, and Kanban board) using the options menu. This box edit method applies to Home, [portfolio](https://appfire.atlassian.net/wiki/spaces/DLP/pages/2211351940), program, and project boxes.

The interactive presentation below walks you through the box editing in all Overview modes.

#### Overview module: [Hierarchy mode](https://appfire.atlassian.net/wiki/spaces/DLP/pages/2211582663)

1. Go to the **Overview module** and open the **Home box**.
2. **Right-click** the box (anywhere within its swimlane but the name link).

- Alternatively: Click **More actions** (**…**) next to the box you want to edit.

3. Select **Edit** from the dropdown.

![Prompting options menu in the Overview module, hierarchy mode.](media://5a3a6048-6263-4141-8040-4bde4a974c53)

4. On the **Edit details** screen, change the box details.
5. **Save** to finish the process.

#### Overview module ([Timeline mode](https://appfire.atlassian.net/wiki/spaces/DLP/pages/2212529505))

1. Go to the **Overview module** and open the **Home box**.
2. **Right-click** the box on the box hierarchy side (anywhere within its swimlane but the name link).

- Alternatively: **Right-click** the box bar on the timeline side.

3. Select **Edit** from the dropdown.

![Prompting options menu in the Overview module, timeline mode.](media://93fde371-4e88-411f-885a-3aeb39d88fb6)

4. On the **Edit details** screen, change the box details.
5. **Save** to finish the process.

#### Overview module ([Kanban board mode](https://appfire.atlassian.net/wiki/spaces/DLP/pages/2211842894))

1. Go to the **Overview module** and open the **Home box**.
2. **Right-click** the box card (anywhere but the box name link)

- Alternatively: Click **More actions** (**…**) at the bottom of the box card.

![Prompting options menu in the Overview module, kanban board mode.](media://44f533ec-fba1-440e-8a48-f72f29ad4f96)

### Edit box details inline

You can inline edit the box name and its period (start and end dates) directly in the Overview module ([Hierarchy](https://appfire.atlassian.net/wiki/spaces/DLP/pages/2211582663) mode only).

- Click the **Name** field and change the box name.
- Click the box **Start date** field and select a new date from the date picker.
- Click the box **End date** field and select a new date from the date picker.

![Inline editing box details. On the screen, a date picker is shown.](media://0757cbfe-c715-4fbe-b565-e80d9f3ea106)

## Edit box details on the box configuration page

> ℹ️ The access to the **box configuration page** requires one of the following security roles:
> ℹ️ 
> ℹ️ - Jira Admin
> ℹ️ - App Admin
> ℹ️ - Box Admin

You can also change the box name and period on the box configuration page.

1. Open the box configuration page:

- Select the **Configure** option from the context menu in the Overview module (all view modes) as described in the previous section.

or

- Open a box you want to edit and click the **module switcher** > **Configuration**.

2. On the **General **>** Basic** page, rename the box and edit its period.

![Box configuration page, general settings.](media://233d1dbd-425f-4ca7-9901-3ae66f018447)

## Validate box period change

Changes in the box start/end date(s) trigger a validation check. The box’s duration is affected by its [box type settings](https://appfire.atlassian.net/wiki/spaces/DLP/pages/2212266090).** **

### [Sequentiality](https://appfire.atlassian.net/wiki/spaces/DLP/pages/2212268915)

Sequentiality settings affect box types on the same level.

![Box type configuration page, advanced settings.](media://81db2afc-c4da-4d85-b232-8ac80c02ca0b)

- **Overlapping allowed** - periods set for boxes of the same type can overlap. The rule applies to the same-level boxes in the [box hierarchy](https://appfire.atlassian.net/wiki/spaces/DLP/pages/2211645621).
- **Sequential** - periods set for boxes of the same type cannot overlap. The rule applies to the same-level boxes in the box hierarchy.

> 📝 - Boxes in the **Auto bottom-up** [scheduling mode](https://appfire.atlassian.net/wiki/spaces/DLP/pages/2211580702) and **Auto scope-based** modes can <u>never</u> have sequential periods, meaning they can always overlap.
> 📝 - Boxes in the **Manual** and **auto top-down** modes can have their period sequential or overlapping. If they are set to **Sequential**, the same-level sequential boxes cannot overlap.
> 📝 - This validation check is also triggered when you [create a new](https://appfire.atlassian.net/wiki/spaces/DLP/pages/2211189307) box whose start/end dates could conflict with the period of other boxes.
> 📝 
> 📝 ![Overview module, validation error](media://b55a8d26-eb0c-4338-82fd-f00ba185167e)

### [Period mode](https://appfire.atlassian.net/wiki/spaces/DLP/pages/2212268915)

Box type period mode determines whether a new child box can be created with the specified start and dates.

- **Manual** - the period of a box is always set manually (no auto-scheduling adjustment).
- **Auto top-down** - the period of a box is set manually and restricts the periods of its sub-boxes.
- **Auto bottom-up** - the period of a box changes based on the period of its sub-boxes.
- **Auto scope-based** - the period of a box changes to encompass tasks in its scope.

#### Period of a box vs. period mode of its sub-boxes

Boxes in an **Auto bottom-up** period mode are affected by their children's periods, regardless of the child (sub-box) period mode.

#### Period of a box vs. period mode of its parent

- **An Auto top-down parent**:
  - limits the period of **Auto top-down** sub-boxes
  - does not affect sub-boxes in the **Manual** or **Auto scope-based** period mode
  - have its period mode overridden by the sub-box in the **Auto bottom-up** mode

Effects of the parent box period mode on a child box period are outlined in the table below.

| **Parent box → ** | **box period** |
| --- | --- |
| auto bottom-up | unaffected (regardless of the child box period mode) |
| auto scope-based | unaffected (regardless of the child box period mode) |
| auto top-down | **an "auto top-down" parent limits the period of an "auto top-down" child**<br>Period of an "auto bottom-up" child unaffected ("auto bottom-up" child has priority over an auto "top-down parent")<br>Periods of "manual" and "auto scope-based" boxes unaffected |
| manual | unaffected (regardless of child period mode) |

## Limitations

### [Closed box](https://appfire.atlassian.net/wiki/spaces/DLP/pages/2212004764)

- Closed boxes cannot be edited. The box configuration page cannot be accessed, either.

![Closed box. The Configure and Edit options are grayed out.](media://89122cd1-feb5-4bba-a34f-a4fedb153c08)

### Home box

- Scheduling settings are not available for the Home (root) box. But you can rename it.

![Home box basic settings. The start and end date fields are grayed out.](media://33b2e4d4-ada6-487a-90ad-b414d09f494d)

The start/end dates of the Home (root) box cannot be changed. That is because they are based on the duration of the boxes in the box hierarchy:

- start date = the earliest start date of a child box
- end date = the latest end date of a child box

![Home box period based on the children boxes.](media://f5dfd007-4894-410d-b9b7-d1555fa8b9f6)