# Progress Updates

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

Admins, Task Owners and Assignees can add Progress Updates to Tasks.
{% endhint %}

Progress Updates can be recorded to represent any delays and improvements made to a Task over time. As the plan progresses the team can log updates to keep the plan accurate and allow for a deeper understanding of the leading causes of delay and who's responsible. &#x20;

## Adding Delays to Tasks

***

Delays can be added to any day of a Task to show it's no longer on track to finish as planned. Just hit the Thumbs Down, choose a Delay Reason, log the days of impact and add optional comments or photos. It'll update the schedule automatically ad start building your delay history. Delays can be added to a Task from anywhere in the project, but let's start by looking at recording a Delay from List View.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2Fou2MCBhtS1rN04SXy0F3%2FList%20-%20Update%20Progress%20-%20Delay.svg?alt=media&#x26;token=6701e4b5-f71d-44dc-9ee9-2f1fee1d1eaa" alt=""><figcaption></figcaption></figure>

#### To Delay a Task from List View:

* Open a List View&#x20;
* Click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FZpw6cJW8Cg2BiiaJP5Ua%2FStatus%20Buttons.svg?alt=media&#x26;token=af2f2296-758f-428c-b53f-c71328d40ced" alt="" data-size="line"> on the Task card
* Configure your delay by selecting a `Delay Reason`, `impact type`, `days of impact`, `comments`, `images` and `record date`&#x20;

<details>

<summary>Delay Types</summary>

| Type   | Description                                                          |
| ------ | -------------------------------------------------------------------- |
| Extend | A task’s end date has been delayed from the prior plan or commitment |
| Move   | A tasks's start and end date has been moved (pushed later)           |

</details>

<details>

<summary>Progress Update Data</summary>

For each working day of a Task, Progress Updates can be recorded to indicate performance. Each Progress Update includes the following data:

| Progress Update Property | Description                                                                                                                          |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |
| Date                     | Selected working day to record the event against                                                                                     |
| Type                     | <p><code>Delayed</code> <code>On Schedule</code><br><code>Improved</code></p>                                                        |
| Reason                   | Reason for the change. This can be configured by each project individually and typically contains reasons such as "Awaiting Access". |
| Amount                   | Impact of the update is recorded in a Value that represents a duration in working days (+ or -)                                      |
| Amount by                | User who recorded the update                                                                                                         |
| Created at               | Timestamp of when the update was recorded                                                                                            |

</details>

## Adding Improvements to Tasks

***

Use the Thumbs Up to mark a Task as On Schedule. You can log that work went ahead as planned or even ahead of schedule, and optionally pull the end date in if things are moving faster than expected. Improvements can be added to a Task from anywhere in the project, but let's start by looking at recording one from List View.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FBVeFYxnY526yJ3u9ef7g%2FList%20-%20Update%20Progress%20-%20improvement%20(1).svg?alt=media&#x26;token=3857cf44-76c9-41d0-9b91-61df1df6bfa4" alt=""><figcaption></figcaption></figure>

#### To Improve a Task from List View:

* Open a List View&#x20;
* Click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FT4iufCRUP4u8UAK27OXW%2FGreen%20Thumbs%20Up.svg?alt=media&#x26;token=bbcfdf8d-4fc6-47d5-9377-34149b666b6b" alt="" data-size="line"> on the Task card
* Configure your `On Schedule` or `Shorten` event by selecting an `impact type`, `days of impact`, `comments`, `images` and `record date`&#x20;

<details>

<summary>Positive Impact Types</summary>

| Name        | Description                                                   |
| ----------- | ------------------------------------------------------------- |
| On Schedule | A task’s end date is confirmed as achievable.                 |
| Shorten     | A task’s end date has been improved (brought earlier).        |
| Move        | A tasks's start and end date has been moved (brought earlier) |

</details>

## Delaying Promised Tasks

***

Changing the dates of a Promised Task will automatically trigger a Progress Update. Changing the dates of Promised Tasks in a chain will trigger an option to apply Progress Updates to other Tasks that are Promised in the chain.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FQipzC2FOtmLSqIW2Tfh8%2FRipple%20Status.svg?alt=media&#x26;token=ec7ec889-47e9-44d1-9355-2f439779da6f" alt=""><figcaption></figcaption></figure>

#### To delay a promised Task:

* Update the end of a Promised Task <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FGT7b1TUfdiIkbPfAzacx%2FExtend%20Promised%20Bar.svg?alt=media&#x26;token=777c6b30-e69f-496c-a89d-de6b2b01bc27" alt="" data-size="line">
* Configure your Delay by selecting a Delay Reason, impact type, days of impact, comments, images and record date&#x20;
* If you have additional Promised Successors, choose `Yes` to apply the same delay to the linked Tasks
* Select `No` to only apply the delay to the specific Task you edited

See also: <a href="how-do-i-promise-tasks" class="button secondary">Promised Tasks</a>

## Progress Update Visualisation&#x20;

***

When a Progress Update is added, the Task Colour for that day will change to show the Progress Update added for that day. Red represents a Delay and green represents On Track or Shortened.&#x20;

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FXKgsKbb7OkTlgmCHofSc%2Fprogress%20on%20gantt.svg?alt=media&#x26;token=4fe5e4d6-561e-49c8-a2bb-a9ba4946fe81" alt=""><figcaption></figcaption></figure>

#### To see Progress Updates from the Gantt:

* Open <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FatEyMF3jrwUfTXo2wPMu%2FSub%20Nav%20Buttons.svg?alt=media&#x26;token=a8a2b20c-27ed-4afd-9af1-5bba1cacace3" alt="" data-size="line">
* Make sure that <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"> `Show Progress Updates` is enabled&#x20;
* Days with delays turn red
* Days that are On Track or Improved turn green
* The Net Delay Number is shown as a ![](https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FGnTiY17QiSjIgokUd0Ze%2FTag%20\(1\).svg?alt=media\&token=8517543a-241b-4d9e-af53-518393fcfc63) on the end of the Task Bar

## View the Delay History of a Task

***

Each Task keeps a running record of delays, improvements and updates - including who made the change, when it was logged and what the impact was.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F3JMsmzu4uDriSXwklFnI%2FView%20Delay%20History.svg?alt=media&#x26;token=31ad43ed-fd98-469b-aa64-8fe884101a42" alt=""><figcaption></figcaption></figure>

#### To see the log of all Task Progress Updates:

* Right Click a Task and select `View Details`&#x20;
* Click the <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FmzywF1aH71ELFuh4uPIS%2FIcon%20Buttons%20(1).svg?alt=media&#x26;token=66df6fc7-7e8c-404c-90c1-2cc32b0c27b1" alt="" data-size="line">icon to open the Activity Log
* See a chronological list of all Delays and Improvements added to the Task over time

See also: <a href="../tasks#task-activity-log" class="button secondary">Activity Log</a>

## Deleting Progress&#x20;

***

If a delay or improvement was logged by mistake, it can be removed from the Task. The original event itself will still be visible in the Task's activity log as a past record, but the delay & impact will not count on the Task any longer.

#### Delete a Progress Update:

* Open the Task in the right-hand panel and click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FmzywF1aH71ELFuh4uPIS%2FIcon%20Buttons%20(1).svg?alt=media&#x26;token=66df6fc7-7e8c-404c-90c1-2cc32b0c27b1" alt="" data-size="line">
* Hover over the Progress Update and click the `...`&#x20;
* Click `Delete`&#x20;

<details>

<summary>Deleting Progress rules </summary>

* Deleting Progress will not impact the dates of the task, however it does delete the record and will not appear in any reporting.&#x20;
* The Progress Update Visualisation from the Task bar will be removed and the activity log stricken out.

</details>

## Create Custom Delay Reasons&#x20;

***

Creating Delay Reasons lets you build a reusable library of Delay Reasons to add when adding a delay to Tasks.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FVYaOeeB9PWlHFZJ1KCma%2FDelay%20Reason%20-%20Create%20(2).svg?alt=media&#x26;token=07126ce9-9b26-49e4-803a-4ad50dc07303" alt=""><figcaption></figcaption></figure>

#### Creating a new Delay Reason:

* Open the Delay Reasons page, then click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FKHdUZEGF8Mz4VX4fSZWf%2FGroup%201.svg?alt=media&#x26;token=da17ec8b-2297-46a5-a239-e286fec6cdb5" alt="" data-size="line">
* Create your custom Delay Reason by entering a name and selecting a category

<details>

<summary>Delay Categories </summary>

Each delay reason needs to belong to one of the following categories:

| Delay Categories         |
| ------------------------ |
| Delay Categories         |
| Environmental            |
| Inadequate Planning      |
| Insufficient Resources   |
| Prior Work               |
| Quality                  |
| Safety                   |
| Scope Change             |
| Submittals and Approvals |

</details>

## Filter by Delay Reason

***

Once Delays have been logged, you can filter any View to show Tasks impacted by specific Delay Reasons - or simply highlight all Tasks that have recieved any Delay at all.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2Fnkvt8SgpNOD1Ls5uX5sw%2FFilted%20by%20delay%20reason%20(1).svg?alt=media&#x26;token=bcc2c555-0287-4b35-9010-79ec4f25b1af" alt=""><figcaption></figcaption></figure>

#### Filter by Delay Reason:

* 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 `Delay Reason` in the first dropdown
* Select from `Is`, `Is Not`, `Is Empty` and `Is Not Empty` in the second dropdown
* Select your desired Delay Reason 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        |
| ------------ | -------------------------------------------------- | ------------ |
| Delay Reason | <p>Is <br>Is Not <br>Is Empty <br>Is Not Empty</p> | Multi-select |

</details>

## Report on Delays

***

As the team starts to record delays against Tasks, all updates (including Delays, On Track & Improvement events) can be traced back to the responsible Task Owner or Subcontractor. This makes it easy to understand how all parties are performing across the project.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FhlZYh6YynLfVoW7h4Qp7%2FProduction%20Control.svg?alt=media&#x26;token=195885c4-f1fc-4ebf-b8a8-b00c70282ba7" alt=""><figcaption></figcaption></figure>

#### Power BI

User Power BI to build custom reporting on 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.

#### Aphex Insight

Utilise Aphex Insight to track Delay Concentration by Delay Reason. See trends and drill down into specific Tasks to identify which Delay Reason has the highest delay concentration.

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