# Folders

{% hint style="info" %}
**Who can access this feature?**

Project Admins can run Master Schedule Imports.
{% endhint %}

In Aphex, the project’s WBS is built using Folder&#x73;**.** Folders and Subfolders are how teams organise and group Tasks across the plan - whether you're pulling in a detailed structure from P6 or Asta, or building a more streamlined setup to suit daily and weekly site planning.

## Create a Root Folder

***

Root Folders sit at the top of your Folder hierarchy - everything else rolls up into them. You can create one directly from the Gantt while planning, or use the Folders Management page to build out your structure more intentionally.

#### **From the Gantt**

* Make sure that your <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F3oofYkeyY0B6LQb6YzOb%2FSub%20Nav%20Buttons%20(1).svg?alt=media&#x26;token=b752f56a-c695-45a9-a45d-c0f6f35d8ec4" alt="" data-size="line"> set to `Folders`
* An option to `Add Root Folder` will appear on the Gantt

#### **From the Folders Management Page:**

* Click your Project Title in the top left, then select  `Project Assets`&#x20;
* Select `Folders` from the menu
* Click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FWmq5CtOcnjIyKxo5j7kn%2FCreate%20Root.svg?alt=media&#x26;token=0405419a-7868-44ad-953f-991b04deaf5f" alt="create new root" data-size="line">&#x20;
* Add a Folder Name and update the code if needed
* Click `Save`
* The Folder is added to the project structure, ready for the team to add Tasks into

<details>

<summary>Folder Code Logic</summary>

* Each Folder has a unique code
* If a duplicate code is attempted to be created, the code will autocorrect to `<value>[duplicate]` until it is edited back to a unique code
* Folders use a tree-style structure - each level down the tree adds another decimal place to the code, showing its position in the hierarchy

</details>

## Create a Subfolder

***

Subfolders help you build out your Folder Structure with as much detail as your plan needs. You can nest Subfolders as deep as required - there's no limit!

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FNe4dLVls6oU90GpqbX83%2FCreate%20Subfolder%20from%20Gantt.svg?alt=media&#x26;token=b5212cb6-e163-43eb-8c57-b99399a10430" alt=""><figcaption></figcaption></figure>

**From the Folders Management Page:**

* Click your Project Title in the top left, then select  `Project Assets`&#x20;
* Select `Folders` from the menu
* Hover over the Folder you would like to add a Subfolder to
* Click on the `+` symbol
* Select `Add Sub-Folder`
* Add a Folder Name and update the code if needed
* Click `Save Changes`
* The Subfolder is added to the project structure, ready for the team to add Tasks into

#### **From the Gantt:**

* Hover over the Folder you are adding to
* Click on the `+` symbol
* Select `Add Subfolder`
* Type in the Subfolder Name & select the `Create [Folder Name]` button

## Protect a Folder

***

If parts of your Folder Structure need to stay exactly as they are, you can apply Folder Protection. You can lock down changes to names, codes, position, or structure - including the ability to add Subfolders.

#### To Protect a Folder:

* Click your Project Title in the top left, then select  `Project Assets`&#x20;
* Select `Folders` from the menu
* Locate the Folder you'd like to Protect
* Click the ![](https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FP5g4xT0ielVlw1t606oZ%2F%EF%8B%BE%20\(1\).svg?alt=media\&token=3184549e-130f-4fea-a058-0e9d1593f7d1) in the `State` column to cycle through the various Protected States:
  * ![](https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FP5g4xT0ielVlw1t606oZ%2F%EF%8B%BE%20\(1\).svg?alt=media\&token=3184549e-130f-4fea-a058-0e9d1593f7d1) `Default`
  * ![](https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2Fj3OMNqo3MKcqJZMRilhu%2F%EF%8B%BE%20\(2\).svg?alt=media\&token=8a8c3b81-a6a9-4b16-a868-673e447a4cc1) `Semi-Protected`
  * ![](https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FVLj7UDAL7uIhO28xsReQ%2FFrame%2014%20\(1\).svg?alt=media\&token=0ab9ddd5-96a3-4704-b8c9-8f77c44c2f0e) `Protected`
* Click `Save Changes`

<details>

<summary>Protected Folder State Definitions </summary>

Folders will have one three states:

<table><thead><tr><th width="160.3515625">State</th><th width="165.84765625" align="center">Edit Name &#x26; Code</th><th width="88.0546875" align="center">Move</th><th width="92.16796875" align="center">Delete</th><th width="151.5078125" align="center">Add Subfolder</th></tr></thead><tbody><tr><td><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FP5g4xT0ielVlw1t606oZ%2F%EF%8B%BE%20(1).svg?alt=media&#x26;token=3184549e-130f-4fea-a058-0e9d1593f7d1" alt=""> Default</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td></tr><tr><td><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2Fj3OMNqo3MKcqJZMRilhu%2F%EF%8B%BE%20(2).svg?alt=media&#x26;token=8a8c3b81-a6a9-4b16-a868-673e447a4cc1" alt=""> Semi-Protected</td><td align="center">-</td><td align="center">-</td><td align="center">-</td><td align="center">✓</td></tr><tr><td><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FVLj7UDAL7uIhO28xsReQ%2FFrame%2014%20(1).svg?alt=media&#x26;token=0ab9ddd5-96a3-4704-b8c9-8f77c44c2f0e" alt=""> Protected</td><td align="center">-</td><td align="center">-</td><td align="center">-</td><td align="center">-</td></tr></tbody></table>

</details>

## **Moving Folders**

***

Reordering Folders is quick and flexible. Move a single Folder or an entire branch - just remember that the Folder Structure is shared with everyone on the project, so your updates will apply project-wide.

#### **To move a Folder using Drag & Drop**&#x20;

* Click your Project Title in the top left, then select  `Project Assets`&#x20;
* Select `Folders` from the menu
* Hover over the Folder name & click and hold to the left of the checkbox&#x20;
* Drag the Folder to move it
* Click `Save Changes`

**To move a Folder using the Overflow Menu**&#x20;

* Hover over the Folder & click the `...`
* Select `Move` to bring up the menu
* Click on the Folder you want to move to & confirm using the <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FVF3gF0S51zGDF8oRRAtf%2FFAB%20Confirm%20Tick.svg?alt=media&#x26;token=1c8f99de-4714-49b9-8d31-3cf7a8f33d7b" alt="" data-size="line"> button
* Click `Save Changes`

<details>

<summary>Moving Branches and Individual Folders</summary>

* Folder codes update to match their new Parent. If you move a Folder, its code prefix will adjust to reflect its new location.

**Move the entire Folder Branch:**

* All your selected Folders (& contained Subfolders) will keep their original nested positions after being moved under the destination Folder.

**Move the selected Folders only:**

* All your selected Folders (& contained Subfolders) will be flattened to the same level under the destination Folder.&#x20;

</details>

## Duplicating Folders

***

You can duplicate Folders to help build out your Folder Structure faster – avoiding the need to recreate similar setups manually.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FVDHHVigZDwGzuCcMq5xy%2FGantt%20Duplicate%20Folder%20(1).png?alt=media&#x26;token=74f0f15a-b823-4d36-9c8a-1757fbd36954" alt=""><figcaption></figcaption></figure>

**From the Folders Management Page:**

* Click your Project Title in the top left, then select  `Project Assets`&#x20;
* Select `Folders` from the menu
* Hover over the Folder & click the `...`
* Choose one of the two duplication options:
  * `Duplicate` – duplicates only the selected Folder.
  * `Duplicate Branch` – duplicates the Folder and all its Sub-Folders.
* Click `Save Changes`

<details>

<summary>Folder State &#x26; Naming</summary>

* All duplicated folders are created in an unprotected state, regardless of the original folder's status.
* The duplicated folder will copy the name and colour from the original.
* The folder code will receive a `[duplicate]` suffix.

</details>

<details>

<summary>Permissions</summary>

Folder duplication permissions vary based on your role and whether Root Folder Creation is enabled:

| Project Setting                                               | Admin User Action                   | Member User Action                                                         |
| ------------------------------------------------------------- | ----------------------------------- | -------------------------------------------------------------------------- |
| Admins Only                                                   | Can duplicate any folder or branch. | All duplication options are disabled.                                      |
| <p>Admins & Members<br><em>(Allow Root Folders: On)</em></p>  | Can duplicate any folder or branch. | Can duplicate any folder or branch.                                        |
| <p>Admins & Members<br><em>(Allow Root Folders: Off)</em></p> | Can duplicate any folder or branch. | Cannot duplicate root-level folders, but can duplicate any nested folders. |

</details>

**From the Gantt:**

* Locate the Folder(s) you want to duplicate.
* Hover over the Folder & click the  `...`
* Choose one of the two duplication options:
  * `Duplicate` – duplicates only the selected Folder and the tasks visible within it.
  * `Duplicate Branch` – duplicates the Folder, all its Sub-Folders, and the tasks visible within them.
* Choose one of the two options in the Task Ownership Modal
  * `Keep original Owners`
  * `Assign Ownership to me`
* Click `Confirm Duplicate`

<details>

<summary>Folder State &#x26; Naming</summary>

* All duplicated folders are created in an unprotected state, regardless of the original folder's status.
* The duplicated folder will copy the name and colour from the original.
* The folder code will receive a `[duplicate]` suffix.

</details>

<details>

<summary>Permissions &#x26; Task Ownership</summary>

Folder duplication permissions vary based on your role and whether Root Folder Creation is enabled:

| Project Setting                                               | Admin User Action                   | Member User Action                                                         |
| ------------------------------------------------------------- | ----------------------------------- | -------------------------------------------------------------------------- |
| Admins Only                                                   | Can duplicate any folder or branch. | All duplication options are disabled.                                      |
| <p>Admins & Members<br><em>(Allow Root Folders: On)</em></p>  | Can duplicate any folder or branch. | Can duplicate any folder or branch.                                        |
| <p>Admins & Members<br><em>(Allow Root Folders: Off)</em></p> | Can duplicate any folder or branch. | Cannot duplicate root-level folders, but can duplicate any nested folders. |

When duplicating tasks, ownership is handled differently depending on your role and selected option:

| User Role                          | Keep Original Owners                                                             | Assign Ownership to Me                        |
| ---------------------------------- | -------------------------------------------------------------------------------- | --------------------------------------------- |
| Admin                              | All duplicated tasks will keep their original owners.                            | All duplicated tasks will be assigned to you. |
| Member (No Delegate Permissions)   | Tasks owned by other users will be skipped and not duplicated.                   | All duplicated tasks will be assigned to you. |
| Member (With Delegate Permissions) | Tasks owned by other users will be skipped unless you have delegate permissions. | All duplicated tasks will be assigned to you. |

</details>

## Import Folders from a CSV

***

To use the Folder Importer, upload a spreadsheet with both a Code and Name for each Folder.

#### To format your Import File: <a href="#prepare-wbs" id="prepare-wbs"></a>

The importer works with CSVs exported from other planning tools. If your system doesn’t support folder exports, you can copy folder codes and names manually into our template.

<table data-card-size="large" data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center"><p><mark style="color:purple;"><strong>Sample Folder Import</strong></mark></p><p><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F8cnluBnBcYGC5XOKFm6h%2Fdownload_120262.png?alt=media&#x26;token=43dbcff7-70ae-4ab8-b19b-5769ea8412da" alt="" data-size="line"></p></td><td><a href="https://get.aphex.co/hubfs/Lead%20Gen%20Forms,%20Templates%20and%20Tools%20(Do%20not%20edit)/Import%20Templates/Template%20-%20Import%20WBS.csv">https://get.aphex.co/hubfs/Lead%20Gen%20Forms,%20Templates%20and%20Tools%20(Do%20not%20edit)/Import%20Templates/Template%20-%20Import%20WBS.csv</a></td></tr></tbody></table>

#### To run a Folder Import: <a href="#prepare-wbs" id="prepare-wbs"></a>

* Click your Project Title in the top left, then select  `Project Assets`&#x20;
* Select `Folders` from the menu
* Click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FLpgpV4iN2kYuHKZSisMX%2FImport%20Button.svg?alt=media&#x26;token=8153e0a0-a04a-43a9-b266-8d00061f234e" alt="" data-size="line">
* Choose either `Upload a File` or `Copy and Paste`
* Add your data (upload CSV or copy and paste)
* Map both the `Folder Code` and `Name` fields
* Review your data
* Complete the Import

See also: import Folders from your  <a href="importing-your-master-schedule-xml" class="button secondary">Master Schedule </a>

<details>

<summary>Folder Import Data Format</summary>

| Property    | Format                                                                                                                                                                                                                       |
| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Folder Code | <p>A period-separated code (sometimes called WBS path)</p><p>Example; East.123.A.1</p><p>This would be imported as</p><ul><li><p>East</p><ul><li><p>123</p><ul><li><p>A</p><ul><li>1</li></ul></li></ul></li></ul></li></ul> |
| Folder Name | Any String                                                                                                                                                                                                                   |

</details>

<details>

<summary>Importer Logic: Duplicates &#x26; Branch Creation</summary>

* The importer automatically warns and excludes any duplicate Folder codes
* The importer will autocomplete branches where they are missing in the source file.&#x20;

  For example, a Folder Code imported as East.123.A.1 will automatically create the parent nodes of East, East.123, and East.123.A if they are not included in either the source file or the existing Aphex project

</details>

## Deleting Folders

***

Folders can be deleted one by one or in bulk - whatever works best for your clean-up.

#### To delete a Folder:

* Click your Project Title in the top left, then select  `Project Assets`&#x20;
* Select `Folders` from the menu
* Hover over the Folder you wish to delete
* Select `...` and then `Delete Folder`

<details>

<summary>Folder Deletion Rules</summary>

* Folders that contain Tasks can not be deleted - the Tasks need to be ejected from the Folder first
* Deleted Folders are automatically removed from the Project's Structure and Gantt
* Deleted Folders cannot be restored
* Opting to delete the entire Folder branch will delete the selected row, and all Folders nested underneath

</details>

## Group by Folder

***

This organises your Tasks by the Folders they belong to. It's a simple way to view your plan in the same structure used across the Project.&#x20;

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FwKP5qnEiBNM6hQd3xfH4%2FGantt%20Group%20By.svg?alt=media&#x26;token=42c8b418-e29d-4b52-ac12-d622e457b906" alt=""><figcaption></figcaption></figure>

#### To Group By Folder on the Gantt:

* Click the <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F3oofYkeyY0B6LQb6YzOb%2FSub%20Nav%20Buttons%20(1).svg?alt=media&#x26;token=b752f56a-c695-45a9-a45d-c0f6f35d8ec4" alt="" data-size="line"> menu in the top left of the Gantt
* Pick `Folder` as a Primary Grouping

#### To switch between Folder Tree and Flattened Folders:

* Click the <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F3oofYkeyY0B6LQb6YzOb%2FSub%20Nav%20Buttons%20(1).svg?alt=media&#x26;token=b752f56a-c695-45a9-a45d-c0f6f35d8ec4" alt="" data-size="line"> menu in the top left of the Gantt
* Select the button next to `Folder` to switch to `Flattened Folders`
* `Flattened Folders` shows only the lowest level Folder for each Task in a single row
  * The full Folder path appears above the Folder Name, saving vertical space
* Click the same icon again to return to `Folder Tree` mode
  * `Folder Tree` shows your full Folder hierarchy, one row per level, so you can see exactly where each Tasks sits in the structure.

## Filter by Folder

***

Apply a Folders Filter to see only the Tasks sitting in certain parts of your Project structure.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FoDQT1n2yKfAhZDWz7N3j%2FGroup%20143724521.svg?alt=media&#x26;token=c33f3e56-0807-4aa7-8fad-2060bea6883a" alt=""><figcaption></figcaption></figure>

#### To set a Folder Filter:

* Click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F1uSzhSb5aSNnZd5vTaGB%2FFilter%20Button.svg?alt=media&#x26;token=8ddd7f1c-0296-4af2-bdeb-d08d56fc56b6" alt="" data-size="line"> and <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FbVv9qtyepRHQfkVwypud%2FText%20Buttons%20(2).svg?alt=media&#x26;token=fce29edb-8b74-4d75-bfa0-d8ad7292c94b" alt="" data-size="line">
* Select `Folder` in the first dropdown
* Select the Operator in the second dropdown
  * `Is Within` to reveal Tasks that sit inside the selected branch
  * `Is` to reveal Tasks that belong to the specific Folder
* Pick your Folders in the third dropdown
* Click `Apply Selected`

See also: create & share <a href="view-controls" class="button secondary">Views</a>

<details>

<summary>Filter Breakdown</summary>

| Filter | Operator                                                                      | Value        |
| ------ | ----------------------------------------------------------------------------- | ------------ |
| Folder | <p>Is<br>Is Not<br>Is Within<br>Is Not Within<br>Is Empty<br>Is Not Empty</p> | Multi-select |

</details>
