# Calendars

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

Admin users can create, edit and archive the library of available Calendars.&#x20;

***

Task Owners, Assignees and Admins can change the Calendar allocated to their Tasks.
{% endhint %}

Calendars define your project’s working and non-working days. Task durations are based only on the working days set in the assigned Calendar, so Tasks won’t be scheduled on non-working days.

## Creating Calendars

***

Create a custom Calendar to set specific working and non-working days that match your project’s schedule.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FlnFoxiYYhOBDZfur5fef%2FCreate%20Calendar%20(1).svg?alt=media&#x26;token=41367bfa-7209-47ca-8fef-190a836d0659" alt=""><figcaption></figcaption></figure>

#### **To create a Calendar:**

* Click your Project Title in the top left, then select  `Project Assets`&#x20;
* Select `Calendars` from the menu
* Click  <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F4D17dzy2H17Ur1n0zSGP%2FCleanShot%202025-01-24%20at%2009.43.07.png?alt=media&#x26;token=9f946e21-a608-492e-8235-cda0950a2437" alt="" data-size="line">&#x20;
* Add a name and choose a colour to represent the Calendar
* Pick your base Working Days&#x20;
* Click specific days on the Calendar to mark them as `Working` or `Non-Working` exceptions&#x20;
* Optionally, <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F5aoJewj3MaWURZyLSm6N%2FCheckbox%20from%20Notepad.svg?alt=media&#x26;token=4efec9a4-2110-45c6-9aef-15e18bb3b0b4" alt="" data-size="line">&#x20;
* Click `Done` once you're finished editing
* The Calendar is added to the library of Calendars the team can assign to their Tasks

See also: <a href="../gantt#group-dates-and-durations" class="button secondary">Group Calendars</a>

<details>

<summary>Aphex provided Calendars </summary>

| Name      | Working Days                                                   |
| --------- | -------------------------------------------------------------- |
| Five Day  | Monday, Tuesday, Wednesday, Thursday, Friday                   |
| Six Day   | Monday, Tuesday, Wednesday, Thursday, Friday, Saturday         |
| Seven Day | Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday |

</details>

<details>

<summary>Project Default Calendar </summary>

* The default Calendar will be applied to all New Tasks created in the Project
* If you change the default later, it won’t affect existing Tasks, they’ll stay on the calendar they were originally assigned

</details>

<details>

<summary>Non-Working Days</summary>

Adding non-working days to a Calendar will automatically prevent tasks from being scheduled on those days. You can create multiple calendars with different non-working patterns to suit your project.

</details>

## Edit an existing Calendar&#x20;

***

You can edit an existing Calendar to update working days, non-working days, change its name or colour.

#### To edit a Calendar:

* Click your Project Title in the top left, then select  `Project Assets`&#x20;
* Select `Calendars` from the menu
* Hover over the existing Calendar&#x20;
* Click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FjnG9aPWXiJ7oMUQpTOVC%2FIcon%20Buttons.svg?alt=media&#x26;token=acb02156-f7b3-4e2f-8bb4-b5b43c30a13c" alt="" data-size="line"> then select `Edit`
* If the Calendar is already in use, select whether to apply changes to existing Tasks or keep their current dates unchanged

<details>

<summary>Editing a Calendar in use </summary>

Making changes and saving a Calendar that is in use generates a prompt with the following options:

| Prompt                                   | Function                                                                                        | Exceptions                                                                                                                           |
| ---------------------------------------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| Save and hold dates on existing Tasks    | The edited calendar will not be applied to any existing Tasks                                   | Making any changes to the start date, end date or duration of a Task will apply the updated calendar to the Task                     |
| Save and force reschedule existing Tasks | The edited calendar will be applied to all future planned tasks and Tasks with days in progress | The edited calendar will not automatically be applied to any Tasks that have finished (no working days in progress or in the future) |

</details>

## Assigning Calendars to Tasks

***

Assigning a Calendar to a Task sets its working days and controls when it can start or finish.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FhkV5dol8llOgV8mUIO7f%2FGantt-%20Calendar.svg?alt=media&#x26;token=4f77030e-9f36-41df-9619-19daf34f26d4" alt=""><figcaption></figcaption></figure>

#### **To update the Calendar on a Task:**

* On the Gantt, navigate to 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="original"> and toggle on <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"> `Calendar`
* Click a cell in the column to add a Calendar to the Task from the dropdown
* See the non-working days appear with reduced opacity on the Task Bar ![](https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2Fui9DtobcNP8kO1Uhj29e%2FGroup%20143724558.svg?alt=media\&token=95caa9d7-8c8b-479b-8c1e-ce4319c9ed2f)

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

<details>

<summary>Calendar Property Rules </summary>

* Each Task can have one Calendar assigned, you can’t add multiple calendars to a single Task
* Archived Calendars will no longer appear as an available option to add to tasks, but will still exist on any tasks they were assigned to before they were archived

</details>

## Filter by Calendar

***

Filter by Calendar to focus on Tasks working to a certain schedule.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F2yjBW4pMKanLq4VzIaur%2FFilted%20by%20Calendar%201.svg?alt=media&#x26;token=04e5e29f-9d99-43a6-83df-6da2fdc448d8" alt=""><figcaption></figcaption></figure>

#### To set a Calendar Filter:

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

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


---

# 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-change-the-non-working-days-of-a-task.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.
