> 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/estimate-and-approval.md).

# Estimate, send, and approval

Start a project, build the estimate from your price book in phases, send it, and get it approved — by the customer online, or marked approved by you.

A project starts life as an estimate. You build it from your [price book](https://docs.shortcutco.com/readme/projects/settings-and-price-book.md#the-price-book), split it into phases, and send it. When the customer approves, the estimate locks, the deposit goes out, and the project is ready to schedule.

## 1. Start a project

1. Open [Projects](https://shortcutco.com/projects) and click **New project**.
2. In **Search for Customer or Property**, type the customer's name or address. Existing customers appear with one row per property (a customer with no property gets a **No property yet** row), then matching leads.
3. Pick a row. The project is created at once, named *\[customer]'s project*, and opens in the estimate builder.

Picking a lead turns the lead into a customer and uses the lead's address as the property. A project always belongs to one customer and one property.

Rename the project by clicking its name at the top-left of the builder. **⋯ → Project details** sets a **Reference** (shown in lists instead of the name, like *Q-2041*), a **Customer PO**, and the **Property**.

## 2. Build the estimate

The builder is a grid of line items on the left and the phases, payment schedule, and calculations on the right.

<figure><img src="https://2299783971-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOhi7KtJ4vY1pDKwWu5SV%2Fuploads%2Fgit-blob-b235487c4d4dd97304cf4a6d71c72f4a0ab54c3b%2Fprojects-estimate-builder.png?alt=media" alt="The estimate builder for Front walk &#x26; steps: line items grouped under the phases Demo &#x26; base and Walk &#x26; steps with Qty, Unit cost, Cost, Markup and Price columns; on the right the Phases list, the Payment schedule of 25% deposit, 50% progress and 25% balance, and the Calculations panel with Budget hours, Direct cost, Margin (direct), a $150 discount, Pre-tax total, Tax IN 7% and Total"><figcaption><p>The estimate builder: line items on the left, phases and money on the right. <strong>Send for approval</strong> is at the top right.</p></figcaption></figure>

### Add line items

Click **Add line item**. The picker opens on **Add from the price book**, with your categories in your own order, **Saved bundles**, and **Search the price book**. Each item shows **Cost · Sell**. Pick an item and set the quantity; **Enter** adds it and keeps the picker open. A bundle adds one line (*Paver patio, installed · Bundle · 5 parts · 6 h labor*). Items flagged **Incomplete in the price book** can still be added.

Can't find it? Type a name and choose **Add "…" as a custom item**, or click **Custom item**. Give it a **Name**, a **Kind** (**Material**, **Labor**, **Equipment**, **Other**), a **Category**, **Unit**, **Quantity** (or **Hours** for labor), **Unit cost**, **Markup**, and whether it's **Taxable**. A custom item lives on this estimate only and shows a **Custom** tag; **Save to price book…** in its row menu adds it to the catalog for next time.

### Edit a line

Click a cell to change **Qty**, **Unit cost**, **Markup**, or **Price**. Price follows cost × markup until you type a price; then the row shows *Price set by hand* and the markup adjusts. Type a line total and the price per unit works itself out.

Each row's **⋯** menu offers **Mark as optional** (the customer ticks it on their page; see below), **Taxable** / **Not taxable**, **Price from cost × markup**, **Move to phase**, **Save to price book…** (custom items), and **Remove line item**. Tick several rows to move or remove them together. Drag the handle at the left of a row to reorder, or to move it into another phase.

A line whose cost is missing shows **Missing cost** in red: it counts as $0 cost, so your margin reads higher than it is. The send check points it out.

### Phases

A phase is a chunk of the work with its own line items, team, and days. Click **Add phase** at the top. In the **New phase** window:

* **Name** — *Demo & base*, *Patio*, *Planting*.
* **How it's billed** — **Fixed price** (the price is the sum of its lines) or **Time & materials** (the crew's punched hours × a **Rate** per hour, plus the materials they use; add the **Estimated hours** so the estimate shows *about 10 h*).
* **Team plan** — the **Suggested team** and **Team size**. They're optional; they drive the *\~days* on the phase and the suggestion in the Backlog.
* **Advanced…** — the **Work type** (*Hardscape*, *Planting*, *Drainage*, *Irrigation*, *Grading & seeding*, *Demo*, *Cleanup*, *Other*), **Sales tax on labor** for a T\&M phase (**Company default**, **Taxed**, or **Not taxed**), and a **Note for the team** that shows on their phase checklist.

Click **Create**. Lines you had ticked move into the new phase. Open a phase's settings again from the **Phases** list on the right, or from the phase row's menu (**Phase settings**, **Move up**, **Move down**, **Delete phase**). Deleting a phase asks whether to move its items to another phase or delete them.

**Group by** at the top of the grid switches between **Phase** (the default) and **Category**. An estimate with no named phases is one phase, **All work**.

### Discount

Click **Add discount** in the **Calculations** panel. Choose **Discount in** **Percent** or **Dollars**, the amount, and what it **Applies to** (**Whole estimate** or one **Phase…**). The **Public label** (*Returning customer*, *Neighbor referral*) is what the customer reads. The window shows the margin after the discount against your target. One discount per estimate; it comes off before tax. After the customer signs, a price cut goes out as a credit on a [change order](https://docs.shortcutco.com/readme/projects/change-orders.md#credits) instead.

### Calculations

The **Calculations** panel keeps score as you build:

* **Budget hours** — the labor hours across every phase.
* **Direct cost**, **Overhead**, **Break-even** — your cost, the overhead your cost model adds, and the two together. Overhead and break-even show **–** until you set an overhead recovery % in [Costs](https://docs.shortcutco.com/readme/costs-and-profitability.md).
* **Margin (direct)**, or **Fully loaded margin** once overhead is set, against your **Target**. It turns red under target.
* **Discount**, **Pre-tax total**, **Tax** (with the rate's label, like **Tax IN 7%**), and **Total**.

Click **Details** to see cost by **Materials**, **Labor**, **Equipment**, and **Other**, the **Subtotal before discount**, and what tax is **Taxed on**.

The **Payment schedule** panel shows how the fixed price will be split, from your default schedule, with the amount of each step. It's the schedule the customer will see; you can change it per project when you mark it approved (below).

{% hint style="info" %}
Everything saves as you type. The top of the builder shows **Saved**, **Saving…**, or **Not saved**. Prices on the estimate stay as you set them, even if the price book changes later; a draft line whose price book item changed shows **Price book changed** with a one-click update.
{% endhint %}

## 3. Send for approval

Click **Send for approval** (top right). If something's missing, the header shows **n issue**; click it for the list. The **Send estimate to \[name]** window has:

* **Send to** — the customer, with **Email** and **Text message** ticks. If the customer has neither, add one here; it's saved on their profile.
* **Message** — shown at the top of the estimate.
* **Before you send** — the checks. A warning (*Demo & base has no team yet*, *Margin is under target*, a missing cost) doesn't stop the send; each has a fix beside it (**Pick team**, **Review pricing**, **Show**). A blocker (no items, a discount larger than what it applies to, a T\&M phase with no rate) has to be fixed first.
* **Valid until** — from **Estimates valid for** in Settings, with **Change** to pick another day. **Due on approval** is the deposit with its tax. **\[Name] will see** sums it up: *2 phases · 1 optional*.
* **Preview as \[name]** opens the customer's page exactly as they'll get it.

Click **Send**. The estimate becomes **Rev 1**, locked, and the customer gets a link by the channels you ticked. Texts honour customers who've opted out.

<figure><img src="https://2299783971-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOhi7KtJ4vY1pDKwWu5SV%2Fuploads%2Fgit-blob-a5a10f4e100dcbe7677bd87daa2acc8fd3e64446%2Fprojects-send-dialog.png?alt=media" alt="The Send estimate to Maria window: the customer as a recipient with Email ticked and Text message unticked, the Message box, Before you send listing that two phases have no team yet with a Pick team button, Valid until Nov 27 with Change, Due on approval 25% deposit $608.50, Maria will see 2 phases, and Preview as Maria, Cancel and Send at the bottom"><figcaption><p>Before you send: the checks, the valid-until date, and the deposit the customer will owe on approval.</p></figcaption></figure>

### What the customer sees

The link opens the estimate on any phone or computer, no account needed: your business name and logo, **Estimate · Rev 1 · Valid until …**, the project name and address, your message, then **The work, in n phases** with each phase's one-line summary and price (**Show details** lists the items and quantities, never a price per line). A T\&M phase reads *Billed at actual hours, $65.00 per hour, about 10 h estimated*. Optional items have a tick box; ticking one updates the total and the payments. Then the **Payment schedule**, **Total**, and **Deposit due on approval**, with the line *Approving locks this price. Changes after that come as a change order you approve separately.*

**Ask a question** sends a message to your project's activity and to the estimator. **Approve & sign** opens the signing sheet: a summary, **Signature** (**Type** their name or **Draw** it), *I agree to the scope and payment schedule in Rev 1.*, and the deposit. With Stripe connected they can **Pay \[amount] now** by card or bank transfer, or **Pay later** and get the invoice by email. The button reads **Approve & pay \[amount]** or **Approve**.

After signing they see *Approved – thanks, \[name]*, **View the signed copy**, and **Pay deposit · \[amount]**, and a signed copy is emailed to both of you.

<figure><img src="https://2299783971-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOhi7KtJ4vY1pDKwWu5SV%2Fuploads%2Fgit-blob-54d289704ddb248c598fd27a3d26a723540eeea3%2Fprojects-customer-estimate-phone.png?alt=media" alt="The customer&#x27;s estimate page on a phone: Estimate · Rev 1 · Valid until Nov 22, Paver patio &#x26; fire pit, the message, The work in 2 phases with Patio $4,038.87 and Fire pit (T&#x26;M) $65.00/h, the Payment schedule of 25% deposit on approval and 75% balance at completion, the totals with IN (7%) tax, Deposit due on approval, and the Approve &#x26; sign button"><figcaption><p>The customer's estimate: the phases, the payment schedule, the total, and one button to approve.</p></figcaption></figure>

Customers see prices only. Your costs, markup, and margin stay in the office. To look at the page yourself, click **Preview** in the builder's **⋯** menu, or **Preview as \[name]** on the project page; **Copy customer link** copies the link.

### While it's out

The project moves to **Waiting on customer** on the [Estimates tab](https://docs.shortcutco.com/readme/projects/project-page-and-stages.md#the-projects-list). Its status shows **Not opened yet** or **Sent · viewed 2×**, and the row offers **Nudge** when it hasn't been opened in three days. On the project page the main button is **Mark approved**, and its arrow menu has **Resend to \[name]**, **Revise estimate → Rev 2**, **Extend expiry** (once it's expired), **Mark lost…**, and **Create follow-up estimate**.

* **Revise.** Click **Revise estimate → Rev 2**. You get a draft you can change and send; the customer keeps seeing Rev 1 until you send Rev 2, and then their old link reads *This version was replaced* with a link to the new one.
* **Resend.** The same link goes out again with a message, by email, text, or both.
* **Expired.** After the valid-until day the customer's link turns read-only with **Ask for a new date**. **Extend expiry** picks a new **Valid until** day and the same link works again.
* **Mark lost.** Pick at least one reason (**Price too high**, **Timing**, **Went with a competitor**, **No response**, **Changed their mind**, **Other**), add **Details**, and set **Check back on** to be reminded. The customer's link stops working. A lost estimate stays on the Estimates tab for 30 days and under **All** after that; **Reopen** brings it back as the next revision.

## 4. Approve for the customer

When the customer said yes on paper, by email, or on the phone, click **Mark approved** on the project page (or in the builder). The window records how:

* **Recorded outside the app** — **Signed contract** (with **Attach signed contract** for a photo of it), **Email reply**, or **Verbal**.
* **Project manager** — who **Gets the handoff**: the estimator unless you change it.
* **Payment schedule** — the agreed one. Start from a preset (**25/50/25**, **30/40/30**, **50/50**, **100%**), drag the bar or type each payment's percentage, pick when each is due (**On approval**, **When \[phase] is reviewed**, **At closeout**, or **Days after closeout (retainage)**), and add a step with **+**, up to six. The amounts update as you go. See [Deposits, progress payments, and retainage](https://docs.shortcutco.com/readme/projects/review-progress-and-invoices.md#how-a-project-bills).
* **Note** — for the project's activity.
* **What happens next** spells it out: the revision locks, the deposit is emailed with a pay link, and the hours go to the Backlog until you schedule them.

Click **Approve & hand off**. It counts exactly like a customer signature, with the source recorded on the project.

<figure><img src="https://2299783971-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOhi7KtJ4vY1pDKwWu5SV%2Fuploads%2Fgit-blob-47e7f92b19210b9241016abd2eced6ba6691f23a%2Fprojects-mark-approved.png?alt=media" alt="The Mark approved window: Recorded outside the app with Signed contract, Email reply and Verbal, an Attach signed contract box, the Project manager row, the Payment schedule bar at 25% deposit and 75% balance with the presets above it, a Note box, What happens next, and the Approve &#x26; hand off button"><figcaption><p>Mark approved: record how the customer said yes, pick the project manager, and set the agreed payment schedule.</p></figcaption></figure>

## After approval

Whichever way it was approved:

* The estimate revision is locked. Every change from now on is a [change order](https://docs.shortcutco.com/readme/projects/change-orders.md).
* The deposit invoice goes out by email with a pay link, as the first step of the payment schedule (unless the project is under your **Skip the deposit under** amount).
* The project moves to **Approved · not scheduled** and shows in the [Backlog](https://docs.shortcutco.com/readme/projects/schedule-and-dispatch-install.md#the-backlog). Each phase is ready to be given a team and a start day.
* The project page's **Documents** list the signed estimate (**Signed Oct 19 · viewed 1×**) and the deposit invoice.

### Pencilled-in dates

Before the customer approves, you can **Pencil in** dates on the schedule strip at the bottom of the project page: pick the **Team** and the **Start**, and the days hold that team's hours in the Backlog's capacity (not on Dispatch or the Calendar). When the customer signs, the project page asks whether to **Schedule these dates** or **Let them go**. When you mark it approved yourself, the window has **Turn the pencilled-in dates into the schedule**, ticked, with **Text the customer the start date** under it.

## Duplicate or delete

**⋯ → Duplicate** in the builder (or **Duplicate** on a cancelled project) copies the estimate as a new draft. In the **Duplicate project** window keep **The same customer** or pick another (then no property, reference, or PO is copied), set the **Project name** and **Reference (optional)**, and click **Create estimate**. **Create follow-up estimate** on a closed or lost project does the same for that customer.

**⋯ → Delete project** removes a draft that was never sent. Sent estimates are marked lost instead.

<details>

<summary>Still stuck?</summary>

Email <hello@shortcutco.com> with the project name and a screenshot of the estimate.

</details>
