code · pull · Jan 14, 2026 · Jan 14, 2026 · Jan 14, 2026 · Jan 14, 2026
diff --git a/apps/docs/content/_partials/billing/exceeding_usage_quotas.mdx 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/auth/oauth-server/getting-started.mdx b/apps/docs/content/guides/auth/oauth-server/getting-started.mdx
@@ -200,7 +200,7 @@ export default async function ConsentPage({
 }: {
   searchParams: { authorization_id?: string }
 }) {
-  const authorizationId = searchParams.authorization_id
+  const authorizationId = (await searchParams).authorization_id
 
   if (!authorizationId) {
     return <div>Error: Missing authorization_id</div>

diff --git a/apps/docs/content/guides/deployment/database-migrations.mdx b/apps/docs/content/guides/deployment/database-migrations.mdx
@@ -15,6 +15,12 @@ For this guide, we'll create a table called `employees` and see how we can make
 
 You will need to [install](/docs/guides/local-development#quickstart) the Supabase CLI and start the local development stack.
 
+<Admonition type="tip">
+
+If a lock timeout error occurs, in your migration file, consider increasing your [`lock_timeout`](https://postgresqlco.nf/doc/en/param/lock_timeout/) setting.
+
+</Admonition>
+
 <StepHikeCompact>
 
   <StepHikeCompact.Step step={1}>

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
@@ -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>
@@ -71,3 +77,19 @@ All projects have MFA Phone activated throughout the entire billing cycle.
 | **Subtotal**                  |       | **<Price price="150" />** |
 | Compute Credits               |       | -<Price price="10" />     |
 | **Total**                     |       | **<Price price="140" />** |
+
+### Add-on disabled after a day
+
+Project add-ons are billed in arrears based on how many hours you used them.
+If you remove the MFA Phone add-on, you are no longer billed from the time of removal onward.
+
+| Line Item                     | Hours | Costs                       |
+| ----------------------------- | ----- | --------------------------- |
+| Pro Plan                      | -     | <Price price="25" />        |
+|                               |       |                             |
+| Compute Hours Micro Project 1 | 744   | <Price price="10" />        |
+| MFA Phone Hours Project 1     | 24    | <Price price="2.46" />      |
+|                               |       |                             |
+| **Subtotal**                  |       | **<Price price="37.46" />** |
+| Compute Credits               |       | -<Price price="10" />       |
+| **Total**                     |       | **<Price price="27.46" />** |
diff --git 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
@@ -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
 
@@ -104,6 +108,22 @@ The project's Compute size changes throughout the billing cycle.
 | Compute Credits               |       | -<Price price="10" />    |
 | **Total**                     |       | **<Price price="29" />** |
 
+### Projects not running for full month
+
+One project is running for the entire month, two other projects were launched and deleted within a few days.
+We only bill for the hours while the project was running and billing stops once a project is deleted.
+Compute is always billed in arrears when your billing cycle resets.
+
+| Line Item                     | Hours | Costs                       |
+| ----------------------------- | ----- | --------------------------- |
+| Pro Plan                      | -     | <Price price="25" />        |
+| Compute Hours Micro Project 1 | 744   | <Price price="10" />        |
+| Compute Hours Micro Project 2 | 20    | <Price price="0.27" />      |
+| Compute Hours Micro Project 3 | 70    | <Price price="0.94" />      |
+| **Subtotal**                  |       | **<Price price="36.21" />** |
+| Compute Credits               |       | -<Price price="10" />       |
+| **Total**                     |       | **<Price price="26.21" />** |
+
 ## View usage
 
 You can view Compute usage on the [organization's usage page](/dashboard/org/_/usage). The page shows the usage of all projects by default. To view the usage for a specific project, select it from the dropdown. You can also select a different time period.

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
@@ -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.
@@ -63,6 +69,22 @@ All projects have a custom domain activated throughout the entire billing cycle.
 | Compute Credits               |       | -<Price price="10" />    |
 | **Total**                     |       | **<Price price="55" />** |
 
+### Add-on disabled after a day
+
+Project add-ons are billed in arrears based on how many hours you used them.
+If you remove the custom domain add-on, you are no longer billed from the time of removal onward.
+
+| Line Item                     | Hours | Costs                       |
+| ----------------------------- | ----- | --------------------------- |
+| Pro Plan                      | -     | <Price price="25" />        |
+|                               |       |                             |
+| Compute Hours Micro Project 1 | 744   | <Price price="10" />        |
+| Custom Domain Hours Project 1 | 24    | <Price price="0.33" />      |
+|                               |       |                             |
+| **Subtotal**                  |       | **<Price price="35.33" />** |
+| Compute Credits               |       | -<Price price="10" />       |
+| **Total**                     |       | **<Price price="25.33" />** |
+
 ## Optimize usage
 
 - Regularly check your projects and remove custom domains that are no longer needed

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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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>
@@ -93,6 +99,22 @@ The project has two Read Replicas and the IPv4 add-on enabled throughout the ent
 | Compute Credits               |       | -<Price price="10" />    |
 | **Total**                     |       | **<Price price="72" />** |
 
+### Add-on disabled after a day
+
+Project add-ons are billed in arrears based on how many hours you used them.
+If you remove the IPv4 add-on, you are no longer billed from the time of removal onward.
+
+| Line Item                     | Hours | Costs                       |
+| ----------------------------- | ----- | --------------------------- |
+| Pro Plan                      | -     | <Price price="25" />        |
+|                               |       |                             |
+| Compute Hours Micro Project 1 | 744   | <Price price="10" />        |
+| IPv4 Hours Project 1          | 24    | <Price price="0.13" />      |
+|                               |       |                             |
+| **Subtotal**                  |       | **<Price price="35.13" />** |
+| Compute Credits               |       | -<Price price="10" />       |
+| **Total**                     |       | **<Price price="25.13" />** |
+
 ## Optimize usage
 
 To see whether your database actually needs a dedicated IPv4 address, refer to [When you need the IPv4 add-on](/docs/guides/platform/ipv4-address#when-you-need-the-ipv4-add-on).
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
@@ -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
@@ -77,6 +83,25 @@ The project has two log drains configured throughout the entire billing cycle wi
 | Compute Credits               |                    | -<Price price="10" />        |
 | **Total**                     |                    | **<Price price="720.14" />** |
 
+### Add-on disabled after a day
+
+Project add-ons are billed in arrears based on how many hours you used them.
+If you remove the log drain add-on, you are no longer billed from the time of removal onward.
+
+| Line Item                     | Hours    | Costs                       |
+| ----------------------------- | -------- | --------------------------- |
+| Pro Plan                      | -        | <Price price="25" />        |
+|                               |          |                             |
+| Compute Hours Micro Project 1 | 744      | <Price price="10" />        |
+|                               |          |                             |
+| Log Drain Hours Drain 1       | 24       | <Price price="1.97" />      |
+| Log Drain Events Drain 1      | 0 events | <Price price="0" />         |
+| Egress Drain 1                | 0 GB     | <Price price="0" />         |
+|                               |          |                             |
+| **Subtotal**                  |          | **<Price price="36.97" />** |
+| Compute Credits               |          | -<Price price="10" />       |
+| **Total**                     |          | **<Price price="26.97" />** |
+
 ## View usage
 
 You can view Log Drain Events usage on the [organization's usage page](/dashboard/org/_/usage). The page shows the usage of all projects by default. To view the usage for a specific project, select it from the dropdown. You can also select a different time period.

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
@@ -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/.../content/guides/platform/manage-your-usage/monthly-active-users-third-party.mdx b/.../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
@@ -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
@@ -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.
@@ -40,7 +46,7 @@ The project has PITR with a recovery retention period of 7 days activated throug
 | ----------------------------- | ----- | ------------------------- |
 | Pro Plan                      | -     | <Price price="25" />      |
 | Compute Hours Small Project 1 | 744   | <Price price="15" />      |
-| PITR Hours                    | 744   | <Price price="100" />     |
+| 7-day PITR Hours Project 1    | 744   | <Price price="100" />     |
 | **Subtotal**                  |       | **<Price price="140" />** |
 | Compute Credits               |       | -<Price price="10" />     |
 | **Total**                     |       | **<Price price="130" />** |
@@ -54,15 +60,31 @@ All projects have PITR with a recovery retention period of 14 days activated thr
 | Pro Plan                      | -     | <Price price="25" />      |
 |                               |       |                           |
 | Compute Hours Small Project 1 | 744   | <Price price="15" />      |
-| PITR Hours Project 1          | 744   | <Price price="200" />     |
+| 14-day PITR Hours Project 1   | 744   | <Price price="200" />     |
 |                               |       |                           |
 | Compute Hours Small Project 2 | 744   | <Price price="15" />      |
-| PITR Hours Project 2          | 744   | <Price price="200" />     |
+| 14-day PITR Hours Project 2   | 744   | <Price price="200" />     |
 |                               |       |                           |
 | **Subtotal**                  |       | **<Price price="455" />** |
 | Compute Credits               |       | -<Price price="10" />     |
 | **Total**                     |       | **<Price price="445" />** |
 
+### Add-on disabled after a day
+
+Project add-ons are billed in arrears based on how many hours you used them.
+If you remove the PITR add-on, you are no longer billed from the time of removal onward.
+
+| Line Item                     | Hours | Costs                       |
+| ----------------------------- | ----- | --------------------------- |
+| Pro Plan                      | -     | <Price price="25" />        |
+|                               |       |                             |
+| Compute Hours Micro Project 1 | 744   | <Price price="10" />        |
+| 7-day PITR Hours Project 1    | 24    | <Price price="3.23" />      |
+|                               |       |                             |
+| **Subtotal**                  |       | **<Price price="38.23" />** |
+| Compute Credits               |       | -<Price price="10" />       |
+| **Total**                     |       | **<Price price="28.23" />** |
+
 ## Optimize usage
 
 - Review your [backup frequency](/docs/guides/platform/backups#frequency-of-backups) needs to determine whether you require PITR or free Daily Backups are sufficient

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
@@ -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
@@ -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
@@ -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" />
Original file line number	Diff line number	Diff line change
		@@ -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).