> For the complete documentation index, see [llms.txt](https://help.aphex.co/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aphex.co/docs/planner/features/delay-reasons.md).
# Delay Reasons
{% hint style="info" %}
**Who can use this feature?**
Admins can create custom Delay Reasons. Admins, Task Owners and Assignees can add Delay Reasons to Progress Updates.
{% endhint %}
Delay Reasons give context to delayed tasks, allowing the team to explain why their task didn't progress as expected from a dropdown. Every project starts with a default list of Delay Reasons, but Project Admins can edit and add custom Delay Reasons at any time.
## Create Custom Delay Reasons
***
Creating Delay Reasons lets you build a reusable library of Delay Reasons to add when adding a delay to Tasks.
#### Creating a new Delay Reason:
* Open the Delay Reasons page, then click
* Create your custom Delay Reason by entering a name and selecting a category
Delay Categories
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 |
## 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.
#### Filter by Delay Reason:
* Click and
* 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 ViewsFilter Breakdown
| Filter | Operator | Value |
| ------------ | -------------------------------------------------- | ------------ |
| Delay Reason |
Is Is Not Is Empty Is Not Empty
| Multi-select |
## 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.
#### 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: Connect to Power BI
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://help.aphex.co/docs/planner/features/delay-reasons.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
.svg?alt=media&token=07126ce9-9b26-49e4-803a-4ad50dc07303)
* Create your custom Delay Reason by entering a name and selecting a category
.svg?alt=media&token=bcc2c555-0287-4b35-9010-79ec4f25b1af)
and .svg?alt=media&token=fce29edb-8b74-4d75-bfa0-d8ad7292c94b)
* 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 Views
