diff --git a/images/cloud/reference/billing/spend-alerts-actions.png b/images/cloud/reference/billing/spend-alerts-actions.png
new file mode 100644
index 00000000..af3daf42
Binary files /dev/null and b/images/cloud/reference/billing/spend-alerts-actions.png differ
diff --git a/images/cloud/reference/billing/spend-alerts-config.png b/images/cloud/reference/billing/spend-alerts-config.png
new file mode 100644
index 00000000..763a7fd3
Binary files /dev/null and b/images/cloud/reference/billing/spend-alerts-config.png differ
diff --git a/products/cloud/navigation.json b/products/cloud/navigation.json
index 9113915d..ebc7d763 100644
--- a/products/cloud/navigation.json
+++ b/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"
]
diff --git a/products/cloud/reference/billing/index.mdx b/products/cloud/reference/billing/index.mdx
index c2beb231..d1487498 100644
--- a/products/cloud/reference/billing/index.mdx
+++ b/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. |
diff --git a/products/cloud/reference/billing/spend-alerts.mdx b/products/cloud/reference/billing/spend-alerts.mdx
new file mode 100644
index 00000000..7913cd48
--- /dev/null
+++ b/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.
+
+
+**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.
+
+
+## Set up a spend alert {#set-up-spend-alert}
+
+
+
+### 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**.
+
+
+
+
+### 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**.
+
+
+
+
+
+## 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. |