> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-postgresql-tls-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Configure organization spend alerts

> Configure spend alerts to monitor ClickHouse Cloud usage against thresholds within a billing period.

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

Spend alerts notify you when your organization's usage reaches configured thresholds within a billing period, so you can avoid unexpected charges. They send notifications only; for thresholds that trigger automatic invoicing, see [Payment thresholds](/products/cloud/reference/billing/payment-thresholds).

<h2 id="prerequisites">
  Prerequisites
</h2>

* You must have an **Organization Admin** or **Billing Admin** role to configure and view spend alerts.

<h2 id="how-spend-alerts-work">
  How spend alerts work
</h2>

* Alerts are based on gross usage within a billing period and reset at the start of each new cycle.
* Alerts fire every hour, based on the gross usage calculated at that time, so an alert fires after a threshold is exceeded.

<Info>
  **Spend alerts don't cap usage**

  Reaching 100% of your spend alert doesn't restrict or cap your usage — spending continues to accumulate beyond the 100% threshold.
</Info>

<h2 id="set-up-spend-alert">
  Set up a spend alert
</h2>

<Steps>
  <Step title="Open the spend alerts dialog" id="open-spend-alerts-dialog">
    1. Navigate to **Organization > Billing** in the ClickHouse Cloud console.
    2. Click **Actions > Add spend alerts**.

    <Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/2QCOf7xGnBQgqjDM/images/cloud/reference/billing/spend-alerts-actions.webp?fit=max&auto=format&n=2QCOf7xGnBQgqjDM&q=85&s=04705b2b117ea633fde98142c7c7fd1f" alt="Billing page with the Actions menu open and Add spend alerts highlighted" size="lg" width="2048" height="264" data-path="images/cloud/reference/billing/spend-alerts-actions.webp" />
  </Step>

  <Step title="Configure and save the alert" id="configure-and-save">
    1. Enter a spend alert amount in dollars or credits per billing period.
    2. Select your notification channels: **Email**, **UI**, and/or **Slack**.
    3. Click **Save**.

    <Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/e176rR0svNh3jRYO/images/cloud/reference/billing/spend-alerts-config.png?fit=max&auto=format&n=e176rR0svNh3jRYO&q=85&s=225a7e657cb52af30ecd878eb126b8c6" alt="Organization spend alerts dialog with spend limit, automatic threshold alerts, and notification channels" size="md" width="1188" height="1910" data-path="images/cloud/reference/billing/spend-alerts-config.png" />
  </Step>
</Steps>

<h2 id="threshold-alerts">
  Automatic threshold alerts
</h2>

Four alerts are automatically created and triggered based on your configured spend alert amount:

| Threshold | Trigger                         | Example (\$10 alert) |
| --------- | ------------------------------- | -------------------- |
| **50%**   | Half of spend reached           | \$5                  |
| **75%**   | Three-quarters of spend reached | \$8                  |
| **90%**   | Ninety percent of spend reached | \$9                  |
| **100%**  | Full spend reached              | \$10                 |

<h2 id="notification-channels">
  Notification channels
</h2>

| Channel   | Description                                                                                |
| --------- | ------------------------------------------------------------------------------------------ |
| **Email** | Sends alerts to the configured email address. Click the edit icon to change the recipient. |
| **UI**    | Displays alerts in the ClickHouse Cloud console.                                           |
| **Slack** | Sends alerts to a Slack channel. Click the edit icon to configure.                         |