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

# Setting Up Project Costing

> See how FieldPulse totals projected and actual sales, costs, profit, and margin across every job on a Project, then breaks the numbers out job by job.

> **Who uses this:** Admins, and Team Managers with the **Ability to View Project Costing Tab** permission turned on. **Availability:** Web app only. Requires Project Management to be turned on.

## Overview

Project Costing shows projected versus actual sales, costs, profit, and margin for an entire Project on one tab. Without it, a team running a multi-job Project opens each job's Job Costing tab and totals the numbers by hand to find out whether the Project is on budget.

The Project Costing tab works like the Job Costing tab, pointed at a Project instead of a single job. It combines the records from every included job into one view, so the Project reads like one large job. A **Show Job Breakdown** toggle splits the same data back out job by job, so you can see which jobs carried the Project and which ran over.

## How it works

### Where to find it

Open a Project record and select the **Project Costing** tab, which is the third tab after **Comments**. The tab is headed **Project Cost Analysis** and is available on Projects in any status.

The Project record also has a **Cost** tab that lists Invoice, Purchase Order, and Timesheet totals. Project Costing is a separate tab that adds the projected versus actual comparison, charts, and line item detail.

![The Project Costing tab selected on a Project record, right after Info and Comments in the tab bar, showing Project Cost Analysis with Actuals and Projected views, an Actual Profitability ring chart at a 55.00% profit margin, a sales and cost table, and an Actual Cost Breakdown column chart](https://mintcdn.com/fieldpulse/xBmMPsjFDGVCJq5F/static/images/project-costing/01.png?fit=max\&auto=format\&n=xBmMPsjFDGVCJq5F\&q=85\&s=abc31b25089c2b67fa5653bd87deee8a)

### What rolls up

Project Costing can read: Estimates, Invoices, Purchase Orders, Material Lists, and Timesheets. It loads them from every job on the Project and from anything attached directly to the Project.

* **Included:** Every job linked to the Project, including jobs generated by Recurring Services and Maintenance Agreements under the Project. Estimates, Invoices, Purchase Orders, Material Lists, and Timesheets attached directly to the Project with no job attached.

* **Not included:** Jobs whose status type is canceled, regardless of what you named the status. Archived jobs. Tasks (non-billable jobs). Voided invoices and archived invoices.

A job belongs to exactly one Project, so no job's records count toward more than one Project. The Recurring Service and Maintenance Agreement records themselves are schedules, not jobs, so only the jobs they generate roll up.

### How the totals are calculated

Project Costing adds up the jobs. FieldPulse calculates each job, and the records attached directly to the Project, using your Costing settings. It then sums the subtotals for Products & Materials, Service & Labor, and Commissions into the Project totals. Project Profit and Profit Margin come from those summed totals. Sales tax is not included.

No Job Costing calculation rule changes on a Project. The same Costing settings drive both tabs.

Costing sources are company-wide settings that decide which records feed the Actual vs. Projected calculations on your jobs.

1. As an admin, go to **Company Settings** > **Costing**.

2. Set the records that feed each metric: **Projected Cost**, **Projected Sales**, **Actual Cost**, and **Actual Sales**.

3. Choose whether discounts and commissions count toward your margins with the **Include Discounts in Projected and Actual Sales** and **Include Commissions in Projected and Actual Sales** toggles. You have full control over both, so the calculations can match your accounting practices.

4. Select **Save**.

![The Costing tab in Company Settings showing the Projected Cost, Projected Sales, Actual Cost, and Actual Sales dropdowns, the Include Discounts and Include Commissions toggles, the Labor Display Settings for Actual Costs, and the Save button](https://mintcdn.com/fieldpulse/xBmMPsjFDGVCJq5F/static/images/project-costing/03.png?fit=max\&auto=format\&n=xBmMPsjFDGVCJq5F\&q=85\&s=97a80b877676196159ae33b6a0e35abf)

### Comparison views

The three comparison views match Job Costing: **Actual Margin**, **Projected vs. Actual Costs**, and **Projected vs. Actual Sales**. Each shows line item detail for the whole Project.

### Show Job Breakdown

The tab opens on the combined view. One set of item tables lists the line items from every included job and the Project-direct records, with one subtotal per category and a single Commission row. Identical items from different jobs combine into one row with their quantities summed, the same way Job Costing combines identical items within a single job.

1. Open the **Project Costing** tab.

2. Select the **Show Job Breakdown** toggle at the right end of the row that holds the three comparison view tabs.

3. Review one section per job. Each job section carries its own item tables, Commission row, and category subtotals, and is labeled with the job's title. Records attached directly to the Project appear in their own section above the jobs, labeled with the Project name.

4. Switch between the three comparison views. The toggle stays on while you move between them.

![The Show Job Breakdown toggle turned on at the right end of the Actual Margin, Projected vs. Actual Costs, and Projected vs. Actual Sales tabs, with Actual Cost, Actual Sales, and Profit totals above a section labeled with the Project name and one collapsible section per job, each showing its own cost, sales, and profit](https://mintcdn.com/fieldpulse/xBmMPsjFDGVCJq5F/static/images/project-costing/02.png?fit=max\&auto=format\&n=xBmMPsjFDGVCJq5F\&q=85\&s=9f6f5d9d0fa8e770a7fbe9de4eb9a50f)

## Availability

Project Costing is available on the web app whenever Project Management is turned on. It is not available on mobile.

| **Role** | **Access** |
| - | - |
| **Admin** | Always has access to the Project Costing tab. |
| **Team Manager** | Sees the tab when the **Ability to View Project Costing Tab** toggle is on, under **Reporting and Data Management** in **User Feature Permissions**. |
| **Service Agent** | Does not open Projects, so the permission does not apply. |

Each person sees only the data their existing permissions allow, in both the combined and job breakdown views. Invoice List Visibility, View Team Timesheets, View Unit Cost and View Unit Price on Estimates/Invoices, Purchase Order Access, and Material List Access all apply, and a banner tells the person they can only view the data they have permission to see.

## Related articles

**Set up**

* [Setting Up Job and Project Costing](https://help.fieldpulse.com/jobs/jobs-tasks/job-costing.md)

**Reports**

* [How to Create Project Reports](https://help.fieldpulse.com/reporting/raw-data/project-reports.md)

**Details**

* [User Roles and Permissions Details](https://help.fieldpulse.com/settings/users-teams/user-roles.md)

**Related features**

* [Project Management Overview](https://help.fieldpulse.com/jobs/projects/overview.md)


## Related topics

- [Setting Up Job and Project Costing](https://help.fieldpulse.com/jobs/jobs-tasks/job-costing.md)
- [Projects](https://help.fieldpulse.com/jobs/projects/index.md)
- [How to Create Project Reports](https://help.fieldpulse.com/reporting/raw-data/project-reports.md)
- [Setting Up Custom Fields on Project Records](https://help.fieldpulse.com/jobs/projects/custom-fields.md)


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