> For the complete documentation index, see [llms.txt](https://support.holidayhero.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.holidayhero.com/the-basics/tasks.md).

# Tasks

<figure><img src="http://localhost:63342/markdownPreview/1551689540/docs/support/tasks/task-views.webp" alt=""><figcaption><p>The task overview, on the <strong>Open</strong> view</p></figcaption></figure>

#### What is a task? <a href="#what-is-a-task" id="what-is-a-task"></a>

A **task** is a to-do for your team. Whether it's a maintenance request, a guest follow-up or a pre-arrival preparation, tasks give you a structured way to assign, track and resolve operational work.

Tasks can stand on their own, or be attached to a reservation, a listing or a conversation so everyone can see what the work relates to.

A task is assigned to an operator, or to a [department](https://support.holidayhero.com/the-basics/workspace/staff/departments.md) when it is work for a team rather than for one person — Housekeeping, Maintenance, Front Desk.

Every task is visible to every operator in your workspace. Assigning a task says who is *responsible* for it — it does not hide it from anyone else.

#### Views <a href="#views" id="views"></a>

The overview opens on three views, each grouping the statuses an operator thinks about together:

| View            | Statuses it shows                                        |
| --------------- | -------------------------------------------------------- |
| **Open**        | `OPEN`, `SCHEDULED`                                      |
| **In Progress** | `WAITING_ON_SUPPLIER`, `IN_PROGRESS`, `WAITING_ON_GUEST` |
| **Closed**      | `CANCELLED`, `AUTO_CLOSED`, `COMPLETED`, `FAILED`        |

The **Tasks** item in the menu carries a badge with the number of open tasks in the workspace, and takes you straight to the **Open** view, so the two always agree.

Next to the views sits an **Assigned to me** switch. Turn it on to narrow whichever view you are looking at down to the tasks assigned to you; turn it off to see everyone's again. It keeps your view, sort and any other filters in place.

**Assigned to me** only shows tasks assigned to you personally. To see the work waiting for your team, use **+ Filter** and pick your **Department**.

{% hint style="info" %}
The views are a shortcut, not a limit. **+ Filter** still lets you pick a single status, a specific operator or a department, and **Sort** reorders the list. Switching views clears a single-status filter, so the two can never contradict each other.
{% endhint %}

#### Task statuses <a href="#task-statuses" id="task-statuses"></a>

| Status                  | Description                                                                                  |
| ----------------------- | -------------------------------------------------------------------------------------------- |
| **Open**                | The task has been created and is waiting to be picked up.                                    |
| **In Progress**         | An operator is actively working on the task.                                                 |
| **Scheduled**           | The task has been scheduled for a future moment.                                             |
| **Waiting on Guest**    | The task is paused pending a response or action from the guest.                              |
| **Waiting on Supplier** | The task is paused pending a response or action from a supplier.                             |
| **Completed**           | The task has been resolved successfully.                                                     |
| **Failed**              | The task could not be completed.                                                             |
| **Cancelled**           | The task is no longer relevant.                                                              |
| **Auto Closed**         | The task passed its **Auto close at** moment without being resolved, and was closed for you. |

**Auto Closed** is the one status you cannot set by hand — see[ Auto close](#auto-close) below.

#### The task page <a href="#the-task-page" id="the-task-page"></a>

<figure><img src="http://localhost:63342/markdownPreview/1551689540/docs/support/tasks/task-details.webp" alt=""><figcaption><p>A task's details</p></figcaption></figure>

Click **View** on any row to open a task. The card shows its status, title and description, followed by who it is **Assigned To**, when it was **Created**, its **Auto close at** moment, and what it is **Attached To**. A task assigned to a department shows the department's coloured badge under **Assigned To**; the task lists and the **Tasks** tabs of reservations and listings show it the same way.

Underneath sits the timeline: every note, every status change and every change of assignment, newest first, each with its author and the moment it happened.

The buttons at the top right are **Assign** and, depending on where the task stands, **Resolve** or **Reopen**.

#### Attaching a task <a href="#attaching-a-task" id="attaching-a-task"></a>

A task can be attached to one **reservation**, **listing** or **conversation**. Attaching gives the task context: the object's card appears next to the task, with a link straight through to it, and the task shows up under the **Tasks** tab of the reservation or listing it belongs to.

To attach a task:

1. Open the task.
2. Next to **Attached To**, click **Attach** (or **Change**, if it is already attached to something).
3. Pick the **Type** — Reservation, Listing or Conversation.
4. Search for the object and select it from the results.
5. Click **Save**.

Search matches what you would expect for each type. For reservations you can search on the guest's name or email, or on either the internal or the OTA reservation number; for listings, on the name, nickname or city. Conversations are listed with the most recently active first, and you can narrow them by participant or channel.

To detach a task, open the same window, set **Type** to **Nothing (detach)** and click **Save**. The task stays exactly as it is — only the link is removed.

{% hint style="info" %}
A task can be attached to one object at a time. Choosing a different one replaces the previous link rather than adding to it.
{% endhint %}

When you create a task from a reservation or a listing, it is attached for you — see [Reservation tasks](https://support.holidayhero.com/the-basics/reservations/tasks.md).

#### Auto close <a href="#auto-close" id="auto-close"></a>

Some tasks stop being worth chasing after a certain moment: a pre-arrival reminder is pointless once the guest has checked in. **Auto close at** sets the moment a task closes itself.

1. Open the task.
2. Next to **Auto close at**, click **Set** (or **Change**, if a moment is already set).
3. Pick the date and time.
4. Click **Save**.

The moment is read in your own timezone. When it passes and the task has not been resolved, the task moves to `AUTO_CLOSED` and the timeline records it as **Automatically closed**, attributed to the *System*. To turn it off again, open the same window, clear the field and save.

{% hint style="info" %}
A moment in the past is accepted — the task simply closes on the next sweep. Resolving a task yourself before the moment arrives always wins; auto close only ever acts on tasks that are still open.&#x20;
{% endhint %}

An auto-closed task is not stuck. Click **Reopen** and it goes back to `OPEN`.

#### Assigning tasks <a href="#assigning-tasks" id="assigning-tasks"></a>

A task can be assigned to an operator or to a department, and reassigned at any time.

1. Open the task.
2. Click **Assign**.
3. Pick from the **Assign to** list. Departments are grouped under **Departments**, operators under **People**. Pick **Unassigned** to clear the assignment.
4. Click **Assign**.

A task goes to one or the other. Picking a department clears a personal assignment, and picking a person clears the department. The timeline records every change as **Assignment Changed**, with who made it.

Assigning sends an email:

| Assigned to      | Who is emailed                         |
| ---------------- | -------------------------------------- |
| **An operator**  | That operator.                         |
| **A department** | Every active member of the department. |

Each person only receives it if they have the **Task assigned** notification switched on in their own [operator settings](file:///the-basics/workspace/operators/operator-details.md).

{% hint style="info" %}
Only operators who have accepted their invitation are listed under **People**. Departments are set up under **Workspace → Staff → Departments** — see [Departments](https://support.holidayhero.com/the-basics/workspace/staff/departments.md).&#x20;
{% endhint %}

You need the **Tasks → Write** permission to assign tasks. Without it, the **Assign** button is hidden.

#### Notes <a href="#notes" id="notes"></a>

Notes let your team add updates, comments and context to a task. Each note is recorded with its author and a timestamp, so the task carries its own audit trail.

When you add a note you can change the task's status at the same time — useful when the update *is* the progress. For example, a note saying "Parts ordered" alongside a move to **Waiting on Supplier**.

1. Open the task.
2. Click **Add Note**.
3. Write the note and, optionally, pick a new status.
4. Submit.

***

#### Frequently Asked Questions <a href="#frequently-asked-questions" id="frequently-asked-questions"></a>

<details open>

<summary>How do I create a task?</summary>

Two ways:

1. **From the Tasks page** — go to **Tasks** in the menu and click **Create Task**. Give it a title, a description, who to **Assign to** and, if you want, an **Auto close at** moment.
2. **From a reservation or listing** — open it, go to the **Tasks** tab and click **Create Task**. The task is attached to that object automatically.

Leave **Assign to** on **Assign to me** and the task is assigned to you. Pick a department to hand it to that team instead.

</details>

<details open>

<summary>Does Assigned to me include my department's tasks?</summary>

No. **Assigned to me** only shows tasks assigned to you personally. For your team's tasks, use **+ Filter** and pick the **Department**.

</details>

<details open>

<summary>Who is emailed when a task is assigned to a department?</summary>

Every active member of that department who has the **Task assigned** notification switched on. Operators who are still invited, or who have switched the notification off, are skipped.

</details>

<details open>

<summary>Can a task be assigned to a person and a department at the same time?</summary>

In the admin panel you pick one or the other. A task created through an integration can carry both. It then shows the operator and the department badge side by side, and only the operator is emailed, because they own the task.

</details>

<details open>

<summary>What happens to a department's tasks when the department is deleted?</summary>

The tasks stay, with their notes and history. They lose the department, so they show **Unassigned** unless an operator is assigned too. Reassign them to a person or another department.

</details>

<details open>

<summary>Why can't I find an operator in the Assign list?</summary>

Only operators who have accepted their invitation are listed. Someone who still shows as `INVITED` on the [Staff](https://support.holidayhero.com/the-basics/workspace/staff.md) page can be assigned once they have signed in.

</details>

<details open>

<summary>Why does the number on the Tasks menu item not match the list I am looking at?</summary>

The badge counts the **open** tasks in the whole workspace — the `OPEN` and `SCHEDULED` statuses, for every operator. If you are on the **In Progress** or **Closed** view, or have **Assigned to me** switched on, you are looking at a narrower list than the badge counts.

</details>

<details open>

<summary>Can I attach a task to more than one reservation?</summary>

No. A task points at a single object. If the work spans two reservations, create a task for each, or attach the task to the listing they share.

</details>

<details open>

<summary>I attached a task to the wrong reservation. Can I move it?</summary>

Yes. Open the task, click **Change** next to **Attached To**, and pick the right one — including a different **Type**. The previous link is replaced. Nothing else about the task changes.

</details>

<details open>

<summary>What happens to a task when its auto close moment passes?</summary>

If the task is still open it moves to `AUTO_CLOSED` and the timeline records **Automatically closed** with *System* as the actor. If you had already resolved it, nothing happens — auto close never reopens or re-closes a finished task.

</details>

<details open>

<summary>Can I set a task's status to Auto Closed myself?</summary>

No. `AUTO_CLOSED` exists to tell you the system closed the task rather than a person, so it is not offered in the status list. Use **Cancelled** if you are closing it by hand because it is no longer relevant.

</details>

<details open>

<summary>What happens when a task is resolved?</summary>

Marking a task **Completed**, **Failed** or **Cancelled** records the moment it was resolved and moves it to the **Closed** view. Click **Reopen** on a closed task to bring it back to `OPEN`.

</details>

<details open>

<summary>Who can see a task?</summary>

Every operator in the workspace, whether or not it is assigned to them or to their department. Assignment indicates responsibility, not access.

</details>

***

## Agent Instructions: Querying This Documentation <a href="#agent-instructions-querying-this-documentation" id="agent-instructions-querying-this-documentation"></a>

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://support.holidayhero.com/the-basics/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.
