# Status

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

Admins & Owners can update Task Status. This can be changed to Admin only and Admins, Owners & Assignees in the Project Permissions

***

Admins can regress Task Status, this can be changed to All Members in the Project Permissions
{% endhint %}

Task Status helps track the lifecycle of work, from planning, to commitment, to completion. It’s a simple way to bring structure and accountability to the plan.

## Updating Task Status to Promised

***

Promised Tasks are commitments. If the committed dates are changed, a delay reason must be recorded in order for the update to save.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FnbCMjJhz8wT947TkCMsd%2FAdd%20Status%20-%20Promised%20(1).svg?alt=media&#x26;token=80f53745-5cfc-4130-bd17-ccc6ea54a088" alt=""><figcaption></figcaption></figure>

#### Change Task Status to Promised:

* 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%2FvKmhsEo7KN1cBILxsani%2FColumn%20Picker%20Buttons.svg?alt=media&#x26;token=9c6cc79d-7f88-4492-a6ea-7f2ba6418ffc" 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"> `Status` &#x20;
* Click the Status cell for your task & select `Promised` from the dropdown menu

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

<details>

<summary>How Promised Tasks Look in the Plan</summary>

| Status   |                                  | Visual                                                                                                                                                                                                                                                                                                 |
| -------- | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Promised | Start and End Date Visualisation | <div><figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FEwGIFsKHz1Kz5CoxV3VV%2FDate%20Icon%20(2).svg?alt=media&#x26;token=8a9dab0c-246d-4fd2-8d9e-d77e62f7ee06" alt=""><figcaption></figcaption></figure></div> |
| Promised | Task Bar Visualisation           | <div><figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FZQgM3tOeOwWTjsoFePnL%2FTask%20(1).svg?alt=media&#x26;token=b33203e8-03af-4818-8b16-62c44a46953f" alt=""><figcaption></figcaption></figure></div>        |

</details>

## Updating Task Status to Done&#x20;

***

Done Tasks are those determined to have actualised start and end dates. Done Tasks are locked in place so no date changes or Progress Updates can be made.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FOC5Tc2LdN9sUBL8lcoSd%2FAdd%20Status%20-%20Done%20(1).svg?alt=media&#x26;token=85a74f06-49f1-4775-9437-edefd83f29cd" alt=""><figcaption></figcaption></figure>

#### Change Task Status to Done:

* 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%2FvKmhsEo7KN1cBILxsani%2FColumn%20Picker%20Buttons.svg?alt=media&#x26;token=9c6cc79d-7f88-4492-a6ea-7f2ba6418ffc" 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"> `Status` &#x20;
* Click the Status cell for your task & select `Done` from the dropdown menu

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

<details>

<summary>How Done Tasks Look in the Plan</summary>

| Status |                                  | Visual                                                                                                                                                                                                                                                                                           |
| ------ | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Done   | Start and End Date Visualisation | <div><figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2Fq6lMwPIDfUkP6q0rQdam%2FDate%20Icon.svg?alt=media&#x26;token=61d6ff00-2b03-448c-bfdc-cb978f4dfcca" alt=""><figcaption></figcaption></figure></div> |
| Done   | Task Bar Visualisation           | <div><figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FIjIbw5vXFFHivqu0et28%2FTask.svg?alt=media&#x26;token=f95dcf2f-0dc5-4b6f-a3cf-77317f28e79f" alt=""><figcaption></figcaption></figure></div>        |

</details>

## Revert a Task Status to Planned&#x20;

***

Planned Tasks are those not yet promised to be delivered, and can be moved freely. This is the default state of all tasks.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2Ftneg87krxIoYgBGscg7s%2FAdd%20status%20-%20Revert%20to%20planned%20(1).svg?alt=media&#x26;token=2fbb3960-41d7-4d5e-8fc4-ba39fc4c98f9" alt=""><figcaption></figcaption></figure>

#### Revert Task Status to Planned:

* 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%2FvKmhsEo7KN1cBILxsani%2FColumn%20Picker%20Buttons.svg?alt=media&#x26;token=9c6cc79d-7f88-4492-a6ea-7f2ba6418ffc" 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"> `Status` &#x20;
* Click the Status cell for your task & select `Planned` from the dropdown menu

<details>

<summary>How Planned Tasks Look in the Plan</summary>

| Status  |                                  | Visual                                                                                                                                                                                                                                                                                                 |
| ------- | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Planned | Start and End Date Visualisation | <div><figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FoPydnhMzPhNdGEgyPeRV%2FDate%20Icon%20(1).svg?alt=media&#x26;token=da04926f-5923-4f28-84a3-37fda1f96906" alt=""><figcaption></figcaption></figure></div> |
| Planned | Task Bar Visualisation           | <div><figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FoLP6xrV78ODwDJkM2yAf%2FFrame%202582.svg?alt=media&#x26;token=6690423d-ceab-40c7-952a-f62ea4782724" alt=""><figcaption></figcaption></figure></div>      |

</details>

## Promised Period &#x20;

***

The promised Period can be set when Publishing. The Promised Period is shown as a hatched section on the Gantt, ending with a solid purple Promised Line.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FcLTdDpzscoydZX0Pr4nr%2FPromised%20period%20on%20gantt.svg?alt=media&#x26;token=32d3a9ea-095c-4a7e-884f-60f09a6383f9" alt=""><figcaption></figcaption></figure>

* On the Gantt, Hover over <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FdwtMuWsTEvTlNkF3hyw7%2FGroup%202604.png?alt=media&#x26;token=eb08a115-cd72-4cb7-b3c9-aae57c6ac8ee" alt="" data-size="line"> and Click&#x20;
* A menu will appear, on the menu click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F04QV0VTAvD9j7LKn4Ldw%2FClear%20Promised%20Flags.svg?alt=media&#x26;token=e1cee85b-8903-4e19-a168-c22981206be9" alt="" data-size="line">&#x20;

See also: <a href="../published-versions-and-shared-plans#publishing-automations" class="button secondary">Set Promised Period</a>

## Filter by Status&#x20;

***

Filtering by Status lets you show or hide Tasks based on whether they're Planned, Promised or Done.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FnzclJymD52KRC7WXmgyu%2FFilted%20by%20Status%20-%20DoNe.svg?alt=media&#x26;token=93734a1f-1160-4342-85b6-84a47bc4856a" alt=""><figcaption></figcaption></figure>

**Filter by Status:**

* 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 `Status` in the first dropdown
* Select from `Is` or `Is Not` in the second dropdown
* Select from `Planned`, `Promised` or `Done` 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        |
| ------ | -------------------- | ------------ |
| Status | <p>Is <br>Is Not</p> | Multi-Select |

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.aphex.co/docs/planner/features/how-do-i-promise-tasks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
