> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-detect-table-modification.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-detect-table-modification/I0yKDIFW2QfsHJIe/images/cloud/reference/billing/spend-alerts-actions.webp?fit=max&auto=format&n=I0yKDIFW2QfsHJIe&q=85&s=4d7eeb307511f63a531104fef8b2187e" 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-detect-table-modification/4ICQnxABf5U6Loew/images/cloud/reference/billing/spend-alerts-config.png?fit=max&auto=format&n=4ICQnxABf5U6Loew&q=85&s=0ebea9face14597d3bae97a02619d0e1" 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.                         |