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

# Usage alerts

> Set spending limits and get notified by email when your usage exceeds them.

Usage alerts let you set a spending limit and choose threshold percentages of that limit. When usage in the current billing period crosses a threshold, Sevalla sends an email to the recipients you configure.

You can set alerts at two levels:

* **Company**: tracks total spending across every project, application, database, static site, object storage, and load balancer in your company.
* **Project**: tracks spending for the services that belong to a single project.

You can have one alert configuration for the company and one for each project.

## How alerts work

Each alert configuration has:

* A **spending limit** in USD.
* One or more **threshold percentages** (between 1 and 100, up to 10 per configuration). For example, 50%, 75%, and 90%.
* One or more **email recipients**.

Sevalla checks usage against your alerts every hour. When the current period's usage crosses a threshold, an email is sent to every recipient on the configuration. Each threshold triggers at most once per billing period, so you receive a single notification per threshold even if usage continues to grow.

When the next billing period starts, all thresholds reset and become eligible to trigger again.

## Create a company-wide alert

Click **Company settings** > [Usage](/billing/usage)  and then click **Add alert**.

<Frame caption="Add usage alerts in Sevalla.">
  <img alt="Add usage alerts in Sevalla" src="https://mintcdn.com/sevalla/BfU-mJMeRGGfw1r8/images/usage-alert-light.png?fit=max&auto=format&n=BfU-mJMeRGGfw1r8&q=85&s=04c9c2d8589427ff324007d26cecbbdf" className="dark:hidden" width="3558" height="716" data-path="images/usage-alert-light.png" />

  <img alt="Add usage alerts in Sevalla" src="https://mintcdn.com/sevalla/BfU-mJMeRGGfw1r8/images/usage-alert-dark.png?fit=max&auto=format&n=BfU-mJMeRGGfw1r8&q=85&s=e1a90defd2b97d7317d2f0ee12ddaf58" className="hidden dark:block" width="3558" height="708" data-path="images/usage-alert-dark.png" />
</Frame>

Set the following:

* **Budget limit** - the USD amount from which the thresholds are calculated.
* **Percentage thresholds** - one or more percentages of the limit. Add up to 10 thresholds.
* **Email recipients** - one or more email addresses to notify. Click **Add recipient** to add more email addresses.

Click **Create alert** to save. The alert applies to the total spending of every service in your company.

<Frame caption="Configure your usage alert in Sevalla.">
  <img alt="Configure your usage alert in Sevalla" src="https://mintcdn.com/sevalla/JwUlsHYrQ9vEGJMg/images/usage-alert-details-light.png?fit=max&auto=format&n=JwUlsHYrQ9vEGJMg&q=85&s=4c54b8c506117dae9bb6bfbcfd908923" className="dark:hidden" width="1180" height="1132" data-path="images/usage-alert-details-light.png" />

  <img alt="Configure your usage alert in Sevalla" src="https://mintcdn.com/sevalla/JwUlsHYrQ9vEGJMg/images/usage-alert-details-dark.png?fit=max&auto=format&n=JwUlsHYrQ9vEGJMg&q=85&s=1eccb400610c7737dd409fdcc94871c0" className="hidden dark:block" width="1176" height="1120" data-path="images/usage-alert-details-dark.png" />
</Frame>

## Create a project alert

Open the project, go to its [Usage](/projects/usage) tab, and click **Add alert**. The fields are the same as for a company alert, but the thresholds are calculated only against the spending of services that belong to that project.

A project alert is independent of the company alert. If you have both, you can be notified when the project or the company crosses its limit, or both.

<Frame caption="Add usage alerts to projects in Sevalla.">
  <img alt="Add usage alerts to projects in Sevalla" src="https://mintcdn.com/sevalla/BfU-mJMeRGGfw1r8/images/usage-alert-projects-light.png?fit=max&auto=format&n=BfU-mJMeRGGfw1r8&q=85&s=5426b0a01cce629f5e422743ed6367f7" className="dark:hidden" width="3634" height="1876" data-path="images/usage-alert-projects-light.png" />

  <img alt="Add usage alerts to projects in Sevalla" src="https://mintcdn.com/sevalla/BfU-mJMeRGGfw1r8/images/usage-alert-projects-dark.png?fit=max&auto=format&n=BfU-mJMeRGGfw1r8&q=85&s=f4ad9271b2c945036b7b59084bf65c13" className="hidden dark:block" width="3634" height="1880" data-path="images/usage-alert-projects-dark.png" />
</Frame>

## Update or delete an alert

Within the **Usage alerts**, you can:

* **Update:** Change the spending limit, thresholds, or recipients.
* **Delete:** Delete the alert. Once deleted, no further emails are sent for it.

When a project is deleted, its usage alert is removed automatically.

<Frame caption="Update or delete alerts in Sevalla.">
  <img alt="Update or delete alerts in Sevalla" src="https://mintcdn.com/sevalla/JwUlsHYrQ9vEGJMg/images/usage-alert-update-delete-light.png?fit=max&auto=format&n=JwUlsHYrQ9vEGJMg&q=85&s=b699fcec33e1d5f9437623c86c816b7a" className="dark:hidden" width="2556" height="1004" data-path="images/usage-alert-update-delete-light.png" />

  <img alt="Update or delete alerts in Sevalla" src="https://mintcdn.com/sevalla/JwUlsHYrQ9vEGJMg/images/usage-alert-update-delete-dark.png?fit=max&auto=format&n=JwUlsHYrQ9vEGJMg&q=85&s=54ae39ea7c61573ef39c562fd8cd829b" className="hidden dark:block" width="2554" height="1004" data-path="images/usage-alert-update-delete-dark.png" />
</Frame>

## Notes

* Usage alerts are notifications only. They do not pause, suspend, or limit any of your services when a threshold is reached.
* Thresholds are evaluated against gross usage (including tax) for the current billing period, matching the totals shown on the [Usage page](/billing/usage).
* If you change the spending limit or thresholds mid-period, the new values take effect on the next hourly check. Thresholds that already fired this period stay fired until the next period starts.
