> For the complete documentation index, see [llms.txt](https://learn.withessential.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.withessential.com/customers-and-work/jobs/project-plan-phases-and-tasks.md).

# Manage a project's checklist and phases

Once a job is a project, its **Project Management** section's **Project Checklist** tab shows its items by phase. Each phase holds the items for that stage, including its permits, inspections, tests, and sign-offs. This page covers the Plan view, the project's timeline, and working with items and phases. Where the project stands (the **Project Overview** card, with its AI summary) is on the job page itself; see [The job detail page](https://learn.withessential.com/customers-and-work/jobs/the-job-detail-page-what-it-shows.md#when-the-job-is-a-project). To start a project, see [Track a job as a project](https://learn.withessential.com/customers-and-work/jobs/track-a-job-as-a-project.md).

> **Where to find it:** Scheduling > Jobs, open the job, then scroll below the related-record table to **Project Management** and select **Project Checklist**.

## Before you start

* The job must already be a project with the project turned on.
* Changing the plan needs office (web) access.
* Items show only in **Project Checklist**. Select an item's name to rename it right there, its status to change it, or its **›** to open it in a popup on the job page: change its description, owner, status, notes, and files without leaving the job.

## The project's timeline

The project's timeline is the job's **Timeline**, at the bottom of the job page. Add a note there. Technicians add notes from the mobile app's Project screen, and they appear there too. Project activity appears as well, such as phases added or removed, invoices created from the schedule, files added, and items a technician marked done or reopened from the app ("marked "Label zone valves" done (technician app)"). Histories for ordinary Tasks on the job's visits show too.

To turn a pasted email or text into suggested changes you approve, open the job's ⋮ menu, at the top right of the summary panel, and select **Add Update**. See [Use AI on a project](https://learn.withessential.com/customers-and-work/jobs/use-ai-on-a-project.md#add-an-update).

## Project Checklist: List and Board

Switch between the two views with the **List** and **Board** buttons at the top of the tab. Essential remembers your choice in this browser. The Plan groups the project's items by phase. Visits stay in Scheduling and are shown separately in **Project Overview**.

To give the Plan more room, for example when the project has many phases, select the expand icon at the top right of the tab. The Plan opens full screen, with the same view, open phases and items. Select the icon again (now a shrink icon), press Escape, or click outside the Plan to go back. Opening an item or a dialog such as **New item** first returns the Plan to the page, so only one dialog is visible.

### List

The List shows one section per phase, in order, and a **Not in a phase** section for anything outside the phases (it stays even when empty, so you can add an item there). Each section's heading shows:

* The phase name.
* How many of its items are done, such as "1 of 2 items done", or "No items". Only items you can see count.
* A ⋮ menu with **Rename** and **Remove phase**.

Complete phases start collapsed when you open the Plan. Select a heading to open or close it. After that, a phase opens and closes only when you select its heading: finishing or reopening its items never opens or closes it.

To reorder the phases, drag a phase by the handle to the left of its heading (⋮⋮) and drop it where it belongs. With the keyboard, focus the handle, press Space, use the up and down arrow keys, and press Space again. **Not in a phase** always stays last.

Inside a phase you'll find:

* **Items**, each with a drag handle, a checkbox to mark it done or not done, and its name. An item can also show its owner, due date, who it's waiting on, a compact note preview, a file count, its status, and a **›** that opens it. A done item fades and is struck through, with the date it was marked done on the same line; point at the date to see who marked it done and when, such as "Marked done by Marco Diaz · Oct 20, 2026, 10:21 AM". That's who changed the status, not necessarily who did the work. Select an item's name to rename it in place (see [Manage a project's checklist and phases](#rename-an-item-and-set-its-owner)), its status to change it (see [Manage a project's checklist and phases](#change-an-items-status)), and its **›** to open it (see [Manage a project's checklist and phases](#open-an-item-from-the-plan)).
* **Add item**, to create an item in that phase.

**Add phase** is at the bottom of the list.

### Board

The Board shows only items, as cards. Choose how to group it with **Group by**:

* **Phase**: one column per phase, plus **Not in a phase** for items outside the phases (drag a card there to take it out of its phase). Each column heading shows how many of its items are done, as in the List ("1 of 2 items done"). Each column has **Add item**. A card shows its item's status, except a done card, plus any compact note preview or file count.
* **Status**: four columns, **To do**, **In progress**, **Waiting on others**, and **Done**, each with its number of cards.

A done card fades and is struck through, with the date it was marked done (point at it to see who marked it). Select a card to open its item (see [Manage a project's checklist and phases](#open-an-item-from-the-plan)); rename an item from there, since a card moves when you drag it. Drag a card to another column to change its phase or status. To move a card with the keyboard, focus it and press Space to pick it up. Then use the arrow keys to move it and press Space again to drop it. Essential remembers your **Group by** choice in this browser. To reorder the phases, use the List.

When you group by status:

* Moving a card to **To do**, **In progress**, or **Done** sets the item to the first status of that kind in its folder. If the folder has no status of that kind, the move is refused with "This item's folder has no status for that column. Change it from the item."
* Dropping a card in **Waiting on others** opens **Waiting on Others** so you can say who it's waiting on. The card moves once you save. A card dropped from **Done** is reopened when you save: it moves to the first in-progress status in its folder, or the first to-do status if there isn't one, and the dialog tells you which.
* Moving a card out of **Waiting on others** clears who it was waiting on.

## Work with items

Items are work items for this job, kept in a project-only Jobs folder. Essential creates the folder the first time anyone in your business starts a project with items or adds one. Items show only here in Project Checklist (and in the technician app). They aren't listed on the **Tasks** page, on the job's **Tasks** tab, or on property and customer pages, and the folder isn't listed on the **Jobs** and **Custom Folders** tabs of Tasks settings. Set its statuses on the **Task Statuses** tab like any other folder's. A notification or activity-feed item about an item opens **Project Checklist** with that item open.

An ordinary task from another folder that someone put in a phase stays in its own folder, on the **Tasks** page and the job's **Tasks** tab, and shows in Project Checklist too.

### Add an item

1. In Project Checklist, select **Add item** in the phase where the item belongs. Use **Not in a phase** in the List, or that column on the Board, for an item outside the phases.
2. In **New item**, enter a **Description**. To give the item an owner, type **@** and the start of a teammate's name in the description and choose them (their name doesn't stay in the text), or pick them in **Owner**. Add a **Due date** if you like. **Phase** starts on the phase whose **Add item** you selected (or **Not in a phase**); choose another phase there to create the item in it instead.
3. Select **Create item**.

The item starts in the project-only folder's first status. Select its status to change it, or its **›** to add notes.

### Rename an item and set its owner

In the List, select an item's name. It turns into a text box on a highlighted row.

1. Change the text. Shift+Enter starts a new line.
2. To set the item's owner, type **@** and the start of a teammate's name. A list of matching people opens: use the up and down arrow keys and Enter (or select a name). The person shows in the row's owner column, and the "@name" leaves the text.
3. Press Enter, or click anywhere outside the text box, to save. Press Escape to cancel (the first Escape closes the people list if it's open).

While it saves, a small spinner shows in the text box. If the save fails, Essential says why and keeps your text in the box so you can try again. Clearing the text keeps the old name.

Owners are your teammates who can sign in to the Essential web app. You can also change the name and owner in the item's popup. Only the project's own items are renamed in Project Checklist; selecting the name of an ordinary task from another folder opens it instead.

### Open an item from the Plan

Select an item's name in the List, or its card on the Board, to open the item in a popup on the job page. A drag on the Board still moves the card instead. On the Board, you can also focus a card's name with Tab and press Enter.

The popup shows the item's details, as the **Tasks** page does for ordinary Tasks:

* For an item, **Details** has its **Description** (type **@** there to pick an owner, as on the Plan) and its **Owner**. They save with the status and notes below.
* Change its **Status** and its notes, then select **Save**, as on the **Tasks** page. The Plan follows: an item marked done is struck through, its phase's "N of M items done" count changes, the Board card moves to its new column, and a billing line that bills when that item is done becomes **Ready to bill**.
* **Item notes** save with the item's details. Under **Files**, choose **Add** to expand a Name and PDF, JPG, or PNG picker in the item dialog. **Save file** is independent of the item's **Save**. A failed upload keeps the name and selected file. Cancelling a changed file form and deleting a file both ask inline, inside the item dialog; deleting removes the file from both the item and the job's Files list. Select a file to preview it inside the dialog, then use **Back to files** or **Download**.
* **Move to Folder**, when the item can go to another folder. An item you move becomes an ordinary task in that folder, on the **Tasks** page and the job's **Tasks** tab. It keeps its phase, so it stays in Project Checklist too. The item dialog closes before the folder picker opens.
* For a done item, a line such as "Marked done by Marco Diaz · Oct 20, 2026, 10:21 AM" at the top.
* For an ordinary task from another folder in a phase, **Remove from the Project** at the bottom left: confirm it, and the task leaves the Plan and stays in its folder on the **Tasks** page.

**Save** is at the bottom of the popup, always in view however far you scroll, and stays unavailable until you change something. Select **Close** (or ✕, or press Escape) to go back to the Plan. If you have unsaved changes, an inline **Discard changes?** choice appears: select **Discard** to close without saving, or **Keep editing** to go back to the item.

The popup doesn't show the item's timeline. The project's history, and notes on it, are on the job's **Timeline**; an ordinary Task's own history and comments are on the **Tasks** page. A few quick actions on some kinds of ordinary Task, such as sending an inspection report, open that Task on the **Tasks** page, where those dialogs live.

### Change an item's status

In the List, point at an item's status (such as **To Do**): it shows as a dropdown. Select it to see the statuses of the item's folder, grouped as on the **Task Statuses** settings tab (to do, in progress, done), and choose one. The item changes at once. **Waiting on others…**, at the end of the list, opens **Waiting on Others** (see [Manage a project's checklist and phases](#track-who-an-item-is-waiting-on)). With the keyboard, Tab to the status and press Enter.

### Mark an item done

Select the item's checkbox in the List. The checkbox is a shortcut for the status: the item moves to the first done status in its folder, and the row shows it at once. Clear the checkbox to move it back to the folder's first not-started status. Choosing a done status from the item's status ticks the checkbox too. On the Board, drag it to **Done** or back.

Technicians can do the same from the mobile app for the items the office puts on their visit. See [Work on a project from the mobile app](https://learn.withessential.com/field-operations/mobile/work-on-a-project-on-mobile.md). Whoever marks an item done, in the office or in the app, the item shows the date in the List and on its Board card; point at it to see "Marked done by *name* · *date and time*". The project's activity records a technician's tick as coming from the technician app. You can still change the item afterward. An item that was created already done, or was moved by something that keeps no status history, shows no date. One marked done by an automation shows "Marked done · *date and time*".

### Move an item to another phase

In the List, drag the item by its handle (⋮⋮, to the left of its checkbox) onto another phase, or onto **Not in a phase** to take it out of its phase. The phase you drop on is highlighted. With the keyboard, focus the handle, press Space to pick the item up, use the up and down arrow keys to move it, and press Space again to drop it (Escape cancels). On the Board, grouped by phase, drag the card to the other column.

An ordinary Task from another Jobs folder (for example a close-out or deficiency Task you added to a phase) is part of the project only while it's in a phase. You can drag it to another phase, but not to **Not in a phase**: to take it off the project, open it and select **Remove from the Project**.

### Track who an item is waiting on

When the next move belongs to someone outside your team, such as the GC, the AHJ, or a supplier, mark the item as waiting on them. The Plan then shows it as their move, with the date you plan to follow up.

1. In the List, select the item's status and choose **Waiting on others…** at the end of the list. If the item is already waiting, you can also select the item's waiting pill.
2. In **Waiting on Others**, choose **Who is it waiting on?**: **Customer**, **GC**, **AHJ**, **Supplier**, **Sub**, or **Other**.
3. Optionally enter a **Company or person**, such as "Ferguson Fire", and a **Follow up on** date.
4. Select **Save**.

The item shows a pill such as "Supplier: Ferguson Fire · follow up Oct 24, 2026" (without the date when there's no follow-up date) next to its status, and sits in **Waiting on others** on the Board. Changing its status to another open status keeps the wait. When they've done their part, open **Waiting on Others** again and select **No longer waiting**. Marking the item done also ends the wait, however it's marked done (on the Plan, on the **Tasks** page, or from the technician app). A done item can't be waiting on anyone: **Waiting on Others** on a done item moves it back to an open status first.

When you've followed up but are still waiting on them:

1. Open **Waiting on Others** again from the item's status or its waiting pill.
2. Check **I followed up**.
3. Choose the **Next follow-up** date. It must be after today.
4. Select **Save**.

The pill shows the next follow-up date.

### Inspections, tests, permits, and sign-offs

Anything the work has to pass, such as a permit, a hydrostatic test, an AHJ inspection, or the customer's sign-off, is an ordinary item in its phase. Add it with **Add item** like any other item, for example "AHJ final inspection" in the Trim & test phase. Project Templates add them for you.

* **When it passes**, mark the item done. A billing line that bills when that item is done becomes ready to bill, and the phase can finish.
* **When it fails**, leave the item open and add a note on the Timeline saying what failed and what's next, such as "Rough-in inspection failed: two hangers missing. Re-inspection Friday." Schedule the visit for the fix or the re-inspection. The phase stays **In progress** until the item is done.
* **While you wait on the inspector or the AHJ**, mark the item **Waiting on others** with a follow-up date, so the Plan shows when to chase it.

**Add Update** can do this from a pasted email or text: a passed inspection becomes its item marked done, and a failed one becomes a note. See [Use AI on a project](https://learn.withessential.com/customers-and-work/jobs/use-ai-on-a-project.md#add-an-update).

## Work with phases

A phase is a stage of the project. It holds the items for that stage.

* **Add a phase**: select **Add phase** at the bottom of the Plan, enter a **Name** in **New Phase**, and select **Add Phase**. New phases go at the end.
* **Rename a phase**: open the phase's ⋮ menu, select **Rename**, change the **Name**, and select **Save**.
* **Remove a phase**: open the phase's ⋮ menu, select **Remove phase**, and confirm with **Remove Phase**. Its items stay on the job under **Not in a phase**, and a billing line that bills when one of its items is done keeps waiting on that item. A project always keeps at least one phase. A phase stays on the plan when a billing line bills when the phase is done, even a billed one ("A billing line bills when this phase is done. Change that line's trigger first (if it was billed, void that invoice first)."), or when the phase holds ordinary Tasks from other folders (move them to another phase first; see below).

A quote, invoice, or deficiency Task in a phase shows only to people who can open it on the **Tasks** page. It still counts toward the phase's work for everyone.

To give a visit's crew specific items, from any phase, open the visit and use **+ Add checklist items** under Technician Instructions. See [Create a new visit](https://learn.withessential.com/customers-and-work/scheduling/create-a-new-visit.md#project-tasks).

Each phase is in one of these states. The first phase that isn't complete is the current phase named on the job page, complete phases start collapsed in the List, and a billing line set to bill when a phase is complete becomes ready when it is:

* **Not started**: no item in it is in progress or done, or the phase is still empty.
* **In progress**: some of its work is done or underway, and some isn't.
* **Complete**: every item in it is done, its inspections and tests included.

A phase with no items is **Not started**. An inspection item that failed and is still open keeps its phase **In progress**.

## Related guides

* [Track a job as a project](https://learn.withessential.com/customers-and-work/jobs/track-a-job-as-a-project.md)
* [Bill a project: progress invoices, retainage, and change orders](https://learn.withessential.com/customers-and-work/jobs/project-billing-progress-invoices-retainage-and-change-orders.md)
* [Use AI on a project: the brief, suggested items and Add update](https://learn.withessential.com/customers-and-work/jobs/use-ai-on-a-project.md)
* [Working a task: changing its status and saving notes](https://learn.withessential.com/field-operations/tasks/working-a-task-changing-its-status-and-saving-notes.md)
* [Customize your Jobs task folders](https://learn.withessential.com/administration/settings/customize-jobs-task-folders.md)
* [Create a new visit](https://learn.withessential.com/customers-and-work/scheduling/create-a-new-visit.md)
* [The job detail page: what it shows](https://learn.withessential.com/customers-and-work/jobs/the-job-detail-page-what-it-shows.md)


---

# 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://learn.withessential.com/customers-and-work/jobs/project-plan-phases-and-tasks.md?ask=<question>&goal=<user_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.
