> ## Documentation Index
> Fetch the complete documentation index at: https://usepike.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Project budget

> Budget a project line by line: labor and costs sold, change orders, actual and committed spend, and how expenses count against each group.

**Finance** → **Budget** tracks a project against the scope you sold, one line at a time. Each line shows what the client pays, what you expect it to cost, what you have spent and ordered, and what is left. Put each part of the scope in its own group and you see an overrun on equipment even when the project as a whole is under budget. The project's revenue budget and [time budget](https://usepike.com/docs/project/time-budget.md) come from the same lines. Admins, managers, and finance users can open it.

![Finance budget for a trade show stand: summary with 61% used, and groups for labor, stand build, AV and venue](https://mintcdn.com/adjera/el3qThKXqBLK5rYb/images/docs/budgets/finance-budget.webp?fit=max\&auto=format\&n=el3qThKXqBLK5rYb\&q=85\&s=aa1d7216b227e41de2fb5ac591737959)

## Summary

The donut shows how much of the cost budget is used: actual plus committed, against budget.

| Row | Value |
| - | - |
| **Actual** | Labor cost of logged time plus expenses on the project |
| **Committed** | Ordered but not billed yet |
| **Remaining** | `budget − actual − committed`. Red when negative |
| **Budget** | Cost budget for labor and costs, change orders included |
| **Sold** | What the client pays for all lines, price adjustment included. This is the revenue budget |
| **Hours** | Hours logged against the labor hours. Shown when the project has labor lines |

When some expenses match no line, **Actual** reads, for example, **\$376.00 is not on a budget line**.

## Budget table

| Column | Value |
| - | - |
| **Line** | Group name and line count. Expand a group to see its lines and expenses |
| **Category** | The expense category of the group's lines, or how many they use. On **Labour**: hours logged of hours budgeted |
| **Original** | `Σ quantity × unit cost` of lines in the original budget |
| **Change orders** | `Σ quantity × unit cost` of lines from change orders |
| **Budget** | `original + change orders` |
| **Actual** | Expenses that count on the group. On **Labour**: labor cost of logged time |
| **Committed** | `Σ committed` of the group's lines |
| **Remaining** | `budget − actual − committed`. Negative means over |

**Labour** is the first row, followed by the groups in your order, then **Ungrouped** for cost lines without a group. **Not in budget** lists expenses that match no line. They add to the total **Actual** and reduce the total **Remaining**, but no single group's.

Sold minus budget is the planned margin on the project.

## Groups and cost lines

A group is a named part of the scope, such as Stand build or Venue and logistics. Expand it to see two lists side by side: **Lines**, each with `quantity × unit cost` and what it sold for, and **Expenses** that count on the group.

![Stand build group expanded: four lines on the left, including a PO-4471 change order line, and four expenses on the right](https://mintcdn.com/adjera/lR66KPc0Ix-w0tVT/images/docs/budgets/budget-group.webp?fit=max\&auto=format\&n=lR66KPc0Ix-w0tVT\&q=85\&s=4487a501dbfa1d309c925bf8a94b9c09)

**1. Add a group**

Click **Add group** and enter a **Name**. **Edit group** in the group's menu
renames it, and **Add line** in the same menu adds a line straight to the
group.

**2. Add a cost line**

Click **Add line**, keep **Type** on **Cost**, and fill in the line.

**3. Arrange groups and lines**

Drag a group by its handle, or use **Move up** and **Move down** in its
menu. Drag a line to reorder it, or onto another group or **Ungrouped** to
move it there. A placeholder shows where it drops, and a closed group opens
when you hold a line over it.

![Add line dialog with title, type, group, category, committed, quantity, unit price and unit cost](https://mintcdn.com/adjera/lR66KPc0Ix-w0tVT/images/docs/budgets/budget-add-line.webp?fit=max\&auto=format\&n=lR66KPc0Ix-w0tVT\&q=85\&s=ae68f8af69a9e015907997723e3c28b4)

| Field | Value |
| - | - |
| **Title** | Required, for example "LED wall, 4 x 2.5 m" |
| **Type** | **Cost** for suppliers, rentals and materials. **Labour (hours)** for your team's time |
| **Group** | A group, or **Ungrouped** |
| **Category** | Expense category. Expenses with this category count on the line's group |
| **Committed** | Ordered but not billed yet |
| **Quantity** | Units, for example 24 room nights |
| **Unit price** | What the client pays per unit |
| **Unit cost** | What you expect to pay per unit. Actuals count against it |
| **Description** | Optional |
| **From a change order** | Turn on to add the line to a change order instead of the original budget |

> [!NOTE]
>
> Deleting a line moves its expenses back to category matching. Deleting a group
> deletes its lines, and the confirmation shows how many. A group with no lines
> stays until you delete it.

## Labor

Labor lines carry the hours you sold, each for one position or one person. Expand **Labour** to see every line with its hours, hourly cost, and what it sold for. Change order lines show their reference, for example **PO-4471**.

![Labour row expanded: one line per position with hours, hourly cost and sold amount](https://mintcdn.com/adjera/el3qThKXqBLK5rYb/images/docs/budgets/budget-labour.webp?fit=max\&auto=format\&n=el3qThKXqBLK5rYb\&q=85\&s=3f6f403dde44483adb36c387fc83725e)

* The hours on labor lines are the project's time budget. Hover the icon on the **Labour** row: it says the hours and roles come from the time budget, and links to **Edit hours in Time › Budget**, where you split them by position and person. See [Time budget](https://usepike.com/docs/project/time-budget.md).
* **Hourly rate** is what the client pays, **Hourly cost** is what an hour costs you. Sold uses the time budget rates, and cost is each role's hourly cost. Change a row's rate in [Time](https://usepike.com/docs/project/project-time.md#change-a-budget-or-rate-from-the-breakdown) or **Time** → **Budget** with the rate editor.
* A line for a named person shows the person and the position they were sold as, for example **Priya Nair · Senior Designer**.
* **Actual** on **Labour** is the time logged on the project at each person's cost rate. It reads - when a member's contract has no cost rate. See [Cost profile](https://usepike.com/docs/members/cost-profile.md).

## Price adjustment

A **Price adjustment** line appears below **Labour** when the sold price differs from the value of the hours at their rates. A negative amount is a discount. The line changes **Sold** only, never cost, and it is marked **Sold price only**.

![Taproom launch event budget: Labour with 2 lines, 4,176 budget, and a Price adjustment of -360 marked Sold price only](https://mintcdn.com/adjera/el3qThKXqBLK5rYb/images/docs/budgets/budget-price-adjustment.webp?fit=max\&auto=format\&n=el3qThKXqBLK5rYb\&q=85\&s=cdc57d29aed2712a0081b7b70c129d13)

Two things create it:

* A quote whose price differs from its delivery rows at their rates. The line comes with the quote's lines when they become a project or a change order.
* A rate change in **Time** on a **Fixed Price** project. The revenue budget stays and the line absorbs the difference. See [Time](https://usepike.com/docs/project/project-time.md#change-a-budget-or-rate-from-the-breakdown).

Click **Edit price adjustment** on the line to change its title, **Amount** or description. You cannot delete the line or change anything else on it. Set the amount to 0 to cancel its effect.

## How expenses count

An expense counts on the first match in this order:

1. **Assigned line**: the group of the line the expense is assigned to, or **Ungrouped**.
2. **Category**: the group that contains every cost line with the expense's category.
3. **Not in budget**: no assigned line, and no cost line has the category, or lines in more than one group share it.

To assign an expense, drag it onto a line, or pick the line under **Count on line**. You can also drop an expense on a group header when the group has one cost line. **Match by category** removes the assignment.

![Not in budget expanded: a taxi with no category and a client dinner in Meals, which no line uses](https://mintcdn.com/adjera/lR66KPc0Ix-w0tVT/images/docs/budgets/budget-not-in-budget.webp?fit=max\&auto=format\&n=lR66KPc0Ix-w0tVT\&q=85\&s=0e5b2b8d413d3577d114d215bd94f20d)

Hover an expense to see its vendor, date, amount, approval status, category, billable and reimbursable flags, attachments, and who created it.

![Expense card for a stand structure deposit: Brightline Exhibits, approved, Production, billable, created by Olivia Grant](https://mintcdn.com/adjera/lR66KPc0Ix-w0tVT/images/docs/budgets/budget-expense-card.webp?fit=max\&auto=format\&n=lR66KPc0Ix-w0tVT\&q=85\&s=3d3b81b4522c3b8d0c1fdef5a446f768)

* Amounts are in the workspace currency (`amount × exchange rate`).
* Rejected expenses do not count. Billable and non-billable expenses both count.
* Moving an expense to another project removes its assignment.
* Bills and purchases synced from [QuickBooks](https://usepike.com/docs/integrations/quickbooks.md) import one expense per line with its category, so they match lines with no extra work. A synced expense shows the integration's icon next to its description.

> [!TIP]
>
> Keep each category within one group where you can. When lines in different
> groups share a category, assign those expenses by hand.

## Change orders

A change order records scope the client approved after the original sale. The **Change orders** panel lists each one with its reference, title, approval date, and the cost budget of its lines.

![Change orders panel with PO-4471 Extra lounge area, approved 3 Nov 2026](https://mintcdn.com/adjera/lR66KPc0Ix-w0tVT/images/docs/budgets/budget-change-orders.webp?fit=max\&auto=format\&n=lR66KPc0Ix-w0tVT\&q=85\&s=019817f2081dc23f2e16717afcc6f0f9)

**1. Create the change order**

Click **Add change order** and enter a **Title**, the **Client reference**
(for example a PO number) and the **Approved** date.

**2. Add its lines**

Click **Add line**, turn on **From a change order**, and pick the change
order. A change order can add cost lines and labor hours.

Change order lines add to **Change orders** and **Budget** on their group, so the original budget stays visible. They raise the revenue budget and the time budget like any other line, and the hours they add set a floor on that row in [Time budget](https://usepike.com/docs/project/time-budget.md#change-order-hours). Deleting a change order deletes its lines.

## From deals

| Action on a deal | Result on the Budget tab |
| - | - |
| **Create project** | With **Copy the quote's budget** on, the project starts with one line per delivery row, in the original budget |
| **Add to project** | A change order named after the deal, approved today, with one line per delivery row |

Each delivery row becomes a line with its hours, sell rate and cost, converted to the workspace currency. A member or position row becomes a labor line for that member or position, and a supplier or other cost row becomes a cost line. A line item with no rows becomes one cost line at its price, and a price adjustment becomes its own line, so the lines add up to what the client pays. A deal links to one project only, as a project or as a change order. See [Deals](https://usepike.com/docs/customers/deals.md#add-to-a-project).

## How the budgets fit together

Budget lines set the two project budgets that the rest of Pike reads.

| Project budget | With budget lines | Used by |
| - | - | - |
| **Revenue budget** | Total **Sold**, all lines | **Budget usage**, Time completion revenue, the invoice ceiling, project list columns |
| **Time budget** | Total hours on labor lines | **Time**, **Resources**, Time completion revenue, project list columns |

The revenue budget is labeled **Fixed Price**, **Budget** or **Ceiling** depending on the [project type](https://usepike.com/docs/project/project-types.md).

Each budget takes the first source that has a value, and that source locks the field:

| Source | Sets the revenue budget when | Sets the time budget when |
| - | - | - |
| **Retainer periods** | The periods have a fee | The periods have hours |
| **Budget lines** | A line carries a price | The project has labor lines |
| **Typed in** | Neither of the above | Neither of the above |

A locked field reads **Budget set by budget lines**, with **Open budget** to edit the lines. The lock also applies to the API and MCP. Every change to a line or change order updates both budgets straight away. Deleting every line unlocks the fields, starting from their last values.

On **Fixed Price** and **Capped Time and Materials** projects, Pike blocks invoice lines that take billing above the revenue budget, so extra scope is billable once its change order is in. On a **Time completion** project, a change order restates recognized revenue for past months. See [Revenue recognition](https://usepike.com/docs/finance/revenue-recognition.md).

| Event | Revenue budget | Time budget | Budget tab |
| - | - | - | - |
| **Create project** from a deal | Total sold | Labor hours | Lines from the deal |
| **Add to project** from a deal | Raised by its lines | Raised by its labor hours | Change order lines added |
| Change order lines added on the tab | Raised by their sold | Raised by their hours | Change order lines added |
| Hours split in **Time** → **Budget** | Unchanged | Unchanged | Labor lines per role |
| Rate changed in **Time** | Unchanged on **Fixed Price**, moved by the change otherwise | Unchanged | Labor line prices change, and a **Price adjustment** absorbs the difference on **Fixed Price** |
| Time logged | Unchanged | Burns | Labor actual and hours rise |
| Expense added | Unchanged | Unchanged | Counts as actual |

> [!NOTE]
>
> A retainer project has no **Budget** tab, and a project with budget lines
> cannot become a retainer. Choose one model per project: periods that reset, or
> a scope sold line by line. See [Retainers](https://usepike.com/docs/project/retainers.md).

**Actual** and profitability cost differ on purpose. Actual counts every expense on the project and labor at each person's cost rate. [Profitability](https://usepike.com/docs/finance/profitability.md#expenses) leaves out billable expenses, which are passed through to the client.

### Example

Northlight Studio sells Kestrel Outdoor a trade show stand for $148,140: 525 hours across five positions, and $66,100 of stand build, AV and venue costs. The client later approves PO-4471 for an extra lounge area: \$2,100 of furniture and 16 more senior designer hours.

| Group | Category | Original | Change orders | Budget | Actual | Committed | Remaining |
| - | - | - | - | - | - | - | - |
| **Labour** | 267.5h of 525h | \$32,852 | \$1,184 | \$34,036 | \$14,463 | - | \$19,573 |
| Stand build | 3 categories | \$29,700 | \$1,400 | \$31,100 | \$13,120 | \$11,400 | \$6,580 |
| AV and equipment | AV equipment | \$10,500 | - | \$10,500 | \$3,550 | \$3,100 | \$3,850 |
| Venue and logistics | 2 categories | \$9,020 | - | \$9,020 | \$1,660 | \$4,100 | \$3,260 |
| Not in budget | | | | | \$376 | | -\$376 |

* AV and equipment contains three lines that share the AV equipment category, so every AV equipment expense counts on that group. A \$450 lighting test is assigned to the **Lighting rig** line by hand.
* The \$11,400 stand structure deposit is actual, and the second half of the structure is committed.
* A $64 taxi with no category and a $312 client dinner in Meals, a category no line uses, appear under **Not in budget**.
* Revenue budget: \$148,140, the total sold. Time budget: 525 hours. Both come from the lines.

## For AI agents

The [MCP](https://usepike.com/docs/integrations/mcp.md) server reads and writes the finance budget. Every tool needs the admin, manager, or finance role.

| Tool | Use |
| - | - |
| `get_project_budget` | Totals, groups with their lines and expenses, labor, change orders, and expenses not in budget |
| `list_expense_categories` | Category ids for cost lines |
| `create_budget_group` | Adds a named group. `update_budget_group`, `reorder_budget_groups` and `delete_budget_group` change it |
| `create_budget_lines` | Adds up to 100 lines. `kind` is `COST` or `LABOUR`. Labor lines take a `positionId` or a `userWorkspaceId` |
| `update_budget_line` | Changes one line, including its group. `null` clears an optional field, so `groupId: null` ungroups the line. A price adjustment line only takes a new title, description or `unitPrice`, its amount |
| `reorder_budget_lines`, `delete_budget_line` | Reorders or deletes lines |
| `assign_expenses_to_budget_line` | Assigns up to 100 expenses to a cost line, or `null` to match by category again |
| `create_change_order` | Records an approved change order. `update_change_order` and `delete_change_order` change it |
| `get_deal_project_plan` | Previews the budget lines, tasks and booked hours a deal would add, before you create anything |
| `create_deal_project` | Creates the project for a deal, as **Create project** does. Admins and managers only |
| `add_deal_change_order` | Adds a won deal to an existing project as an approved change order |

Budget writes are refused on retainer projects, and `update_project` refuses a revenue or time budget that lines or periods set. For hours by position and person, see [Time budget](https://usepike.com/docs/project/time-budget.md#for-ai-agents).

> [card] [Time budget](https://usepike.com/docs/project/time-budget.md)
>
> Split the labor hours by position and person.

> [card] [Project finance](https://usepike.com/docs/project/project-finance.md)
>
> Recognized, invoiced, WIP, and budget usage on the revenue budget.

> [card] [Deals](https://usepike.com/docs/customers/deals.md)
>
> Line items, cost and margin before the sale.

> [card] [Profitability](https://usepike.com/docs/finance/profitability.md)
>
> How labor, overhead, and expenses make up cost.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.