> For the complete documentation index, see [llms.txt](https://help.digits.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.digits.com/firms-insights-and-reporting/budget-vs-actuals.md).

# Budget vs. Actuals

See how your client's actual financial performance compares to their budget, without waiting for month-end. Budget vs. Actuals updates automatically as transactions are posted to the ledger, so you're always working with the latest numbers.

***

### **Open or Upload a Budget**

Go to **Financials → Budgets**, then click a budget to open it, or click **Upload Budget** to add a new one from an XLSX or CSV file.

<div align="left"><figure><img src="https://3494946449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQp6kVxx1FJYsPtDHusNl%2Fuploads%2F2c8UY8dRKyt4KNEj1gw8%2Fimage.png?alt=media&amp;token=b056f87a-2c34-475a-84b1-dd576f4c424f" alt="" width="563"><figcaption></figcaption></figure></div>

***

### Upload a Budget

Bring your client's existing budget into Digits without rebuilding or reformatting your spreadsheet. ✨

1. Go to **Financials → Budgets** and click **Upload Budget**.
2. Click **Browse or Drag & Drop** and select your **XLSX** or **CSV** file (one file at a time).
3. Click **Upload**.

Digits imports your budget in the background, so you can keep working. You'll receive a notification when it's ready or if the import couldn't be completed.

{% hint style="info" icon="lightbulb-on" %}
**Supported Budget Formats**

Digits works with a variety of spreadsheet layouts, including:

* **Monthly, quarterly, and annual budgets:** Import budgets broken down by month or quarter, or with a single annual amount.
* **Multi-tab workbooks:** Each tab becomes a separate budget, with names based on the workbook.
* **Account numbers and categories:** Digits automatically matches budget rows to your client's Chart of Accounts, including account numbers.

**No special formatting required!** :sparkles: Digits uses AI to understand your spreadsheet's layout, then reads the amounts, and checks them against the file's subtotals and totals. You can trace every imported amount back to its original spreadsheet cell.

**Other Ways to Add Budgets**

Budgets can also make their way into Digits automatically:

* **QuickBooks:** Budgets from a connected QuickBooks account import automatically during sync.
* **Vault:** Upload a budget spreadsheet to your client's Vault, and Digits automatically recognizes and imports it.
  {% endhint %}

***

### What You'll See in a Budget

After you open or upload a budget, you'll land on the **Budget vs. Actuals** tab.

#### Net Income Chart (Budget to Date)

See actual net income (bars) compared to budgeted net income (line) for each period. Hover over any period to view the exact **Actual** and **Budget** amounts.

<div align="left"><figure><img src="https://3494946449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQp6kVxx1FJYsPtDHusNl%2Fuploads%2FmkWyUtcvzvPwkJbzVLEq%2Fimage.png?alt=media&amp;token=40adabed-ab10-4e38-912a-5d3e333979d5" alt="" width="367"><figcaption></figcaption></figure></div>

#### Top Category Variances

Quickly spot the categories with the biggest differences between budgeted and actual amounts.

Categories are grouped by performance:

* **Overperforming:** Revenue above budget or expenses below budget.
* **Underperforming:** Revenue below budget or expenses above budget.

Each category shows its **Budget**, **Variance**, and **% Diff**. Only variances representing at least 1% of that section's budget for the selected period appear here.

Click any category to explore its details.

<div align="left"><figure><img src="https://3494946449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQp6kVxx1FJYsPtDHusNl%2Fuploads%2FM2dIyEe75TPczypp82Xt%2Fimage.png?alt=media&amp;token=db5c0b95-01f1-472b-bd50-0eb29259ce8d" alt="" width="358"><figcaption></figcaption></figure></div>

#### Budget vs. Actuals Statement

<div align="left"><figure><img src="https://3494946449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQp6kVxx1FJYsPtDHusNl%2Fuploads%2FZuMXvfU2qswcncjMrYDF%2Fimage.png?alt=media&amp;token=afd5e01e-74f4-44bf-8fd8-0f3a3ea5b325" alt="" width="360"><figcaption></figcaption></figure></div>

The **Budget vs. Actuals** tab shows your client’s budget and actual results side by side, with these columns:

<table data-search="false"><thead><tr><th width="233.797607421875">Column</th><th>What It Shows</th></tr></thead><tbody><tr><td><em>Period</em> (e.g., <em>Mar 2026</em>)</td><td>Actual amount for the selected period</td></tr><tr><td><strong>Budget</strong></td><td>Budgeted amount for the period</td></tr><tr><td><strong>Δ Budget</strong></td><td>Period variance, in dollars, percent, or both</td></tr><tr><td><strong>YTD</strong></td><td>Actual year-to-date amount</td></tr><tr><td><strong>YTD Budget</strong></td><td>Budgeted year-to-date amount</td></tr><tr><td><strong>Δ YTD</strong></td><td>Year-to-date variance</td></tr><tr><td><strong>Total Budget</strong></td><td>Full-year budget</td></tr><tr><td><strong>YTD / Total Budget</strong></td><td>Percent of the full-year budget used so far</td></tr><tr><td><strong>Remaining Budget</strong></td><td>Full-year budget minus year-to-date actuals</td></tr></tbody></table>

* **Fiscal-year reporting:** Year-to-date (YTD) amounts follow your client’s fiscal year, not necessarily the calendar year.
* **Category rollups:** Parent categories automatically include totals from their child categories, following the chart of accounts hierarchy.
* **Expand or collapse rows:** Use the toggle next to **Options**.
* **Change the period:** Use the date selector at the top of the page to view a month, quarter, or year.
* **View the budget only:** Click the **Budget** tab to see the budgeted amount for each period, plus a **Total Budget** column.

***

### Customize Your Statement

Click **Options** to open **Statement Options** and choose how your budget comparison is displayed.

<div align="left"><figure><img src="https://3494946449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQp6kVxx1FJYsPtDHusNl%2Fuploads%2FOmEwNRvNhoHXE7jg76rB%2Fimage.png?alt=media&amp;token=189c36ba-0555-4ba5-8911-6578bdd43605" alt="" width="360"><figcaption></figcaption></figure></div>

<table><thead><tr><th width="208.40338134765625">Setting</th><th>What You Can Change</th></tr></thead><tbody><tr><td><strong>Number Format</strong></td><td>Show amounts as Rounded or Decimal (to the cent).</td></tr><tr><td><strong>Period Variance</strong></td><td>Show the difference between budget and actual as None, Delta (dollars), Percent, or Both.</td></tr><tr><td><strong>Year to Date (YTD)</strong></td><td>Show or hide YTD columns and choose how their variance appears.</td></tr><tr><td><strong>Full Year Budget</strong></td><td>Show or hide full-year budget columns. Turn on <strong>Show Remaining</strong> to see how much of the annual budget is left.</td></tr></tbody></table>

{% hint style="success" %}
**Your preferences are saved.** Digits remembers these statement settings for each client, so you don't have to configure them every time.
{% endhint %}

***

### Compare a Different Budget Version

Want to compare actual results against your original budget or a newer forecast?

Click the **version name** next to the budget title and select the version you'd like to use. Digits compares against the **Latest** version by default.

<div align="left"><figure><img src="https://3494946449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQp6kVxx1FJYsPtDHusNl%2Fuploads%2FoxyQ0uU5IzPpgcC3G65p%2Fimage.png?alt=media&amp;token=da3dbdf9-8f89-4b4d-a84f-81712bb6be3e" alt="" width="375"><figcaption></figcaption></figure></div>

* **Add a new version:** Open the budget, click **Upload New Version**, and upload the updated XLSX or CSV. Earlier versions are never overwritten.
* **Rename a version:** In the versions menu, click the pencil icon next to a version and enter a new name (for example, *Original*, *Q2 Reforecast*, or *Board-Approved*).

***

### Add Budget vs. Actuals to the Profit & Loss

You can also compare actual results against a budget directly in your client's **Profit & Loss**, without opening the Budgets page.

1. Go to **Financials → Statements** and open the **Profit & Loss**.
2. Click **Options**.
3. Under **Compare to**, select a budget.
4. Choose how to display the variance: **None**, **Percent**, or **Delta**.
5. Optionally, turn on **YTD Budget** and **Total Budget** to include those columns.

These options are also available when adding a Profit & Loss statement to a custom report.

***

### Add Budgets to Custom Reports

Include a client's budget in a custom report to share planned financial performance alongside other statements.

1. Go to **Financials → Custom Reports** and open the report you'd like to edit.
2. Enter edit mode and add a new component.
3. Open the **Statements** tab.
4. Select the **Budget** card for the budget you want to include, labeled *Revenue and expenses planned for the period*.

The Budget component displays planned amounts for the report period using the latest budget version.

**Want to show Budget vs. Actuals instead?** Add a **Profit & Loss** component and select the budget under **Compare to** in its options. This displays actual results alongside the budget and variance.

See [Creating a Custom Report](https://help.digits.com/firms-insights-and-reporting/custom-reports.md) for more on building and customizing reports.

***

### Comments & Activity

Open a budget to see its side panel. Use the **Comments** tab to discuss the budget with your team or your client, and the **Activity** tab to see who uploaded the budget or a new version, or renamed a version, and when.

***

### Export to PDF or Excel

Need to share your budget or work with the numbers outside Digits?

1. Open a budget.
2. Scroll down to the **Budget vs. Actuals** statement (on the **Budget** tab, it’s already at the top).
3. In the top-right corner of the statement, click the **Download** icon (the arrow pointing down into a tray).
4. Select **Download Excel** or **Download PDF**.

<div align="left"><figure><img src="https://3494946449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQp6kVxx1FJYsPtDHusNl%2Fuploads%2F5QNrE9IJxqayQVAxAHTH%2Fimage.png?alt=media&amp;token=903bdd5a-d530-4498-907e-959434ad4e1d" alt="" width="375"><figcaption></figcaption></figure></div>

***

### Ask Digits About Budgets

Ask Digits can answer questions about your client’s budget, using the same up-to-date numbers you see in Budget vs. Actuals.

Try asking:

* “*How did my marketing spend compare to my budget for last month?*”
* “*Where are we over budget this quarter?*”
* “*How much of our annual budget is left?*”
* “*What changed between the original budget and the latest version?*”

Ask Digits knows the difference between overspending on an expense and outperforming on revenue, so a variance is described the right way. It also tells you the period it looked at, so you can check that it matches the one you meant.

{% hint style="info" %}
Ask Digits can't break budgets down by department or location yet, since budgets are tracked by category only.
{% endhint %}

***

### Frequently Asked Questions

<details>

<summary>How often does Budget vs. Actuals update?</summary>

Continuously. Budget vs. Actuals reads from the live ledger, so when a transaction is booked or recategorized, the actuals and variances update.

</details>

<details>

<summary>Does YTD use the calendar year or the fiscal year?</summary>

The client's fiscal year.

</details>

<details>

<summary>Why does the chart say "No actuals yet"?</summary>

No transactions have been booked to the budget categories for the period yet. Once transactions are categorized, actuals will fill in.

</details>

<details>

<summary>How is variance on revenue different from variance on expenses?</summary>

Digits takes the direction into account. Revenue above budget and expenses below budget are both shown as **Overperforming**. Revenue below budget and expenses above budget are shown as **Underperforming**.

</details>

<details>

<summary>Can I create a budget or edit budget amounts directly in Digits?</summary>

Not today. Budgets come into Digits by spreadsheet upload or QuickBooks sync. To change amounts, update your spreadsheet and click **Upload New Version**. Digits keeps the earlier version so you can still compare against it.

</details>

<details>

<summary>What should I do if a budget import fails?</summary>

Try uploading the file again. If it keeps failing, check that the spreadsheet has a budget sheet with a clear name, a frequency (monthly, quarterly, or annual), and a date range. If you're still stuck, contact [Digits Support](mailto:help@digits.com) and include the file.

</details>

<details>

<summary>Can I budget by department, location, or customer?</summary>

Not yet. Budgets are tracked and reported by category (the client's chart of accounts). Department and location budgets are on our roadmap. For dimensional budgets, forecasting, and scenarios today, connect [Reach Reporting](https://help.digits.com/firms-connections/reach-reporting.md), which works from your client's live books in Digits.

</details>

<details>

<summary>Why don't I see Budgets under Financials?</summary>

The availability of Budgets depends on your Digits plan, and some actions also depend on your role. For example, uploading or deleting a budget needs the right permissions. Budgets is available for clients on the Digits Pro plan. If you expect to see Budgets and don’t, contact [Digits Support.](mailto:help@digits.com)

</details>

<details>

<summary>How do I delete a budget?</summary>

1. On the **Budgets** page, click the menu in the **top-right corner** of the budget card.

<div align="left"><figure><img src="https://3494946449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQp6kVxx1FJYsPtDHusNl%2Fuploads%2FsjBKPmrKCjMmehAnOrHC%2Fimage.png?alt=media&amp;token=32eb16f6-fa7e-437c-984e-cd8d1dcfa54f" alt="" width="182"><figcaption></figcaption></figure></div>

Or open the budget and click the menu to the **right of Upload New Version** at the top of the page.

<div align="left"><figure><img src="https://3494946449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQp6kVxx1FJYsPtDHusNl%2Fuploads%2FSHr0IIr83jpdV8eL0HZr%2Fimage.png?alt=media&amp;token=6fef64a9-274c-4e17-bc14-da63974bf595" alt="" width="375"><figcaption></figcaption></figure></div>

2. Select **Delete Budget.**
3. Click **Delete** to confirm.

{% hint style="warning" %}
Deleting a budget removes **all of its versions**. This can't be undone.
{% endhint %}

</details>

***

{% columns %}
{% column width="66.66666666666666%" valign="middle" %}
Got a question or feedback? Our team is all ears—come say hello!
{% endcolumn %}

{% column width="33.33333333333334%" valign="middle" %}

<p align="center"><a href="https://portal.usepylon.com/digits/forms/get-in-touch-with-digits-support" class="button primary" data-icon="envelope-open-text">Contact Digits Support</a></p>
{% endcolumn %}
{% endcolumns %}

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.digits.com/firms-insights-and-reporting/budget-vs-actuals.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
