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

# Budgets

> The budget envelopes that already exist, as a tree by tier, with spend against each limit; change an existing limit with cost:manage.

**Analytics → Budgets** (`/analytics/budgets`) shows the spending limits that exist, as a tree by tier, with spend and burn rate against each limit, and lets an operator with `cost:manage` change a limit. Every Convex-native dispatch passes the budget gate, which compares the projected spend against the active envelope.

![Budgets](https://mintcdn.com/gloo-b243725a/xyq5perq6SLByPBn/forge/images/console/analytics/budgets-light.png?fit=max\&auto=format\&n=xyq5perq6SLByPBn\&q=85\&s=93a4f56f1b137f0487e6b09d91498deb)

Budgets — Forge Console at `/analytics/budgets`

## What you can do

* See every budget envelope that exists, as a tree by tier (org, factory, project, agent), with its period, its limit, its spend and its projected days remaining. Expand or collapse one envelope, or use **Expand All** and **Collapse All**.
* Change an existing envelope's limit, if you hold `cost:manage`: choose the pencil on its row (**Edit budget limit**), read its **Current spend**, set the **Limit (USD)**, and choose **Save changes**.
* With no envelopes, the page says **No budgets configured**. The Console has no control to create an envelope, so there is nothing to set up here.

To freeze or unfreeze an envelope, use the Budget freezes card on [Emergency stops](https://docs.gloo.com/forge/console/trust-fabric/emergency-stops.md).

## Each envelope row

| Part | What it shows |
| - | - |
| Name and tier | The envelope's name and a tier badge |
| Alerts | A bell with a count when the envelope's alerts have triggered |
| Period | The envelope's period type |
| Limit | The limit for the period |
| Utilization | Spend against the limit, as a figure and a bar |
| Days remaining | The burn-rate projection, `~Nd remaining`, or **Exhausted** below one day |

## Key state to watch

* **Utilization %** — spend against the limit for the period. The figure turns amber above 80% and red above 95%.
* **Alerts** — a bell with a count marks an envelope whose alerts have triggered.
* **Days remaining** — the projection turns amber below 30 days and red below 7.

## Related surfaces

* [Emergency stops](https://docs.gloo.com/forge/console/trust-fabric/emergency-stops.md) — freeze or unfreeze an envelope.
* [Cost](https://docs.gloo.com/forge/console/analytics/cost.md) — where the spend comes from.
* [Budgets and cost](https://docs.gloo.com/forge/run/budgets-and-cost.md) — how envelopes and the budget gate work.


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