> 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/track-a-job-as-a-project.md).

# Track a job as a project

Some jobs need more structure than a few visits: an install with a permit, a test the inspector has to witness, and a deposit before work starts. Starting a project on a job adds that structure without changing how the job works. A project adds:

* **Phases**: the stages of the work, such as Design & permit, Rough-in, and Closeout.
* **Items**: the to-dos for each phase, such as ordering materials or submitting drawings. Permits, inspections, tests, and sign-offs are items too: one is done when it passes.
* **An optional billing schedule**: it splits the signed quote into a deposit and progress invoices, with optional retainage. A project starts without one; you set it up on the job's **Billing Schedule** tab when you're ready.

Projects are off until an admin turns them on in Settings > **Projects**, which also sets up the Project Templates a project starts from. See [Turn on projects and manage Project Templates](https://learn.withessential.com/administration/settings/turn-on-projects-and-manage-project-templates.md). Most jobs don't need a project, and nothing changes on a job until someone starts one. The job's visits, **Tasks**, quotes, and invoices stay the same records you already use. The project organizes its items into phases and tracks what's left to do and bill.

> **Where to find it:** Scheduling > Jobs, open the job, then open the ⋮ menu at the top right of the job's summary panel, on the same row as the job number, and select **Start Project**. Once a project is started, everything about it is on the job's page: the project in the summary panel, the **Project Management** section's **Project Checklist** and **Billing Schedule** tabs, and the **Project Overview** card.

## Before you start

* Projects must be turned on for your business in Settings > **Projects**. Until then, the job's ⋮ menu has no **Start Project**.
* You need office (web) access to start or change a project.
* Add the visits you already know about to the job first. The project uses the job's existing visits and never creates visits for you. You can add more visits to the job later. Visits stay in Scheduling and are counted separately in **Project Overview**.
* To bill the project on a schedule later, you need a **signed** quote for the work, on the job or on the job's property. You can start the project without one. See [Set up billing](https://learn.withessential.com/customers-and-work/jobs/project-billing-progress-invoices-retainage-and-change-orders.md#set-up-billing).
* The **Billing Schedule** tab and the project's money figures appear only for roles that can view invoices. Creating project invoices and changing the billing schedule also need invoice edit access. Roles that can view quotes but not invoices manage the project's change orders in the **Change orders** card in the job page's right column.

## Start a project

1. Open the job, open the ⋮ menu at the top right of the summary panel, and select **Start Project**. The **Start Project** dialog opens.
2. Enter a **Project name**. Until you type one, it follows the Project Template you choose: the template name and the property's address.
3. Under **Project Template**, choose one of your business's Project Templates. They're listed in the order set in Settings > **Projects**, and the first one is chosen for you. A line under it summarizes the template: its phases in order and how many items it has, such as "Plan & order → Install → Test & closeout · 10 items". Every item in it is added to the project; you can rename, remove, or add items in **Project Management** after it starts.
4. Optionally, add a **Target finish**. You can change it later with **Edit Project Details**. The project's start date is set for you: it's the day you start the project.
   * Pick the **Target finish** date, or select **or set a duration** to enter how long the project should take instead: a number and **days**, **weeks** (the default) or **months**. The date it comes to shows under it, such as "Finishes around Dec 8, 2026", counted from today. Only that date is saved; select **or set a date** to go back to the date picker with it filled in. A duration is a whole number from 1 up to ten years (520 weeks, 120 months or 3650 days).
5. Select **Start Project**. The job scrolls to **Project Management** with **Project Checklist** open.

A project always starts without a billing schedule. To bill progress invoices from it, set up billing in Project Management's **Billing Schedule** tab when you're ready (see [Set up billing](https://learn.withessential.com/customers-and-work/jobs/project-billing-progress-invoices-retainage-and-change-orders.md#set-up-billing)). Until then, the job is billed the usual way.

Later, in Project Management's **Project Checklist** and **Billing Schedule** tabs, you can add or change phases, items, and billing lines. Visits remain Scheduling records; starting a project never creates visits or invoices.

### Billing is never automatic

A billing schedule doesn't create or send invoices on its own. When a line's moment comes (billing is set up, or the last phase is complete), the line shows **Ready to bill** in Project Management's **Billing Schedule** tab. Someone with invoice access then creates the invoice there, reviews the draft, and sends it like any other invoice. See [Bill a project](https://learn.withessential.com/customers-and-work/jobs/project-billing-progress-invoices-retainage-and-change-orders.md#create-a-progress-invoice).

### Project Templates

Your business's Project Templates are set up in Settings > **Projects**: each has phases and the items in each phase, and nothing about billing. A Project Template is only a starting point. Once the project starts, nothing stays linked to the template, so changing or removing it doesn't change projects already started. See [Turn on projects and manage Project Templates](https://learn.withessential.com/administration/settings/turn-on-projects-and-manage-project-templates.md).

If an inspection or test doesn't apply to this job (for example, the AHJ won't witness the test), remove that item in Project Checklist after you start.

### Items live in Project Management

The items a project creates, from its Project Template or with **Add item**, go in a project-only Jobs folder and show only in Project Management's **Project Checklist** tab (and, for technicians, on their visit and the app's Project screen). They aren't listed on the **Tasks** page, on the job's **Tasks** tab, on property and customer pages, or in the Jobs and Invoices lists' **Task folder** filter. A notification about one opens **Project Checklist** with the item open.

An ordinary task from another folder that someone put in a phase stays in its folder, on the **Tasks** page and the job's **Tasks** tab, and shows in Project Checklist too. To make an item an ordinary task, use **Move to Folder** in its popup: it moves to that folder and keeps its phase, so it stays in Project Checklist as well. See [Manage a project's checklist and phases](https://learn.withessential.com/customers-and-work/jobs/project-plan-phases-and-tasks.md#work-with-project-tasks).

## The project on the job page

Once a project is started, the job's page shows it:

* **In the summary panel**, under the job number: the project name, its status (see below), and its current phase, such as "Rough-in · phase 2 of 4". Below that, when the project started and its target finish, with about how long that is from the start, such as "Started Sep 8, 2026 · Target finish Nov 22, 2026 (about 11 weeks)" (only "Started …" when there's no target finish). The length is in days under two weeks, in weeks under three months, and in months after that; it's left off when the target finish isn't after the start date.
* **Suggested items**, below the summary panel, for roles that can view quotes, when AI has items the Project Checklist view is missing: to add or dismiss. See [Use AI on a project](https://learn.withessential.com/customers-and-work/jobs/use-ai-on-a-project.md#suggested-tasks).
* **Project Management**, below the job's related-record table: **Project Checklist** shows phases and their items as a list or board, while **Billing Schedule** shows the billing schedule, contract, and change orders for roles that can view invoices. See [Manage a project's checklist and phases](https://learn.withessential.com/customers-and-work/jobs/project-plan-phases-and-tasks.md) and [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).
* **The Project Overview card**, at the top of the right column. It shows the project's status, current or next step, last project activity, manager, target finish, completed and upcoming visit facts, progress, and waiting count. For roles that can view invoices, once the project has a billing schedule, it also shows **Contract**, **Billed**, **Retained** (when the project holds retainage), and **Left to bill**. Below a line at the bottom of the card, the AI summary appears when it has something to add. See [Use AI on a project](https://learn.withessential.com/customers-and-work/jobs/use-ai-on-a-project.md#the-ai-summary).

The start date is the day the project was started; it can't be changed, and turning the project off and back on keeps it.

The status reads:

* **Active**: work is under way.
* **Ready to bill**: at least one billing line is ready to invoice.
* **Work complete · billing open**: every visit and item is done, but billing isn't finished.
* **Closed**: the work is done. For a project billed on a schedule, billing is finished too: every signed change order is on the schedule, every line's invoice has been sent or finalized, and any retainage has been released.

Project notes are ordinary comments on the job's **Timeline**, at the bottom of the job page, so everyone who can see the job can read them. Project changes are recorded there too, including renaming the project, removing a phase, billing, and turning the project off or on. Money amounts are never shown there: a billing line whose name includes an amount, such as "Deposit $5,000", is called "a billing line" on the Timeline instead of by its name.

To rename the project or set its target finish, open the job's ⋮ menu and choose **Edit Project Details**. In **Project Details**, change the **Project name** or **Target finish**, then select **Save**. Clear **Target finish** to have none. **Target finish** opens on its saved date; to enter a duration instead, select **or set a duration** (it counts from the project's start date, not from today). The same menu has **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)) and **Turn Off Project**. To document the job's scope, use the **Job Description** card in the right column; it is shared by project planning and the rest of the job.

## Find project jobs

On the Jobs list, a project job shows a **Project** pill next to its job number. The **Projects** tab, shown once your business has turned projects on, lists only project jobs and shows each project's name. Searching the Jobs list, or the app's search, also finds a job by its project name. See [What is a job, and how does the Jobs list work?](https://learn.withessential.com/customers-and-work/jobs/what-is-a-job-and-how-does-the-jobs-list-work.md).

## See your project portfolio

The **Projects** widget on the Dashboard gives you a short current list: each active project's status, next step, and next visit or progress. Select a project to open its **Project Management > Project Checklist**, or choose **Project overview** to open the full portfolio report.

The **Project overview** report lists every active project across the business with its job, customer and property, status, item and visit progress, next step, last activity, latest completed visit, upcoming visits, and target finish. You can search, sort, export CSV, and select a row to open that job's **Project Management > Project Checklist**. Projects turned off or on deleted records do not appear. Go to Dashboard, then open **Reports** and choose **Project overview**.

## Turn a project off or back on

Turning a project off hides it without deleting anything. Use it when a job was made a project by mistake, or when the extra structure isn't helping.

1. On the job page, open the ⋮ menu at the top right of the summary panel and select **Turn Off Project**.
2. Review the dialog, **Turn off this project?**, and select **Turn off**.

What turning it off does:

* The project's details in the summary panel, Project Management's **Project Checklist** and **Billing Schedule** tabs, the **Project Overview** card, and the job's **Project** pill and **Projects** tab listing on the Jobs list go away. Searching by the project's name no longer finds the job.
* The phases, items, billing schedule, and change orders are all kept. The project's items show again in **Project Checklist** when you turn the project back on.
* The job's visits, quotes, invoices, and its other ordinary Tasks aren't changed.
* While the project is off, nothing can be billed from its schedule. If it had a billing schedule, its signed quote still can't be invoiced the ordinary way. Turn the project back on to bill it.

You can't turn a project off while a draft invoice bills its schedule, including a draft with a card or bank payment still processing. The **Turn off this project?** dialog says so at the top; send or void that draft first, or wait for the payment to finish.

To bring the project back, open the job's ⋮ menu and select **Turn Project Back On**. This works even while projects are turned off for your business in Settings: turning them off only stops new projects. Everything returns as it was. A job has one project, so if its project is turned off, turn it back on instead of starting a new one.

## Things to know

* **Projects were turned off.** If an admin turned projects off after you opened the job, the dialog says "Projects are turned off for this business. An admin can turn them on in Settings → Projects." and **Start Project** stays unavailable.
* **Billing comes later.** The **Start Project** dialog has no billing fields. Set up billing on the job's **Billing Schedule** tab; the reasons it can be unavailable (no permission to create invoices, no signed quote you can use, a job already invoiced the ordinary way) are explained there. See [Set up billing](https://learn.withessential.com/customers-and-work/jobs/project-billing-progress-invoices-retainage-and-change-orders.md#set-up-billing).
* **The schedule's quote is billed only through the project.** Once a project bills a quote on a schedule, that quote can't be turned into an invoice from the quote. Bill it from the job's **Billing Schedule** tab instead. The project's quote also can't be unlinked from the job while the project uses it.
* **Visits** stay in Scheduling. Cancelled and deleted visits don't count toward the project's work. Neither do draft visits that haven't been released in Scheduling yet; the **Visits** row includes released visits only.
* **Changing the signed quote after billing is set up** doesn't change the schedule. The schedule divides the quote's amount when billing was set up. Bill extra work as a change order.

## Related guides

* [Manage a project's checklist and phases](https://learn.withessential.com/customers-and-work/jobs/project-plan-phases-and-tasks.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 AI summary, suggested items and Add update](https://learn.withessential.com/customers-and-work/jobs/use-ai-on-a-project.md)
* [The job detail page: what it shows](https://learn.withessential.com/customers-and-work/jobs/the-job-detail-page-what-it-shows.md)
* [What is a job, and how does the Jobs list work?](https://learn.withessential.com/customers-and-work/jobs/what-is-a-job-and-how-does-the-jobs-list-work.md)
* [Link quotes and invoices to a job](https://learn.withessential.com/customers-and-work/jobs/link-quotes-and-invoices-to-a-job.md)
* [How a customer reviews and signs a quote](https://learn.withessential.com/revenue/quotes/how-a-customer-reviews-and-signs-a-quote.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/track-a-job-as-a-project.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.
