> ## 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.

# Time budget

> Split a project time budget by position and person, set each row hours and rate, keep unsplit hours unassigned, and give unbudgeted people their own share.

**Time** → **Budget** splits a project's hours by position and person, so each role has its own share to plan and log against. Each row also carries the hourly rate it is sold at. When senior developers run 30 hours over, you see it on their row while the project total still looks fine. Admins, managers, and finance users can open it.

![Time budget for a patient portal: 1860h total worth \$287,050, rows for positions and people with lines, hours, rate and value, Priya Nair under Senior Designer, and Emma Lindqvist under Not in budget](https://mintcdn.com/adjera/el3qThKXqBLK5rYb/images/docs/budgets/time-budget.webp?fit=max\&auto=format\&n=el3qThKXqBLK5rYb\&q=85\&s=eeec12cc1399cdba957b4c5e5d61a58c)

## How the time budget works

The time budget is the hours on the project's labor lines in [Finance budget](https://usepike.com/docs/project/project-budget.md#labor). Each labor line belongs to one position or one person, and a row on this tab adds up the lines for that position or person.

* **Position rows** cover everyone with that position on the project, and its open positions.
* **Person rows** cover one member by name. A member with a person row counts there first, then on their position's row.
* **Unassigned** contains labor hours that belong to no position or person.
* **Not in budget** lists people and open positions with hours on the project that match no row.

A person row appears under the position its hours were sold as. The position row then adds up the position and its named people, and the position's own hours show as the position's name followed by **(unnamed)**.

Rates are on each row. Cost stays in **Finance** → **Budget** (**Rates and cost in Finance › Budget**). Hours you split keep the rate they had, so splitting does not change the revenue budget.

## Split the budget the first time

A project with a time budget and no rows opens **Split the time budget by role**. It lists the project team by position, with who has each position and the hours planned for them now.

![Split the time budget by role: total hours 1100, the project team with planned hours, and Split across roles, Unassigned and Total](https://mintcdn.com/adjera/el3qThKXqBLK5rYb/images/docs/budgets/time-budget-setup.webp?fit=max\&auto=format\&n=el3qThKXqBLK5rYb\&q=85\&s=0b5c2962afa691a3f8a6b6fb5dd9ed45)

**1. Set the total**

**Total hours** starts from the project's current time budget. Leave it as
it is, change it, or clear it for no fixed total.

**2. Give each role its hours**

Type hours for each position or person, or click **Copy planned hours** to
start from the plan. Planned hours are shown for reference and never change
the budget.

**3. Save**

Click **Save budget**. Rows left empty are not saved, and whatever you do
not split stays **Unassigned**.

When nobody is planned on the project yet, plan the team on [Resources](https://usepike.com/docs/project/resources.md) first.

## Rows

| Column | Value |
| - | - |
| **Position or person** | The row. Named people appear under their position |
| **Lines** | The labor lines behind the row: **Original** hours, and each change order with its reference |
| **Hours** | The row's hours. Changes save when you leave the field |
| **Rate** | What the client pays per hour for this row. Click it to change it |
| **Value** | The row's hours priced at the rate of each line |

Click the cross on a row to remove it. Its hours go back to **Unassigned**. When the project has a fixed total, you also choose **Lower the total time budget too?**: **Lower total** takes the freed hours off the total, and **Keep total** leaves them **Unassigned**.

### Change a rate

Click a row's rate, type the new hourly rate, and check the preview of the row's **Value**. On a **Fixed Price** project the preview also shows the **Price adjustment**: the revenue budget stays and the adjustment absorbs the difference. On other project types it shows the **Revenue budget**, which moves by the change. The rate applies to the row's original lines. Change order lines keep their price, so a row made only of change order lines shows its rate without an editor. The same editor opens from the breakdown on [Time](https://usepike.com/docs/project/project-time.md#change-a-budget-or-rate-from-the-breakdown).

### Add a position or person

Click **Add position or person**, pick one, and enter the hours. The preview shows where the hours come from, for example **Unassigned 140h → 116h. The total stays 1860h.** When the hours exceed **Unassigned**, the preview reads **The total rises by** the difference.

![Add position or person dialog: Emma Lindqvist, 24 hours, Unassigned 140h to 116h, the total stays 1860h](https://mintcdn.com/adjera/el3qThKXqBLK5rYb/images/docs/budgets/time-budget-add-row.webp?fit=max\&auto=format\&n=el3qThKXqBLK5rYb\&q=85\&s=943d615ba663f3b4c199719865832917)

For someone under **Not in budget**, click **Give own budget** on their row. A person with a budget row who is not on the project yet has **Add to project** on their row.

### Change order hours

Hours a change order adds to a row show as a line with the change order's reference, for example **CR-07 Accessibility remediation · 60h**. The row cannot go below those hours (**Locked by CR-07**). To lower them, edit the change order's lines in [Finance budget](https://usepike.com/docs/project/project-budget.md#change-orders).

## Total and Unassigned

The **Total time budget** card shows the total, its value, and how it splits: **Split across roles** and **Unassigned**.

| Setting | Total | Unassigned |
| - | - | - |
| Fixed total | The hours you set | `total − roles`. New row hours come out of it |
| No fixed total | The sum of all labor lines | Labor lines with no position or person |

Click **Change total** to set a fixed total. It cannot go below the hours already on budget lines. A project with a fixed total shows a **Fixed total** label, and **Remove fixed total** returns it to the sum of its lines.

![Change total dialog with 1860 total hours](https://mintcdn.com/adjera/el3qThKXqBLK5rYb/images/docs/budgets/time-budget-change-total.webp?fit=max\&auto=format\&n=el3qThKXqBLK5rYb\&q=85\&s=0abd835d49c2981f1b1adf409e0c8eae)

When a row needs more hours than **Unassigned** has left, you confirm **Raise the total time budget?** and the total rises by the difference. Sold does not change. To price the new hours differently, change the row's rate.

## Example

Northlight Studio budgets 1,860 hours to rebuild a patient portal for Meridian Health.

| Row | Lines | Hours | Rate | Value |
| - | - | - | - | - |
| Senior Developer | Original | 380h | \$175 | \$66,500 |
| Developer | Original 740h, CR-07 60h | 800h | \$145 | \$117,200 |
| Senior Designer | | 170h | \$165 | \$28,050 |
| Priya Nair | Original | 170h | \$165 | \$28,050 |
| Designer | Original | 220h | \$135 | \$29,700 |
| Project Manager | Original | 150h | \$150 | \$22,500 |
| Unassigned | | 140h | | |

* The rows split 1,720 hours and leave 140 **Unassigned**. The time budget is worth \$287,050.
* Priya Nair is a senior designer with her own row, so her hours count there. The Senior Designer row above her adds up the position and its named people, and has no hours of its own.
* Developer covers Jonas Berg, Rafael Costa and an open Developer position. Together they are planned 815 hours against 800, so **Left to plan** reads -15h on **Time** → **Overview**, and **Resources** flags **Planned 15h over budget**.
* The client's CR-07 added 60 developer hours at $165, so Developer is worth 740 hours at $145 plus 60 at \$165. The row cannot go below those 60 hours.
* Emma Lindqvist, the creative director, logged 14.5 hours of design review. No row matches her, so she appears under **Not in budget** until someone gives her own budget.

## For AI agents

The [MCP](https://usepike.com/docs/integrations/mcp.md) server reads and writes the time budget.

| Tool | Who | Use |
| - | - | - |
| `get_time_budget` | Admins, managers, finance | The same numbers as **Time**: rows with budget, planned, left to plan, logged, forecast, rate, values and status, grouped by position, person or task. Totals include the price adjustment and, on Fixed Price, the effective rate. Pass `from` and `to` (both or neither) to count planned and logged hours inside those dates only. Budget, left to plan, status and effective rate are then null |
| `set_time_budget` | Admins, managers, finance | Sends the whole split: rows of `positionId` or `userWorkspaceId` with hours and `rate` (null leaves the row's rate as it is), and `fixedTotalHours` or `null` for no fixed total |
| `set_time_budget_rate` | Admins, managers, finance | Changes the hourly rate of one row, as the rate editor does. Change order lines keep their price. On Fixed Price the price adjustment absorbs the change, and on other project types the revenue budget moves |
| `get_my_time_budget` | Any project member | Your own planned and logged hours on the project, and the status of your budget row |

`set_time_budget` replaces the split, so a position or person left out loses its row. It refuses a total below the hours on budget lines, a row below its change order hours, and retainer projects, which budget each period instead.

> [card] [Project time](https://usepike.com/docs/project/project-time.md)
>
> Logged and planned hours against the budget.

> [card] [Finance budget](https://usepike.com/docs/project/project-budget.md)
>
> Rates, cost and change orders behind the hours.

> [card] [Resources](https://usepike.com/docs/project/resources.md)
>
> Plan people inside their share of the hours.

> [card] [Retainers](https://usepike.com/docs/project/retainers.md)
>
> Hours that reset every period.


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