docs: add spend alerts billing page

products/cloud/navigation.json

@@ -158,6 +158,7 @@
             },
             "products/cloud/reference/billing/network-data-transfer",
             "products/cloud/reference/billing/payment-thresholds",
+            "products/cloud/reference/billing/spend-alerts",
             "products/cloud/reference/billing/managing-payment-methods",
             "products/cloud/reference/billing/billing-compliance"
           ]

products/cloud/reference/billing/index.mdx

@@ -12,5 +12,6 @@ This section of the documentation covers topics related to billing, and contains
 |---------------------------------------|----------------------------------------------------------------------|
 | [Overview](/products/cloud/reference/billing/billing-overview)                       | Pricing examples and FAQs for billing.                      | 
 | [Payment Thresholds](/products/cloud/reference/billing/payment-thresholds)             | Learn more about how payment thresholds work and how to adjust them. |
+| [Spend Alerts](/products/cloud/reference/billing/spend-alerts)                  | Configure spend alerts to monitor usage against thresholds within a billing period. |
 | [Troubleshooting Billing Issues](/products/cloud/reference/billing/billing-compliance) | Troubleshoot common billing issues.                                  |
 | [Marketplace](/products/cloud/reference/billing/marketplace)                    | Landing page for further marketplace related topics.                 |

products/cloud/reference/billing/spend-alerts.mdx

@@ -0,0 +1,67 @@
+---
+sidebarTitle: 'Spend alerts'
+slug: /cloud/manage/billing/spend-alerts
+title: 'Configure organization spend alerts'
+description: 'Configure spend alerts to monitor ClickHouse Cloud usage against thresholds within a billing period.'
+keywords: ['billing', 'spend alerts', 'usage thresholds', 'notifications', 'cost monitoring', 'organization billing']
+doc_type: 'guide'
+---
+
+import { Image } from "/snippets/components/Image.jsx";
+
+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).
+
+## Prerequisites {#prerequisites}
+
+- You must have an **Organization Admin** or **Billing Admin** role to configure and view spend alerts.
+
+## How spend alerts work {#how-spend-alerts-work}
+
+- 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.
+
+<Note>
+**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.
+</Note>
+
+## Set up a spend alert {#set-up-spend-alert}
+
+<Steps>
+<Step>
+### Open the spend alerts dialog {#open-spend-alerts-dialog}
+
+1. Navigate to **Organization > Billing** in the ClickHouse Cloud console.
+2. Click **Actions > Add spend alerts**.
+
+<Image img="/images/cloud/reference/billing/spend-alerts-actions.png" size="lg" alt="Billing page with the Actions menu open and Add spend alerts highlighted"/>
+</Step>
+<Step>
+### Configure and save the alert {#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="/images/cloud/reference/billing/spend-alerts-config.png" size="md" alt="Organization spend alerts dialog with spend limit, automatic threshold alerts, and notification channels"/>
+</Step>
+</Steps>
+
+## Automatic threshold alerts {#threshold-alerts}
+
+Three 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                  |
+| **100%**  | Full spend reached              | $10                 |
+
+## Notification channels {#notification-channels}
+
+| 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.                         |