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

# Budgets and alerts

export const maia = "Maia";

The Budgets and alerts page lets you set credit usage thresholds so you're notified before you approach or exceed your allowance. Only Billing admins and Super admins can configure a budget.

To open it:

1. In your {maia} hub account, click your profile in the bottom-left corner.
2. Click **Budgets and alerts**.

The page has two tabs: **Global** and **Project**.

<Note>
  **Budgets do not restrict or block usage.** Pipelines, jobs, and {maia} continue to run normally even after a budget is exceeded. The only effect of crossing a budget threshold is a Budget Threshold alert.
</Note>

***

## Global budget

The global budget tracks total credit consumption across every project in your {maia} account. It's scoped to your current contract period—the thresholds you set apply from your contract start date to your contract end date, and reset when your contract renews.

At the top of the **Global** tab, you can see your Credit allowance, Contract start, and Contract end dates, which are read-only values pulled from your contract.

### Thresholds

You can set up to two percentage-based thresholds on your global credit allowance. When your consumption reaches a threshold, {maia} sends a notification to alert you.

* **Threshold 1:** The first warning point.
* **Threshold 2:** The second warning point, intended for a higher level of urgency.

### Set global budget thresholds

1. Click **...** in the top-right corner.
2. Click the edit thresholds option.
3. Enter a whole number between 1 and 100 in the **Threshold 1** and **Threshold 2** fields. The value represents the percentage of your total credit allowance at which you want to be notified.
4. Click **Save**.

***

## Project-level budgets

A project budget lets you set a credit limit for one or more individual projects, with threshold notifications when consumption approaches that limit.

The Project tab shows a table of all existing project budgets, with each row displaying the project name, its credit budget, and the two configured thresholds. You can sort the table by Project(s) or Budget, and use the search bar to filter by project name.

### Add a project budget

1. Click **Add project budget** in the top-right corner of the **Project** tab.
2. In the **Add project budget** dialog, click the **Projects** drop-down and select one or more projects. Select **Select All** to apply the budget to every project in your account.
3. In the **Budget** field, enter the credit limit for the selected projects.
4. In the **Threshold 1** and **Threshold 2** fields, enter a whole number between 1 and 100. Each value represents the percentage of the project budget at which you want to be notified. For example, entering 70 triggers a notification when 70% of the project budget has been consumed.
5. Click **Add**.

<Note>
  The **Add** button remains inactive until all required fields are filled in.
</Note>

### Edit a project budget

1. In the project budget table, click **...** at the end of the row you want to update.
2. Click **Edit**.
3. In the **Edit project budget** dialog, update the **Budget**, **Threshold 1**, or **Threshold 2** values as needed. The **Projects** field is locked and can't be changed once a budget has been created.
4. Click **Update**.

***

## Billing notifications

When your credit consumption crosses a threshold—whether global or project-level—{maia} sends a billing notification. You choose how you want to receive it—by email, Slack, or webhook—from the Notifications page.

To manage billing notifications, click **Manage notifications** in the top-right corner of the Credit management & budget controls page. This takes you to the Billing tab of the Notifications page, where you can view all billing notifications across your global and project budgets, and add or edit your delivery channels.

Recipients aren't configured here. Each user sets up their own delivery channels on the Billing tab to receive the notifications they want.

You can work in either direction: set a budget and thresholds here first, then add delivery channels on the Billing tab—or add a billing notification with delivery channels first, then set its budget and thresholds here.

For full details, read [Billing notifications](/docs/guides/billing-notifications).