# Packages

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

All project users can create & own Packages.&#x20;

***

Project Admins can edit and archive Packages.
{% endhint %}

Packages give you a flexible way to organise your Tasks without changing the project’s core structure. While the Folder tree typically remains the shared backbone of the plan, Packages let anyone group Tasks by whatever makes the most sense for delivery: zones, trades, phases, disciplines - you decide.

They’re easy for anyone to create, drag into a custom order, and use to shape views that are more practical for how you plan and build.

## Creating Packages

***

Packages can be created at any time while planning. Just give it a name and you're ready to start grouping Tasks in a way that works for you.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FRwRH0DH3WEQO84xcVR4f%2FCreate%20Package%20page%20(1).svg?alt=media&#x26;token=69bb4970-3e63-49aa-acdf-8ad4e9567f95" alt=""><figcaption></figcaption></figure>

#### To create a Package 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"> is set to `Package`
* An option to `Create Package` will appear on the Gantt
* Click this and give your new Package a name

<details>

<summary>How Packages Work</summary>

* Once a Package is created, it becomes available to everyone on the Project&#x20;
* Any user can assign their Tasks to an existing Package
* A Task can only belong to one Package at a time
* Packages are seperate from the Folder structure - assigning a Package does not change where the Task sits in the WBS
* Each Package has a Name and an automagically generated Code to help distinguish between similarly named Packages&#x20;
* Archived Packages will no longer be available to add to tasks but will still exist on tasks it was assigned to before the Package was archived

</details>

## Adding Tasks into a Package

***

Once your Packages are set up, it's easy to start using them. Add new Tasks straight into a Package, or update existing Tasks to move them into the right Package.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FJDbxY6QRjoAiZr6KTUUB%2FPackage%20added%20to%20task.svg?alt=media&#x26;token=9abb5847-09ea-4799-b7e3-5282e0146269" alt=""><figcaption></figcaption></figure>

#### Move existing Tasks into a Package:

* On the Gantt, open the column picker <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FfcDCzafJHCtgSfMJuQOz%2FIcon%20Buttons%20(1).svg?alt=media&#x26;token=08227bc3-6692-4d7e-818b-295f7a9cf16f" alt="" data-size="line"> and toggle <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FrvTcctNRDtoOHaw7U9zU%2FTheme%3DLight%2C%20Size%3DRegular%2C%20State%3DOn.svg?alt=media&#x26;token=d08029bc-cd20-4401-bc69-8ded58cdca38" alt="" data-size="line"> `Package`
* Click the Package cell for your task & select a Package from the dropdown menu
* Alternatively, use drag and drop to move a Task into a Package&#x20;

See also: <a href="../tasks#editing-tasks" class="button secondary">Bulk Edits</a>&#x20;

<details>

<summary>Package Properties</summary>

| Property           | Description                                                     |
| ------------------ | --------------------------------------------------------------- |
| Name               | Descriptive name given to the Package                           |
| Package Tag Colour | User-selected colour to represent the Package                   |
| Owner              | User that is accountable for the Package                        |
| Start              | Start date of the first Task within the Package                 |
| End                | End date of the last Task within the Package                    |
| Assigned to        | User(s) that have been assigned to all Tasks inside the Package |
| Notes              | Additional text notes that can be attached the Package          |
| Comments           | Thread of communications on the Package                         |
| Documents          | Documents that have been uploaded and attached to the Package   |

</details>

## Group By Package&#x20;

***

Group by Package gives you a simple way to lay out your plan around the Packages you're using. This is possible across all View types, but let's start by looking at Group By Package on the Board.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F2e3YQakVFYnt8rRj2e6W%2FGrouped%20by%20Package.svg?alt=media&#x26;token=36fe006a-083a-4b0b-8398-ccb0e861c6b1" alt=""><figcaption></figcaption></figure>

#### To Group By Package on the Board:

* Open a Board View
* Click  <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">
* Select `Package`&#x20;
* Optionally, select a different Primary Group, and select `Package` as the Sub-Group

Packages are flat and do not allow for sub-packages to be created. If you need more hierarchy, it's best to use Subfolders to build out your plan.

## Reorder Packages

***

Change the order of Packages in your Plan by dragging and dropping them.&#x20;

#### To reorder Packages:

* Hover over the Package you want to move
* Use **`⋮⋮`** to drag your Packages in the order in which you want them to be displayed
* Drop the Package to a new location

<details>

<summary>Package Order Behaviour</summary>

* The Package order is unique to each user, so moving them has no impact on how other users view them in the plan
* For each View, you have have a custom Package order

</details>

## Filter by Package&#x20;

***

Apply a Package filter to see only the Tasks sitting in specific Packages in your Project .

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F8VB3GuRhZXiPKeJCWgEM%2FFilted%20by%20Package.svg?alt=media&#x26;token=d034b19c-20dc-4031-9284-c437595f9a46" alt=""><figcaption></figcaption></figure>

#### To filter by Package:

* 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 `Package` in the first dropdown
* Select from `Is`, `Is Not`, `Is Empty` or `Is Not Empty` in the second dropdown
* Select your desired Package in the third dropdown

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

<details>

<summary>Filter Breakdown</summary>

| Filter  | Operator                                           | Value                          |
| ------- | -------------------------------------------------- | ------------------------------ |
| Package | <p>Is <br>Is Not <br>Is Empty <br>Is Not Empty</p> | <p>Multi-Select</p><p><br></p> |

</details>
