---
title: "Navigate between boxes (box switcher)"
canonical: "https://support.appfire.com/space/SPM/1918667414/Navigate%20between%20boxes%20(box%20switcher)"
format: markdown
---
> Macro (aura-html)

# Box switcher (old navigation)

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

The **box switcher**, located in the upper-left corner of the app, displays the name of the current box you are viewing. When you click it, a drop-down list containing the box hierarchy tree is displayed. You can then select a specific box from the hierarchy to switch to.

Use the box switcher to switch between different boxes. Once opened, the active box is highlighted, so you can switch to a sub-box or a different box.

You can only browse through the boxes for which you have [permission](https://appfire.atlassian.net/wiki/spaces/SPM/pages/1918829579).

The box switcher is displayed in the app’s header for each module, as well as in the WBS and Skill [widgets](https://appfire.atlassian.net/wiki/spaces/SPM/pages/1918832064); both can be added to the issue screen.

Watch the [interactive tutorial](https://demo.arcade.software/KdZ1NZsOHucyTdcfbry0) on accessing and using the box switcher.

## Security and access

- The box switcher is always displayed in the left corner of every module. Click to expand the dropdown.
- To view the boxes, you need a box viewer security role.

## Breadcrumbs navigation

Above the box switcher, you can see the breadcrumb trail: a path that leads from the root box to the current box, showing every level. Each element is a clickable link that leads to the corresponding level.

![Breadcrumbs above the box switcher.](media://3cce0b6c-10d8-4587-a096-026341ef75b0)

## Box details

The following information is presented for each box on the list: 

### **Box** ID

The box IDs are composed of a box type prefix and a sequentially generated number automatically generated by the app. These IDs are displayed next to the box switcher within the module. You can enter the box ID into the search box in the module, next to the box switcher, to find a specific box.

For example, the Hybrid Project’s box ID is HYBR-1, as this box was created based on the Hybrid box type.

![Search bar in the box switcher.](media://a7c4baa4-62ae-46fc-b60c-6466cc40cc73)

### Box name 

In the [Overview module](https://appfire.atlassian.net/wiki/spaces/SPM/pages/1918502655) and the box switcher, you can search for a specific box by entering its name. Whenever a new sibling box is included, the app automatically appends a number to the description.

For example, if the box name is *Iteration,* the automatically generated name of a same-level box would be *Iteration 1*.

### Box status

The box status is displayed next to the box name in the box switcher. You can [change the box status](https://appfire.atlassian.net/wiki/spaces/SPM/pages/1918829911) in different sections of the app. In the Overview module, use the right-click or drag-and-drop option when in the [Kanban mode](https://appfire.atlassian.net/wiki/spaces/SPM/pages/1918700991). You can also change the status in the [Board module](https://appfire.atlassian.net/wiki/spaces/SPM/pages/1918796888) or on the [scope definition page](https://appfire.atlassian.net/wiki/pages/createpage.action?spaceKey=spm&title=Work%20items%20for%20Jira%20elements%20and%20actions&linkCreation=true&fromPageId=1918667414) in the box configuration.

The status is indicated using colors, and the following color-coded statuses are available:

- <span style="color: #97a0af">**Not started**</span> (gray)
- <span style="color: #4c9aff">**In progress**</span> (blue)
- <span style="color: #36b37e">**Done**</span> (green)

![Box status displayed next to the box breadcrumbs.](media://7ae81065-ff6a-4665-9c84-ed6e615c396e)

### Favorite (star) 

Mark the boxes as your favorites and filter out all other boxes using the switcher or the module's filters.

### Hierarchy

The box hierarchy can be modified in the Overview module’s [Hierarchy mode](https://appfire.atlassian.net/wiki/spaces/SPM/pages/1918799130). You can expand and collapse it to see the level of information you want.

## Home button

Use the home button to navigate back to the Home screen.

## Search boxes

If you can't find what you are looking for by scrolling, use the search bar. It works with the box name and ID.

## Filtered view in box switcher

### Favorite boxes

In the filtered view, the box tree structure is not shown (only the boxes that match the filter).

Click the star button next to the search bar to narrow the list to your favorite boxes.

![Filtering boxes by favorite.](media://9d566b70-6daf-4f34-a22f-743d09d55602)

The favorite filters are found in the box switcher and the Overview module.
</details>

# Box switcher (new navigation)

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

The **box switcher**, located in the upper-left corner of the app, displays the name of the current box you are viewing. When you click it, a drop-down list containing the box hierarchy tree is displayed. You can then select a specific box from the hierarchy to switch to.

Use the box switcher to switch between different boxes. Once opened, the active box is highlighted, so you can switch to a sub-box or a different box.

You can only browse through the boxes for which you have [permission](https://appfire.atlassian.net/wiki/spaces/SPM/pages/1918829579).

The box switcher is displayed in the app’s header for each module, as well as in the WBS and Skill [widgets](https://appfire.atlassian.net/wiki/spaces/SPM/pages/1918832064); both can be added to the issue screen.

## Security and access

- The box switcher is always displayed in the left corner of every module. Click to expand the dropdown.
- To view the boxes, you need a Box Viewer security role.

## Breadcrumbs navigation

Above the box switcher, you can see the breadcrumb trail: a path that leads from the root box to the current box, showing every level. Each element is a clickable link that leads to the corresponding level.

![Box navigation breadcrumbs.](media://5f551010-8cd6-4f5f-9e55-eb6e1e55b98b)

If the path is long, you might see **triple dots** (**…**) instead of **Main**. Click it to reveal the entire breadcrumbs trail.

## Box details

The following information is presented for each box on the list: 

### **Box** ID

The box IDs are composed of a box type prefix and a sequentially generated number automatically generated by the App. These IDs are displayed next to the box switcher within the module. You can enter the box ID into the module's search box, next to the box switcher, to find a specific box.

For example, the Program box ID is PROG-24, as this box was created based on the Program box type.

![Box switcher expanded.](media://e103a0b7-a629-4b7f-a36c-988c5c7579f2)

### Box name 

In the [Overview module](https://appfire.atlassian.net/wiki/spaces/SPM/pages/1918502655) and the box switcher, you can search for a specific box by entering its name. Whenever a new box is included, the app automatically appends a number to the description.

For example, if the box name is Iteration*,* the automatically generated name of a same-level box would be Iteration 1.

### Box status

The box status is displayed next to the box name in the box switcher. You can [change the box status](https://appfire.atlassian.net/wiki/spaces/SPM/pages/1918829911) in different sections of the app. In the Overview module, use the right-click or drag-and-drop option when in the [Kanban mode](https://appfire.atlassian.net/wiki/spaces/SPM/pages/1918700991). You can also change the status in the [Board module](https://appfire.atlassian.net/wiki/spaces/SPM/pages/1918796888) or on the [scope definition page](https://appfire.atlassian.net/wiki/pages/createpage.action?spaceKey=spm&title=Work%20items%20for%20Jira%20elements%20and%20actions&linkCreation=true&fromPageId=1918667414) in the box configuration.

The status is indicated using colors, and the following color-coded statuses are available:

- <span style="color: #97a0af">**Not started**</span> (gray)
- <span style="color: #4c9aff">**In progress**</span> (blue)
- <span style="color: #36b37e">**Done**</span> (green)

![Dropdown with box statuses.](media://5bec0bbe-9d84-44f5-99d6-943dcf54e556)

### Favorite (star) 

Mark the boxes as your favorites and filter out all other boxes using the switcher or the module's filters.

### Hierarchy

The box hierarchy can be modified in the Overview module’s [Hierarchy mode](https://appfire.atlassian.net/wiki/spaces/SPM/pages/1918799130). You can expand and collapse it to see the level of information you want.

## Home button

Use the **Main** in the breadcrumbs trail to navigate back to the root box.

## Search boxes

If you can't find what you are looking for by scrolling, use the search bar. It works with the box name and ID.

## Filtered view in box switcher

### Favorite boxes

In the filtered view, the box tree structure is not shown (only the boxes that match the filter).

Click the star button next to the search bar to narrow the list to your favorite boxes.

The favorite filters are in the box switcher and the Overview module.

![Boxes marked with a star as favorite.](media://ec0ede21-ab5e-4510-ac3e-fa80b60d337d)
</details>