> For the complete documentation index, see [llms.txt](https://docs.shortcutco.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shortcutco.com/readme/projects/change-orders.md).

# Change orders

Add work, credit something back, or switch to time and materials after the customer has signed — with a change order the customer approves online, or that you record for them.

Once the customer signs, the estimate is locked: those lines are the contract. Everything that changes after that is a **change order** (**CO-1**, **CO-2**…): its own small estimate with a reason, a price, and the customer's signature. Its phases join the project when it's signed, and it bills on its own or with the next invoice.

## Start a change order

Click **+ Change order** in the project page header, or **Add phase … as a change order** under the phases, or a phase's **⋯ → Change order from this phase**. The estimate opens with the signed phases folded and read-only (**Show the n signed phases, read-only**) and a new phase to fill. On the right:

* **Reason for change** — *What changed, and why*. It's **Shown to \[the customer]** at the top of the change order.
* **Change to contract** — **Fixed price** (the sum of the lines you add) or **T\&M** (a **Rate per hour** and **Estimated hours**; billed from actual hours and materials, never on signature).
* **New contract** — the contract before and after, and **Hours · schedule**: how many working days the change adds, and the new **Finish date**.
* **Payment** (fixed price only) — **Own payment line – due on signature** (a new line in the payment schedule, invoiced the moment the customer signs) or **Bill with next invoice** (added to the next invoice the project sends). A T\&M change order has no choice: it's billed as the hours come in.

Add lines with **Add line item** (from the price book) or **Add custom item**, exactly as in the estimate builder; **Add phase to CO** adds a second phase to the same change order. A line's menu can **Make it a credit** (a negative line that reduces the contract) or **Make it optional**. The signed lines can't be changed; change them with the change order's own lines.

**Save draft** keeps it internal. **Preview as \[name]** shows the customer's page. **Delete draft** throws it away; nothing was sent.

<figure><img src="https://2299783971-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOhi7KtJ4vY1pDKwWu5SV%2Fuploads%2Fgit-blob-53121481b3deeeb7a110bdd2680dc543587c9d18%2Fprojects-change-order-modal.png?alt=media" alt="The change order window over a project: the signed estimate folded on the left with Add line item and Add phase to CO, and on the right Change order · Draft to Estimate Rev 1, the Reason for change box, Change to contract with Fixed price and T&#x26;M, New contract before and after, Hours · schedule, and Payment with Own payment line – due on signature and Bill with next invoice, plus Delete draft, Preview as Elena, Save draft and Send change order to Elena"><figcaption><p>A change order is a small estimate of its own: the reason, the lines, how it changes the contract, and how it's paid.</p></figcaption></figure>

### From the field

When the crew taps **Need a change** on their phone, the project gets a draft change order with their description as the reason, their photos, and rough hours. The change order window shows **From \[name]'s field request** with the phase, when they asked, and their photos. The project manager and the lead get a push. Open it from the **Change orders** section, price it, and send it. The crew's photos stay private (*Private. Open a photo to share it on the change order.*) until you share them. See [Need a change](https://docs.shortcutco.com/readme/projects/crew-app-on-a-project.md#need-a-change).

## Send it

Click **Send change order to \[name]**. Choose **Email**, **Text message**, or both, add a **Message to the customer (optional)**, check **Valid until** (from **Change orders valid for** in Settings), and click **Send**. The change order gets its number, its phases appear on the project as **Awaiting signature**, and the waiting box reads *CO-1 is waiting for the customer's signature* with **Copy link** and **Resend**.

### What the customer sees

A page like the estimate's, headed **Waiting for your approval** and **Change order CO-1 · to Estimate Rev 1**: the phase name, your reason, the **Price of this change** (**Show details** lists the items), the **Contract total** before and after, the **Schedule** impact (*Adds 1 working day to the schedule.*), your photos, and *Everything else in Rev 1 stays the same*. For a T\&M change it shows the **Agreed rate** and the estimated hours.

**Approve change order** opens the signing sheet (**Approve & sign: CO-1**, type or draw, the consent line) and, for a change with its own payment line, the invoice is ready right after: **Pay \[amount] now**. **Decline this change** asks for an optional reason. **Ask a question** goes to the project's activity.

<figure><img src="https://2299783971-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOhi7KtJ4vY1pDKwWu5SV%2Fuploads%2Fgit-blob-8ba5ae4a51446d10cd4ea4bf1d4bd936f1ee1763%2Fprojects-customer-change-order-phone.png?alt=media" alt="A change order on the customer&#x27;s phone: Waiting for your approval, Change order CO-1 · to Estimate Rev 1, Garden steps on Retaining wall rebuild, the reason Add two steps through the new wall, Price of this change +$606.48 with Show details, Contract total $10,494.34 → $11,100.82, Schedule +1 day, Everything else in Rev 1 stays the same, Decline this change, and the Approve change order button with Due on approval $623.73 invoice"><figcaption><p>The customer sees what changes, what it costs, what it does to the schedule, and one button to approve.</p></figcaption></figure>

## After the customer answers

The **Change orders** section on the project page lists every change order with its reason, its state, and its price. The states, and what to do next:

| State                                        | What it means                                                                                                                                                                                                                                         | What you can do                                                                                |
| -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| **Draft**                                    | Saved, not sent.                                                                                                                                                                                                                                      | **Edit draft**, send, or delete it.                                                            |
| **Awaiting signature · Oct 26**              | Sent; *Viewed 1×* or *Not opened yet*.                                                                                                                                                                                                                | **Resend**, **Copy link**, **Start before signed** (below), or **Customer approved verbally**. |
| **Signed Oct 26**                            | The customer approved it. Its phases are now contracted and show as **Unscheduled**; the waiting box says *CO-1 is signed. Pick a team and day for Patio drain.* → **Pick team & day**. With its own payment line, the invoice went out on signature. | Schedule its phases like any other.                                                            |
| **Declined**                                 | The customer said no, with their reason in the waiting box (*"Happy with the original pavers."*). The phases aren't part of the contract.                                                                                                             | **Revise & resend** (a new revision under the same number) or **Dismiss**.                     |
| **Expired Nov 9**                            | Past its valid-until day; the customer's link reads **Ask … to resend**.                                                                                                                                                                              | **Extend 14 days**, **Revise and resend**, or **Void**.                                        |
| **Voided**                                   | Cancelled by you before any work was done. Its phases and days are removed.                                                                                                                                                                           | —                                                                                              |
| **Converted to T\&M** or **Internal rework** | A declined or expired change order the crew had already worked on, resolved one way or the other (below).                                                                                                                                             | —                                                                                              |

**Customer approved verbally.** On a sent or expired change order, record a yes you got by phone or in person: **Who approved it** and **When**, plus a note. It counts as a signature, without a signed copy.

**Start before signed.** When the crew needs to get on with it before the customer signs, the project manager can let them: the phases become schedulable and startable, flagged **At risk · not signed yet** on Dispatch and **Work started before signature** on the project. If the customer then declines, or it expires, the hours are already on the phase, so Shortcut asks you to choose: **Revise & resend**, **Convert to T\&M · bill the punched hours** (the unbilled hours bill once at the change order's rate, or your default T\&M rate), or **Move to internal rework · not billed** (the hours count against your margin and the customer isn't charged). A change order with hours on it can't be voided or just dismissed.

## Credits

To take something off a signed contract (the customer dropped the lighting, or you're making good on a problem), add a change order with a line marked **Make it a credit**: a negative amount. A credit can't have its own payment line; it goes on the next invoice as a credit line. If it's bigger than what's left to bill, the rest carries forward and is settled at close with a credit memo and a refund. See [Closeout](https://docs.shortcutco.com/readme/projects/closeout-and-cancel.md#closing-the-project).

## Rework and warranty work

Work that's your own fix, never billed and never sent to the customer, goes in as **⋯ → Internal rework** from the project header: a **Phase name**, **Why (internal)**, and optional **Budget hours**. It's a phase like any other to schedule and work, and it counts against the margin. After closeout, **Reopen** on a closed project adds a warranty phase the same way. See [Reopen](https://docs.shortcutco.com/readme/projects/closeout-and-cancel.md#after-closing).

<details>

<summary>Still stuck?</summary>

Email <hello@shortcutco.com> with the project name and the change order's number.

</details>
