# Subcontractor

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

Task Owners, Assignees and Admins can allocate a Subcontractor to their Tasks.

***

Project Admins can create and manage the library of available Subcontractors.
{% endhint %}

Subcontractors can be assigned to Tasks to show who’s delivering the work. They help teams organise, group, and colour Tasks by Subcontractor, making it easier to coordinate and track progress across your plan.

## Creating Subcontractors

***

Creating Subcontractors lets you build a reusable library of Subcontractors to assign to Tasks.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FWX1eGZLjjoZW8XJwKelG%2FCreate%20Subcontractors.svg?alt=media&#x26;token=fba9ae7d-6431-4a92-9a82-d692152d28a8" alt=""><figcaption></figcaption></figure>

#### Creating new Subcontractors:

* Click your Project Title in the top left, then select  `Project Assets`&#x20;
* Select `Subcontractors` from the menu
* Click  <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FA6FYfK9KEBA6c3jBqK4i%2FSet%20Print%20Area.svg?alt=media&#x26;token=5ae814a5-2524-4558-940f-86bfbc795287" alt="" data-size="line">&#x20;
* Create your Subcontractor by entering a name and assign a colour&#x20;
* The Subcontractor is added to the library of Subcontractors the team can assign to their Tasks

<details>

<summary>How Subcontractors Work</summary>

* Subcontractors are a single-select property
* Subcontractor acts as a tag to show which company is delivering the work - it’s not a permission-setting field. If you want someone from that company to be able to update progress or edit the Task, add them as an Assignee or an Owner.
* Tasks can be coloured by or grouped by Subcontractor across all View types
* Archived Subcontractors will no longer be available to add to tasks but will still exist on tasks it was assigned to before the resource was archived

</details>

## Assigning Subcontractors to Tasks&#x20;

***

Assigning a Subcontractor to a Task can show who’s responsible for the work and helps with organising and visualising your plan.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F9t7mOTfjyEDR7tvdfwmE%2FGantt-%20Subcontractor.svg?alt=media&#x26;token=92d5f40c-86f0-4267-8097-2696ad549899" alt=""><figcaption></figcaption></figure>

#### Adding Subcontractors to Tasks:

* On the Gantt, use the column picker <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FS5zLHPjnK2LdNu2vxUfD%2FIcon%20Buttons.svg?alt=media&#x26;token=857cdfde-d860-4f37-9a41-73f55a5b9733" alt="" data-size="original"> to 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"> `Subcontractor`&#x20;
* Click a cell in the column and add a Subcontractor to the Task from the dropdown

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

## View Tasks by Subcontractor Colour

***

Make it easier to see which Subcontractor is responsible for an activity by changing your Task or Work Area colour according to which Subcontractor is completing the Task.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FedSLc11uMYLJOjDyeILL%2FColour%20By%20Subcontractor.svg?alt=media&#x26;token=cd1a8b69-e8c9-456d-9c55-06adcdcfaf60" alt=""><figcaption></figcaption></figure>

#### To colour by Subcontractor on the Gantt:&#x20;

* Open a Gantt View
* Click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FkxgPBsbvcbAQr29W4sSW%2FView%20Sub%20Nav%20Buttons%20(2).svg?alt=media&#x26;token=e2c9e675-ec6e-463e-a47a-50b4b05ba38a" alt="" data-size="line">&#x20;
* Click `Bar Colour` and select `Subcontractor`

#### To colour by Subcontractor on the Board: &#x20;

* Open a Board View
* Click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FkxgPBsbvcbAQr29W4sSW%2FView%20Sub%20Nav%20Buttons%20(2).svg?alt=media&#x26;token=e2c9e675-ec6e-463e-a47a-50b4b05ba38a" alt="" data-size="line">&#x20;
* Click `Task Card Colour` and select `Subcontractor`

#### To colour by Subcontractor on the Map: &#x20;

* Open a Map View
* Click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FkxgPBsbvcbAQr29W4sSW%2FView%20Sub%20Nav%20Buttons%20(2).svg?alt=media&#x26;token=e2c9e675-ec6e-463e-a47a-50b4b05ba38a" alt="" data-size="line">&#x20;
* Click `Work Area Colour` and select `Subcontractor`

## Organise your plan by Subcontractor&#x20;

***

Grouping by Subcontractor arranges the Plan by who's delivering each Task. This is possible across all View types, but let's start by looking at Group By Subcontractor on Board.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FZBuzh5AjahzvWNMHbo86%2FGroup%20By%20Subcontractor%20-%20%20Board.svg?alt=media&#x26;token=143dfb2f-e04e-4f61-b923-b06edd0cbbe7" alt=""><figcaption></figcaption></figure>

#### To Group by Subcontractor on Board:

* 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 `Subcontractor`&#x20;
* Optionally, select a different Primary Group, and select `Subcontractor` as the Sub-Group

## View Subcontractor Demand on the Gantt

***

Turn on the Resources Overlay to see how many Tasks are planned each day per Subcontractor. You’ll get a clear view of daily workload, plus a breakdown of which Tasks are contributing to it.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FGKCeQ6JEB7maE0LVIuXO%2FResource%20overlay%20-Subcontractor.svg?alt=media&#x26;token=75ec53c7-d3f3-45c8-a4a7-b5f640f55ec8" alt=""><figcaption></figcaption></figure>

#### View the Resource Overlay by Subcontractor:

* Open a Gantt View
* Click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2Fe75amJaQYaDuHwYTbCnU%2FView%20Sub%20Nav%20Buttons%20(4).svg?alt=media&#x26;token=aabb9629-a418-4e7f-a996-40b73622b8cc" alt="" data-size="line"> and select <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FryA5NhFnwKozFDRSfPLf%2FGroup%20143724520.svg?alt=media&#x26;token=30a18e1a-66cd-4653-8989-2359b4d7c74c" alt="" data-size="line">
* Click the <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FbgNo9PW0FTmkO1M0N4s9%2FIcon%20Button%20Group.svg?alt=media&#x26;token=172ef30e-b476-4c2b-8917-a3b172d3dcd0" alt="" data-size="line"> icon on the left to view your Subcontractors
* Hover over the numbers to view your **Total** and **Project Utilisation**
* Click the Resources Configuration icon <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2Fgv3wI5T0OJZFR3SZvZfB%2FVector.svg?alt=media&#x26;token=42804fc6-36d8-4fb1-aac1-09fe30aff4d1" alt="" data-size="line"> to switch between `Tasks in View` and `Project Utilisation`
* Hover over the daily quantity value <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F9D1l2IvdqWBj57q8lUGG%2F01%20Normal.svg?alt=media&#x26;token=00daf3e1-b03f-4b53-a171-cb2233e9c9ab" alt="" data-size="line"> to see the daily breakdown

<details>

<summary>What's Shown on Hover</summary>

On hover, the daily breakdown includes:

* &#x20;**# of Tasks**
  * Number of Tasks in your current View assigned to that Subcontractor on the selected day (respects filters)
* **# no of Project Tasks**
  * Number of Project-wide Tasks using assigned to that Subcontractor on the selected day (ignores filters)
* **Task Owner Breakdown**
  * Lists each Task Owner contributing to Project usage&#x20;
  * Includes Task Count and percentage of total utilisation for that day&#x20;
* **Cell shading**
  * **Darker = higher quantity**
  * Lighter - lower quantity
  * Scale is relative to the values shown in the current overlay
* **Quantity values** are only shown in Day View
  * In Week, Month or Year mode, cell shading remains but numeric values are hidden

</details>

<details>

<summary>Resource Overlay Configuration Options </summary>

| Option                         | Function                                                                   |
| ------------------------------ | -------------------------------------------------------------------------- |
| **Total**                      | The demand for tasks in your current view                                  |
| **Project Utilisation**        | The demand for your entire project                                         |
| **Hide Un-utilised resources** | Removes resources that aren’t assigned to any Tasks from the resource list |

</details>

## Filter by Subcontractor

***

Filter by Subcontractor to review and manage Tasks related to particular Subcontractors across your plan.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2Fk3KRdvAHuGcjkTq71cgb%2FFilter%20by%20Subcontractor.svg?alt=media&#x26;token=7c4899ac-bfca-4eb4-8dbb-fa71f42c8090" alt=""><figcaption></figcaption></figure>

#### Filter by Subcontractor:

* Click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FOmPqOYCGf97WdhYo8fNX%2FView%20Sub%20Nav%20Buttons%20(5).svg?alt=media&#x26;token=bf972626-ce6c-41fe-892c-b49f31e792b1" alt="" data-size="line">  then<img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FoccEaETbnXCWjDrIexSy%2FText%20Buttons%20(1).svg?alt=media&#x26;token=16bb6c15-0882-48f9-983f-92f73daeeae7" alt="" data-size="line">
* Select  `Subcontractor` in the first dropdown
* Select from `Is`, `Is Not`, `Is Empty` or `Is Not Empty` in the second dropdown
* Select your desired Subcontractor in the third dropdown

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

<details>

<summary>Filter Breakdown </summary>

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

</details>

## **Performance Breakdown by Subcontractor**&#x20;

***

Once Subcontractors have been assigned to Tasks, all updates (including Delays, On Track & Improvement events) can be traced back to each Subcontractor. This makes it easy to understand how each Subcontractor is performing across the project.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F0oKTCDDm729mOZ1Cnin1%2FProduction%20Control%20-%20By%20Subcontractor.svg?alt=media&#x26;token=33764ca9-20c1-486a-ae46-30b8f6d31298" alt=""><figcaption></figcaption></figure>

#### Aphex Insight

Aphex Insight gives you a live snapshot of Subcontractor performance - no set up required. Automatically see which Subcontractors are responsible for the highest shares of delay and why.

#### Power BI

User Power BI to build custom reporting on Subcontractor delays and performance, based on data in your weekly Published Versions. Aphex provides free templates as a starting point but everything can be customised to suit your project reporting requirements.

See also: <a href="../../integrations-and-api/power-bi/getting-started-with-power-bi-reporting" class="button secondary">Connect to Power BI</a>&#x20;
