Skip to content

The Postgres development platform. Supabase gives you a dedicated Postgres database to build your web, mobile, and AI applications.

docs: overage docs and spend cap clarification (#41814)

Kevin Grüneberg9cd201c4476d
diff --git a/apps/docs/content/_partials/billing/exceeding_usage_quotas.mdx b/apps/docs/content/_partials/billing/exceeding_usage_quotas.mdx
new file mode 100644
index 00000000000..3cb0039154b
--- /dev/null
+++ b/apps/docs/content/_partials/billing/exceeding_usage_quotas.mdx
@@ -0,0 +1,3 @@
+If you are on a paid plan and have [Spend Cap](/docs/guides/platform/cost-control#spend-cap) disabled or your organization is on Team Plan or above, you will pay for any overages.
+
+When you are exceeding your quotas while being on a Free Plan or having [Spend Cap](/docs/guides/platform/cost-control#spend-cap) enabled, you will get a notification to your billing email address and put under a grace period. For more details, refer to our [Fair Use Policy](/docs/guides/platform/billing-faq#fair-use-policy).
diff --git a/apps/docs/content/guides/platform/manage-your-usage/advanced-mfa-phone.mdx b/apps/docs/content/guides/platform/manage-your-usage/advanced-mfa-phone.mdx
index 9a68ac80b7b..de07fe87bb9 100644
--- a/apps/docs/content/guides/platform/manage-your-usage/advanced-mfa-phone.mdx
+++ b/apps/docs/content/guides/platform/manage-your-usage/advanced-mfa-phone.mdx
@@ -9,6 +9,12 @@ You are charged for having the feature [Advanced Multi-Factor Authentication Pho
<Admonition type="note">
+The Advanced MFA Phone add-on is **not** covered by the [Spend Cap](/docs/guides/platform/cost-control#spend-cap).
+
+</Admonition>
+
+<Admonition type="note">
+
Additional charges apply for each SMS or WhatsApp message sent, depending on your third-party messaging provider (such as Twilio or MessageBird).
</Admonition>
diff --git a/apps/docs/content/guides/platform/manage-your-usage/branching.mdx b/apps/docs/content/guides/platform/manage-your-usage/branching.mdx
index 28f86ca2632..e710ac28e77 100644
--- a/apps/docs/content/guides/platform/manage-your-usage/branching.mdx
+++ b/apps/docs/content/guides/platform/manage-your-usage/branching.mdx
@@ -7,7 +7,11 @@ title: 'Manage Branching usage'
Each [Preview branch](/docs/guides/deployment/branching) is a separate environment with all Supabase services (Database, Auth, Storage, etc.). You're charged for usage within that environment—such as [Compute](/docs/guides/platform/manage-your-usage/compute), [Disk Size](/docs/guides/platform/manage-your-usage/disk-size), [Egress](/docs/guides/platform/manage-your-usage/egress), and [Storage](/docs/guides/platform/manage-your-usage/storage-size)—just like the project you branched from.
-Usage by Preview branches counts toward your subscription plan's quota.
+<Admonition type="note">
+
+Usage by Preview branches counts toward your subscription plan's quota. Branches are **not** covered by the [Spend Cap](/docs/guides/platform/cost-control#spend-cap).
+
+</Admonition>
## How charges are calculated
diff --git a/apps/docs/content/guides/platform/manage-your-usage/compute.mdx b/apps/docs/content/guides/platform/manage-your-usage/compute.mdx
index 81babd748c5..c407b4f6fca 100644
--- a/apps/docs/content/guides/platform/manage-your-usage/compute.mdx
+++ b/apps/docs/content/guides/platform/manage-your-usage/compute.mdx
@@ -7,7 +7,11 @@ title: 'Manage Compute usage'
Each project on the Supabase platform includes a dedicated Postgres instance running on its own server. You are charged for the [Compute](/docs/guides/platform/compute-and-disk#compute) resources of that server, independent of your database usage.
-Paused projects do not count towards Compute usage.
+<Admonition type="note">
+
+Paused projects do not count towards Compute usage. Compute Hours are **not** covered by the [Spend Cap](/docs/guides/platform/cost-control#spend-cap).
+
+</Admonition>
## How charges are calculated
diff --git a/apps/docs/content/guides/platform/manage-your-usage/custom-domains.mdx b/apps/docs/content/guides/platform/manage-your-usage/custom-domains.mdx
index 1860f2de8db..c9df982b997 100644
--- a/apps/docs/content/guides/platform/manage-your-usage/custom-domains.mdx
+++ b/apps/docs/content/guides/platform/manage-your-usage/custom-domains.mdx
@@ -7,6 +7,12 @@ title: 'Manage Custom Domain usage'
You can configure a [custom domain](/docs/guides/platform/custom-domains) for a project by enabling the [Custom Domain add-on](/dashboard/project/_/settings/addons?panel=customDomain). You are charged for all custom domains configured across your projects.
+<Admonition type="note">
+
+Custom Domains are **not** covered by the [Spend Cap](/docs/guides/platform/cost-control#spend-cap).
+
+</Admonition>
+
## How charges are calculated
Custom domains are charged by the hour, meaning you are charged for the exact number of hours that a custom domain is active. If a custom domain is active for part of an hour, you are still charged for the full hour.
diff --git a/apps/docs/content/guides/platform/manage-your-usage/disk-iops.mdx b/apps/docs/content/guides/platform/manage-your-usage/disk-iops.mdx
index 0db9796a521..0886d59d92e 100644
--- a/apps/docs/content/guides/platform/manage-your-usage/disk-iops.mdx
+++ b/apps/docs/content/guides/platform/manage-your-usage/disk-iops.mdx
@@ -11,6 +11,12 @@ Refer to our [disk guide](/docs/guides/platform/compute-and-disk#disk) for detai
<Admonition type="note">
+Disk IOPS Hours are **not** covered by the [Spend Cap](/docs/guides/platform/cost-control#spend-cap).
+
+</Admonition>
+
+<Admonition type="note">
+
Launching a Read Replica creates an additional database with its own dedicated disk. Read Replicas inherit the primary database's disk IOPS settings. You are charged for the provisioned IOPS of the Read Replica. Refer to [Manage Read Replica usage](/docs/guides/platform/manage-your-usage/read-replicas) for details on billing.
</Admonition>
diff --git a/apps/docs/content/guides/platform/manage-your-usage/disk-size.mdx b/apps/docs/content/guides/platform/manage-your-usage/disk-size.mdx
index 1bf78ecc9ed..5ea0b0bf6ba 100644
--- a/apps/docs/content/guides/platform/manage-your-usage/disk-size.mdx
+++ b/apps/docs/content/guides/platform/manage-your-usage/disk-size.mdx
@@ -130,3 +130,7 @@ To see how your disk usage is distributed across Database, WAL, and System categ
## Reduce Disk size
To see how you can downsize your disk, refer to [Reducing disk size](/docs/guides/platform/database-size#reducing-disk-size)
+
+## Exceeding Quotas
+
+<$Partial path="billing/exceeding_usage_quotas.mdx" />
diff --git a/apps/docs/content/guides/platform/manage-your-usage/disk-throughput.mdx b/apps/docs/content/guides/platform/manage-your-usage/disk-throughput.mdx
index 421f563de31..aed48b0c3a0 100644
--- a/apps/docs/content/guides/platform/manage-your-usage/disk-throughput.mdx
+++ b/apps/docs/content/guides/platform/manage-your-usage/disk-throughput.mdx
@@ -11,6 +11,12 @@ Refer to our [disk guide](/docs/guides/platform/compute-and-disk#disk) for detai
<Admonition type="note">
+Disk Throughput is **not** covered by the [Spend Cap](/docs/guides/platform/cost-control#spend-cap).
+
+</Admonition>
+
+<Admonition type="note">
+
Launching a Read Replica creates an additional database with its own dedicated disk. Read Replicas inherit the primary database's disk throughput settings. You are charged for the provisioned throughput of the Read Replica.
</Admonition>
diff --git a/apps/docs/content/guides/platform/manage-your-usage/edge-function-invocations.mdx b/apps/docs/content/guides/platform/manage-your-usage/edge-function-invocations.mdx
index 9109b2d3261..6fe31598b99 100644
--- a/apps/docs/content/guides/platform/manage-your-usage/edge-function-invocations.mdx
+++ b/apps/docs/content/guides/platform/manage-your-usage/edge-function-invocations.mdx
@@ -81,3 +81,7 @@ In the Edge Function Invocations section, you can see how many invocations your
}}
zoomable
/>
+
+## Exceeding Quotas
+
+<$Partial path="billing/exceeding_usage_quotas.mdx" />
diff --git a/apps/docs/content/guides/platform/manage-your-usage/egress.mdx b/apps/docs/content/guides/platform/manage-your-usage/egress.mdx
index 0652921c49f..5a3621237a6 100644
--- a/apps/docs/content/guides/platform/manage-your-usage/egress.mdx
+++ b/apps/docs/content/guides/platform/manage-your-usage/egress.mdx
@@ -195,3 +195,7 @@ In the [Logs Explorer](/dashboard/project/_/logs/explorer) you can access Edge L
- For update or insert queries, configure your ORM or queries to not return the entire row if not needed
- When running manual backups through Supavisor, remove unneeded tables and/or reduce the frequency
- Refer to the [Storage Optimizations guide](/docs/guides/storage/production/scaling#egress) for tips on reducing Storage Egress
+
+## Exceeding Quotas
+
+<$Partial path="billing/exceeding_usage_quotas.mdx" />
diff --git a/apps/docs/content/guides/platform/manage-your-usage/ipv4.mdx b/apps/docs/content/guides/platform/manage-your-usage/ipv4.mdx
index 321eb06f29f..ee5a35da335 100644
--- a/apps/docs/content/guides/platform/manage-your-usage/ipv4.mdx
+++ b/apps/docs/content/guides/platform/manage-your-usage/ipv4.mdx
@@ -9,6 +9,12 @@ You can assign a dedicated [IPv4 address](/docs/guides/platform/ipv4-address) to
<Admonition type="note">
+IPv4 Hours are **not** covered by the [Spend Cap](/docs/guides/platform/cost-control#spend-cap).
+
+</Admonition>
+
+<Admonition type="note">
+
If the primary database has a dedicated IPv4 address configured, its Read Replicas are also assigned one, with charges for each.
</Admonition>
diff --git a/apps/docs/content/guides/platform/manage-your-usage/log-drains.mdx b/apps/docs/content/guides/platform/manage-your-usage/log-drains.mdx
index a734d5a00ad..c102c195f8f 100644
--- a/apps/docs/content/guides/platform/manage-your-usage/log-drains.mdx
+++ b/apps/docs/content/guides/platform/manage-your-usage/log-drains.mdx
@@ -7,6 +7,12 @@ title: 'Manage Log Drain usage'
You can configure log drains in the [project settings](/dashboard/project/_/settings/log-drains) to send logs to one or more destinations. You are charged for each log drain that is configured (referred to as [Log Drain Hours](/docs/guides/platform/manage-your-usage/log-drains#log-drain-hours)), the log events sent (referred to as [Log Drain Events](/docs/guides/platform/manage-your-usage/log-drains#log-drain-events)), and the [Egress](/docs/guides/platform/manage-your-usage/egress) incurred by the export—across all your projects.
+<Admonition type="note">
+
+Log Drains are **not** covered by the [Spend Cap](/docs/guides/platform/cost-control#spend-cap).
+
+</Admonition>
+
## Log Drain Hours
### How charges are calculated
diff --git a/apps/docs/content/guides/platform/manage-your-usage/monthly-active-users-sso.mdx b/apps/docs/content/guides/platform/manage-your-usage/monthly-active-users-sso.mdx
index cd88dac94b2..7b492a6287f 100644
--- a/apps/docs/content/guides/platform/manage-your-usage/monthly-active-users-sso.mdx
+++ b/apps/docs/content/guides/platform/manage-your-usage/monthly-active-users-sso.mdx
@@ -136,3 +136,7 @@ In the Monthly Active SSO Users section, you can see the usage for the selected
dark: '/docs/img/guides/platform/usage-mau-sso--dark.png',
}}
/>
+
+## Exceeding Quotas
+
+<$Partial path="billing/exceeding_usage_quotas.mdx" />
diff --git a/apps/docs/content/guides/platform/manage-your-usage/monthly-active-users-third-party.mdx b/apps/docs/content/guides/platform/manage-your-usage/monthly-active-users-third-party.mdx
index 2f0a67e40b1..5b0db25b08a 100644
--- a/apps/docs/content/guides/platform/manage-your-usage/monthly-active-users-third-party.mdx
+++ b/apps/docs/content/guides/platform/manage-your-usage/monthly-active-users-third-party.mdx
@@ -118,3 +118,7 @@ You can view Monthly Active Third-Party Users usage on the [organization's usage
dark: '/docs/img/guides/platform/usage-mau-third-party--dark.png',
}}
/>
+
+## Exceeding Quotas
+
+<$Partial path="billing/exceeding_usage_quotas.mdx" />
diff --git a/apps/docs/content/guides/platform/manage-your-usage/monthly-active-users.mdx b/apps/docs/content/guides/platform/manage-your-usage/monthly-active-users.mdx
index d8688e1156f..b3701d261ac 100644
--- a/apps/docs/content/guides/platform/manage-your-usage/monthly-active-users.mdx
+++ b/apps/docs/content/guides/platform/manage-your-usage/monthly-active-users.mdx
@@ -124,3 +124,7 @@ In the Monthly Active Users section, you can see the usage for the selected time
dark: '/docs/img/guides/platform/usage-mau--dark.png',
}}
/>
+
+## Exceeding Quotas
+
+<$Partial path="billing/exceeding_usage_quotas.mdx" />
diff --git a/apps/docs/content/guides/platform/manage-your-usage/point-in-time-recovery.mdx b/apps/docs/content/guides/platform/manage-your-usage/point-in-time-recovery.mdx
index 3197dbe0454..3024d478ce2 100644
--- a/apps/docs/content/guides/platform/manage-your-usage/point-in-time-recovery.mdx
+++ b/apps/docs/content/guides/platform/manage-your-usage/point-in-time-recovery.mdx
@@ -7,6 +7,12 @@ title: 'Manage Point-in-Time Recovery usage'
You can configure [Point-in-Time Recovery (PITR)](/docs/guides/platform/backups#point-in-time-recovery) for a project by enabling the [PITR add-on](/dashboard/project/_/settings/addons?panel=pitr). You are charged for every enabled PITR add-on across your projects.
+<Admonition type="note">
+
+Point-In-Time Recovery add-on is **not** covered by the [Spend Cap](/docs/guides/platform/cost-control#spend-cap).
+
+</Admonition>
+
## How charges are calculated
PITR is charged by the hour, meaning you are charged for the exact number of hours that PITR is active for a project. If PITR is active for part of an hour, you are still charged for the full hour.
diff --git a/apps/docs/content/guides/platform/manage-your-usage/read-replicas.mdx b/apps/docs/content/guides/platform/manage-your-usage/read-replicas.mdx
index 55150031b8f..503f697ac01 100644
--- a/apps/docs/content/guides/platform/manage-your-usage/read-replicas.mdx
+++ b/apps/docs/content/guides/platform/manage-your-usage/read-replicas.mdx
@@ -7,6 +7,12 @@ title: 'Manage Read Replica usage'
Each [Read Replica](/docs/guides/platform/read-replicas) is a dedicated database. You are charged for its resources: [Compute](/docs/guides/platform/compute-and-disk#compute), [Disk Size](/docs/guides/platform/database-size#disk-size), provisioned [Disk IOPS](/docs/guides/platform/compute-and-disk#provisioned-disk-throughput-and-iops), provisioned [Disk Throughput](/docs/guides/platform/compute-and-disk#provisioned-disk-throughput-and-iops), and [IPv4](/docs/guides/platform/ipv4-address).
+<Admonition type="note">
+
+Read Replicas are **not** covered by the [Spend Cap](/docs/guides/platform/cost-control#spend-cap).
+
+</Admonition>
+
## How charges are calculated
Read Replica charges are the total of the charges listed below.
diff --git a/apps/docs/content/guides/platform/manage-your-usage/realtime-messages.mdx b/apps/docs/content/guides/platform/manage-your-usage/realtime-messages.mdx
index a5d64a1060d..ae8ca9eb218 100644
--- a/apps/docs/content/guides/platform/manage-your-usage/realtime-messages.mdx
+++ b/apps/docs/content/guides/platform/manage-your-usage/realtime-messages.mdx
@@ -87,3 +87,7 @@ In the Realtime Messages section, you can see the usage for the selected time pe
}}
zoomable
/>
+
+## Exceeding Quotas
+
+<$Partial path="billing/exceeding_usage_quotas.mdx" />
diff --git a/apps/docs/content/guides/platform/manage-your-usage/realtime-peak-connections.mdx b/apps/docs/content/guides/platform/manage-your-usage/realtime-peak-connections.mdx
index 5193aea15e0..58cc4b2edee 100644
--- a/apps/docs/content/guides/platform/manage-your-usage/realtime-peak-connections.mdx
+++ b/apps/docs/content/guides/platform/manage-your-usage/realtime-peak-connections.mdx
@@ -92,3 +92,7 @@ In the Realtime Peak Connections section, you can see the usage for the selected
}}
zoomable
/>
+
+## Exceeding Quotas
+
+<$Partial path="billing/exceeding_usage_quotas.mdx" />
diff --git a/apps/docs/content/guides/platform/manage-your-usage/storage-image-transformations.mdx b/apps/docs/content/guides/platform/manage-your-usage/storage-image-transformations.mdx
index d9fe127af3b..3b499bc3729 100644
--- a/apps/docs/content/guides/platform/manage-your-usage/storage-image-transformations.mdx
+++ b/apps/docs/content/guides/platform/manage-your-usage/storage-image-transformations.mdx
@@ -126,3 +126,7 @@ In the Storage Image Transformations section, you can see how many origin images
- Optimize original image sizes – upload images in an optimized format and resolution to reduce the need for excessive transformations
- Leverage [Smart CDN](/docs/guides/storage/cdn/smart-cdn) caching or any other caching solution to serve transformed images efficiently and avoid unnecessary repeated transformations
- Control how long assets are stored in the browser using the `Cache-Control` header
+
+## Exceeding Quotas
+
+<$Partial path="billing/exceeding_usage_quotas.mdx" />
diff --git a/apps/docs/content/guides/platform/manage-your-usage/storage-size.mdx b/apps/docs/content/guides/platform/manage-your-usage/storage-size.mdx
index c4f0202cc87..637304c4347 100644
--- a/apps/docs/content/guides/platform/manage-your-usage/storage-size.mdx
+++ b/apps/docs/content/guides/platform/manage-your-usage/storage-size.mdx
@@ -119,3 +119,7 @@ order by
- [Limit the upload size](/docs/guides/storage/production/scaling#limit-the-upload-size) for your buckets
- [Delete assets](/docs/guides/storage/management/delete-objects) that are no longer in use
+
+## Exceeding Quotas
+
+<$Partial path="billing/exceeding_usage_quotas.mdx" />