# Project Budget

<p class="doc-lead">A Project Budget plans expected purchase items and other expenses for a project. It is separate from the <a href="#/project/reports/budget-report">Budget Report</a>, which compares planned budget against actual spend.</p>

<div class="doc-toc">
<p class="doc-toc-title">On this page</p>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Getting started</span>
<div class="doc-toc-links">
<a href="#/project/project-budget?id=overview">Overview &amp; Access</a>
<a href="#/project/project-budget?id=quick-start">Quick Start</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Form reference</span>
<div class="doc-toc-links">
<a href="#/project/project-budget?id=header-fields">Header Fields</a>
<a href="#/project/project-budget?id=purchase-items">Purchase Items</a>
<a href="#/project/project-budget?id=other-expenses">Other Expenses</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">More</span>
<div class="doc-toc-links">
<a href="#/project/project-budget?id=actions-status">Actions &amp; Status</a>
<a href="#/project/project-budget?id=example">Example</a>
<a href="#/project/project-budget?id=faq">FAQ</a>
<a href="#/project/project-budget?id=related">Related</a>
</div>
</div>
</div>

<hr class="doc-section-divider">

<h2 id="overview">Overview &amp; Access</h2>

A project budget is created automatically when you save a new <a href="#/project/projects">Project</a>. To open it:

1. Open the project view.
2. Click the more menu (⋮).
3. Choose <b>Project Budget</b>.

There is no separate <b>Project Budget</b> list in the left menu — budgets are always accessed from the parent project.

> Screenshot pending — `project/images/project-budget.webp`

<b>View fields</b>

| **Field** | **Shows** |
|-----------|-----------|
| Title | Budget name. |
| Project | Parent project. |
| Total Budget | Sum of all budget lines. |

<b>View line tables</b>

- <b>Purchase Items</b> — Item, Quantity, Unit, Project Value, Project Budget
- <b>Other Expenses</b> — Account, Project Value, Project Budget

<hr class="doc-section-divider">

<h2 id="quick-start">Quick Start</h2>

1. Create or open a project.
2. From the more menu, click <b>Project Budget</b>.
3. Add lines under <b>Purchase Items</b> and <b>Other Expenses</b>.
4. Click <b>Update</b> — <b>Project Budget</b> (header total) recalculates from line totals.
5. Run the <a href="#/project/reports/budget-report">Budget Report</a> to compare plan vs actual.

<hr class="doc-section-divider">

<h2 id="header-fields">Header Fields</h2>

| **Field** | **Required** | **Description** |
|-----------|--------------|-----------------|
| Budget Name | Yes | Name for this budget (auto-created as "{project name} budget" on new projects). |
| Project | Yes | Project this budget belongs to. |
| Project Budget | Auto | Total of all line budgets (read-only, calculated). |

<hr class="doc-section-divider">

<h2 id="purchase-items">Purchase Items</h2>

| **Column** | **Description** |
|------------|-----------------|
| Item | Inventory item to purchase. |
| Quantity | Planned quantity. |
| Unit | Unit of measure (defaults from item). |
| Project Budget | Planned budget amount for this line. |
| Project Value | Estimated value for this line. |

<hr class="doc-section-divider">

<h2 id="other-expenses">Other Expenses</h2>

| **Column** | **Description** |
|------------|-----------------|
| Item | Expense account. |
| Project Budget | Planned budget for this expense. |
| Project Value | Estimated value for this expense. |

<hr class="doc-section-divider">

<h2 id="actions-status">Actions &amp; Status</h2>

<b>Toolbar</b>: Edit, Delete, Clone, Print.

<b>More menu</b>

| **Action** | **Description** |
|------------|-----------------|
| Activate | Activates the budget when inactive. |
| Suspend | Suspends an active budget. |

<hr class="doc-section-divider">

<h2 id="example">Example</h2>

<b>Budget planning then variance check</b>

1. Open project <b>Warehouse Expansion</b> → <b>Project Budget</b>.
2. Add purchase items: steel beams, roofing sheets, labour hire with budget amounts.
3. Add other expenses: site overhead, transport under expense accounts.
4. Save the budget.
5. As purchase invoices and expenses are posted to the project, open <a href="#/project/reports/budget-report">Budget Report</a> from the project left nav to see Budget vs Actual vs Variation by category.

<hr class="doc-section-divider">

<h2 id="faq">FAQ</h2>

<b>What is the difference between Project Budget and Budget Report?</b><br>
<b>Project Budget</b> is where you enter planned amounts. <b>Budget Report</b> compares those plans to actual purchases, inventory, and expenses.

<b>Why was a budget created when I saved a new project?</b><br>
The system creates a default budget automatically so you can start planning immediately.

<b>What do Project Value and Project Budget mean on a line?</b><br>
<b>Project Budget</b> is the planned cost. <b>Project Value</b> is an additional estimated value field on the line for reference.

<b>Which transactions feed the Budget Report actual column?</b><br>
Approved purchase invoices (service and inventory lines), consumable issues, and expenses linked to the project. Draft documents are excluded.

<b>Can I have multiple budgets for one project?</b><br>
Each project has one budget record created automatically at project save. Use budget item and expense lines within that single budget for all planning categories.

<b>Why is Actual higher than Budget on a line?</b><br>
Posted transactions exceeded the planned amount. Review open purchase orders and expenses, or revise the budget line if the estimate changed.

<b>Can I suspend a project budget?</b><br>
Yes. Suspend hides the budget from active planning views; Activate restores it. Suspension does not delete budget lines or actual history.

<b>Do inventory items and service items use separate budget sections?</b><br>
Yes. <a href="#/project/reports/budget-report">Budget Report</a> shows Service Items, Inventory Items, and Other Expenses in separate sections matching the budget form tabs.

<b>Must I enter a budget before posting purchases?</b><br>
No. Purchases and expenses can post to the project without budget lines — the Budget Report shows zero budget and full actual until you add planned amounts.

<hr class="doc-section-divider">

<h2 id="related">Related</h2>

<ul>
<li><a href="#/project/projects">Projects</a></li>
<li><a href="#/project/reports/budget-report">Budget Report</a></li>
<li><a href="#/project/reports/project-summary">Project Summary</a></li>
</ul>
