> For the complete documentation index, see [llms.txt](https://docs.silkline.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.silkline.ai/profile-and-settings/organization-settings/budgets.md).

# Budgets

Enable the Budgets feature for your organization so users can create budgets, assign items, and route budget owners into purchase approvals

The **Budgets** feature enables organizations to track and manage spending against allocated budget amounts. When enabled, users can create budgets, assign purchase order items and request items to budgets, and monitor spending in real-time.

## Enabling Budgets

{% hint style="warning" %}
**Silkline Admin Only:** Only users with Silkline Admin permissions can enable or disable the Budgets feature. Contact a Silkline administrator if you need to enable this feature.
{% endhint %}

To enable budgets for your organization:

1. Navigate to **Organization Settings** → **Budgets**
2. Toggle **Enable Budgets** to turn on the feature
3. Once enabled, users can access budgets from the main navigation

When budgets are enabled, a new **Budgets** page appears in the main navigation where users can create and manage budgets.

## Creating a Budget

To create a new budget:

1. Navigate to the **Budgets** page from the main navigation
2. Click **Create Budget**
3. Fill in the budget details:
   * **Name** — A unique identifier for the budget (required)
   * **Description** — Optional details about the budget's purpose
   * **Amount** — The total budget allocation (required)
   * **Currency** — The currency for the budget amount
   * **Include Taxes** — Toggle whether budget tracking should include or exclude taxes
   * **Owners** — Optional users responsible for reviewing this budget

{% hint style="info" %}
**Budget Owners:** Budget owners are automatically added to the approval routing for orders that contain items assigned to their budgets. Owners do not control who can assign items to the budget. Budgets without owners can still be used for spend tracking, but they will not add a budget approver to the approval workflow.
{% endhint %}

## Budget Properties

Each budget tracks the following information:

| Property          | Description                                                                            |
| ----------------- | -------------------------------------------------------------------------------------- |
| **Name**          | Name of the budget                                                                     |
| **Description**   | Optional details about the budget's purpose or scope                                   |
| **Amount**        | Total allocated budget amount                                                          |
| **Currency**      | Currency for the budget (can differ from order currencies—Silkline handles conversion) |
| **Include Taxes** | Whether budget tracking includes taxes in spend calculations                           |
| **Owners**        | Optional users responsible for reviewing this budget                                   |
| **Status**        | Active or Archived                                                                     |
| **Firm Spend**    | Spending from sent purchase orders (OPEN or CLOSED state) plus external spend          |
| **Unfirm Spend**  | Spending from draft or approved purchase orders (DRAFT, REVIEW, or APPROVED state)     |
| **Total Spend**   | Combined firm and unfirm spending                                                      |
| **Remaining**     | Budget amount minus total spend                                                        |
| **Utilization**   | Percentage of budget consumed                                                          |

## Spend Tracking

Budgets automatically track spending based on order items assigned to them:

### Firm Spend

**Firm spend** represents committed spending from purchase orders that have been sent to suppliers:

* Includes orders in **OPEN** or **CLOSED** states
* These are confirmed obligations to suppliers
* Shown in dark blue on the progress bar

### Unfirm Spend

**Unfirm spend** represents planned spending from orders that haven't been sent yet:

* Includes orders in **DRAFT**, **REVIEW**, or **APPROVED** states
* These are pending orders that may still change
* Shown in light blue on the progress bar

### External Spend

**External spend** is money spent against a budget outside Silkline, such as invoices paid directly or purchases made in another system:

* Recorded per budget, either by importing a CSV or by adding single entries on the budget's **External Spend** tab
* Counts toward firm spend
* Adding requires **Create Budget**; editing and deleting entries require **Edit Budget** and **Delete Budget**

See [External Spend](https://docs.silkline.ai/budgets.md#external-spend) for the CSV format and step-by-step instructions.

### Multi-Currency Budgets

Budgets support multi-currency operations:

* A budget can be in one currency (e.g., USD) while orders are in different currencies (e.g., EUR, GBP)
* Silkline automatically converts order item costs to the budget's currency using current exchange rates
* Spending is tracked in the budget's currency for accurate utilization reporting

## Assigning Items to Budgets

Budget assignments happen at the line item level on purchase orders and requests:

### Order Items

When creating or editing a purchase order:

1. In the line items table, locate the **Budget** column
2. Click the dropdown for the line item you want to assign
3. Select the appropriate budget from the list
4. The order item's cost (with or without taxes, based on budget settings) is immediately reflected in the budget's spend

Budget availability is based on whether the budget is active and the user's normal order permissions. A budget does not need an owner to be selected on a line item.

### Request Items

Similarly, when creating or editing a request:

1. Assign a budget to individual request items
2. When requests are converted to orders, the budget assignment carries over automatically

Budget availability is based on whether the budget is active and the user's normal request permissions.

{% hint style="success" %}
**Best Practice:** Assign budgets at the request stage to ensure consistent tracking throughout the procurement lifecycle.
{% endhint %}

## Viewing Budget Details

Click on any budget in the budgets table to view its detail page, which includes:

### Spend Summary

The top section displays:

* Budget amount and currency
* Include/exclude taxes setting
* Budget owners
* Visual progress bar showing firm spend, unfirm spend, and remaining budget
* Utilization percentage

### Order Items Tab

Lists all purchase order line items assigned to this budget, showing:

* Order number and supplier
* Line item description and quantity
* Unit cost and line total
* Order status
* Cost converted to the budget's currency

### Request Items Tab

Lists all request items assigned to this budget, showing:

* Request number
* Item description and quantity
* Estimated cost
* Request status

### External Spend Tab

Lists spend recorded against this budget from outside Silkline, showing the amount, memo, and effective date of each entry. Entries can be added, edited, and deleted here; entries synced from an integration are read-only.

<figure><img src="https://2684497859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwPsevXC0g5kNMF7GTyPN%2Fuploads%2Fgit-blob-7643861e7b4da2e00f74e7eee2a4c96662fd32e4%2Fbudgets-external-spend-tab.png?alt=media" alt=""><figcaption></figcaption></figure>

## Managing Budgets

### Editing a Budget

To edit an existing budget:

1. Navigate to the budget detail page
2. Click the **Edit** button (pencil icon)
3. Modify any fields except:
   * Budget name (must remain unique)
4. Save your changes

{% hint style="info" %}
Changing budget owners or amounts does not affect existing assignments—all previously assigned order items and request items remain associated with the budget.
{% endhint %}

### Archiving a Budget

When a budget is no longer active (e.g., fiscal year ended), you can archive it:

1. Open the budget detail page
2. Click **Edit**
3. Toggle **Archive** to mark it inactive
4. Archived budgets:
   * Are hidden from dropdowns when assigning new items
   * Remain visible in budget lists (use filters to show/hide)
   * Preserve all historical spend data and assignments

### Deleting a Budget

To permanently delete a budget:

1. Open the budget detail page
2. Click the **Delete** button (trash icon)
3. Confirm the deletion

{% hint style="warning" %}
**Caution:** Deleting a budget:

* Removes the budget permanently
* Unassigns all order items and request items from the budget
* Cannot be undone
  {% endhint %}

## Viewing Your Budgets

Users can filter the budgets list to show only budgets they own:

1. Navigate to the **Budgets** page
2. Use the filter or toggle to view **My Budgets**
3. This shows only budgets where you are listed as an owner

## Reducing Budget Visibility

By default every user can see all of the organization's budgets. **Reduce Budget Visibility** focuses budget views on the budgets each user owns or is a member of.

{% hint style="warning" %}
**Reduce Budget Visibility is a display setting, not a permission boundary.** It changes which budgets appear in budget views. It does not restrict access to budget data. Users can still select any active budget on line items, and budget data remains available through reporting and the API.
{% endhint %}

To turn it on for every budget:

1. Navigate to **Organization Settings** → **Budgets**
2. Toggle **Reduce Budget Visibility**

To turn it on for a single budget, edit the budget and toggle **Reduce Budget Visibility**. When the organization-wide setting is on, every budget is already reduced.

When a budget's visibility is reduced:

* The **Budgets** page lists it only for its owners and members
* Opening it as anyone else redirects back to the budgets list
* The approval guide's **Budgets** section shows it only to its owners and members
* Budget dropdowns on line items still list it by name, but hide its amount

Users with the **Edit Budget** permission see every budget, whatever its visibility setting. The **Administrator** and **Finance & Legal** roles include this permission.

## Budget Utilization Tracking

The budget table displays key metrics for each budget:

* **Amount** — Total allocated budget
* **Total Spend** — Firm + unfirm spending
* **Remaining** — Amount - total spend
* **Utilization** — Visual bar showing percentage used

Color-coded utilization:

* **Green** — Under budget (utilization < 85%)
* **Yellow** — Approaching budget (utilization ≥ 85% and < 100%)
* **Red** — Over budget (utilization ≥ 100%)

{% hint style="info" %}
Over-budget warnings help identify when spending has exceeded allocations, but Silkline does not prevent orders from being placed against over-budget budgets.
{% endhint %}

## Common Use Cases

### Project-Based Budgets

Create budgets for specific projects or programs:

```
Name: Project Falcon - Prototype Build
Amount: $150,000
Currency: USD
Owners: Engineering Lead, Procurement Manager
```

Assign all orders related to the project to track spending against the project budget.

### Department Budgets

Set up budgets for each department or cost center:

```
Name: Manufacturing - Q1 2025
Amount: $500,000
Currency: USD
Owners: Manufacturing Manager
Include Taxes: Yes
```

### Program Budgets

Track spending across multiple projects within a program:

```
Name: R&D - Fiscal Year 2025
Amount: $2,000,000
Currency: USD
Owners: R&D Director, Finance Controller
```

## Permissions

Budget management is controlled by organization permissions:

* **Create Budget** — Create new budgets and add external spend
* **Edit Budget** — Modify existing budgets, edit external spend entries, and see every budget when [budget visibility is reduced](#reducing-budget-visibility)
* **Delete Budget** — Remove budgets and delete external spend entries

Assigning budgets to order or request line items follows the user's normal order or request permissions. Budget owners do not receive special access solely because they are listed as owners.

## Budgets and Approvals

When order items are assigned to budgets, the budget owners are automatically included in the approval workflow:

* **Automatic Routing:** Budget owners are added to the default approval chain for any order containing items assigned to their budgets
* **Approval Position:** Budget approvers appear early in the approval workflow, after required approvers but before threshold-based approvers. Several budget owners are sequenced by approval limit, lowest first
* **Deduplication:** If a budget owner already appears in the approval chain (e.g., as a required approver or threshold approver), they are not duplicated
* **Visibility:** Budget information, including utilization and spending, is displayed in the approval guide widget to help approvers make informed decisions

For more information about how approvals work, see [Approvals](https://docs.silkline.ai/approvals.md).
