edits

apps/docs/content/guides/platform/billing-faq.mdx

@@ -77,9 +77,9 @@ Change your subscription plan in your [organization's billing settings](https://
 
 #### What happens if I cancel my subscription?
 
-The organization is given [credits](/docs/guides/platform/credits) for unused time on the subscription plan. The credits will not expire and can be used again in the future.
+The organization is given [credits](/docs/guides/platform/credits) for unused time on the subscription plan. The credits will not expire and can be used again in the future. You may see an additional charge for unbilled excessive usage charges from your previous billing cycle.
 
-Read more about [credits upon downgrade](/docs/guides/platform/manage-your-subscription#credits-upon-downgrade).
+Read more about [downgrades](/docs/guides/platform/manage-your-subscription#downgrade).
 
 #### I mistakenly upgraded the wrong organization and then downgraded it. Could you please issue a refund?
 
@@ -219,11 +219,3 @@ No, we do not provide refunds. Please refer to our [Terms of Service](https://su
 #### What do I do if my bill looks wrong?
 
 Take a moment to review our [Your monthly invoice](/docs/guides/platform/your-monthly-invoice) page, which may help clarify any questions about your invoice. If it still looks wrong, submit a [support ticket](https://supabase.help) through the dashboard. Select the affected organization and provide the invoice number for us to look at your case.
-
-### I downgraded to the Free Plan and still got charged. Why?
-
-When you downgrade from a Paid Plan to the Free Plan, you will get credits for the unused time on the Paid Plan. However, you will also be charged for any excessive usage in the billing cycle.
-
-The plan line item (i.e. Pro Plan) gets charged upfront, whereas all usage charges get charged in hindsight, as we only know your usage by the end of the billing cycle. Excessive usage is charged whenever a billing cycle resets, so either when your monthly cycle resets, or whenever you do a plan change.
-
-If you got charged after downgrading to the Free Plan, you had excessive usage in the previous billing cycle. You can check your invoices to see what exactly you were charged for.

apps/docs/content/guides/platform/compute-and-disk.mdx

@@ -36,7 +36,6 @@ In Pro organizations, Nano Compute are billed at the same price as Micro Compute
 
 Compute sizes can be changed by first selecting your project in the dashboard [here](https://supabase.com/dashboard/project/_/settings/compute-and-disk) and the upgrade process will [incur downtime](/docs/guides/platform/compute-and-disk#upgrade-downtime).
 
-
 <Image
   alt="Compute Size Selection"
   src={{

apps/docs/content/guides/platform/credits.mdx

@@ -21,7 +21,7 @@ You can find the credit balance on the [organization's billing page](https://sup
 **Subscription plan downgrades:** Upon subscription downgrade, any prepaid subscription fee will be credited back to your organization for unused time in the billing cycle.\
 As an example, if you start a Pro Plan subscription on January 1 and downgrade to the Free Plan on January 15, your organization will receive about 50% of the subscription fee as credits for the unused time between January 15 and January 31.
 
-**Credit top-ups:** For more information, see [Credit top-ups](/docs/guides/platform/credits#how-to-top-up-your-credits)
+**Credit top-ups:** You self-erved a credit top-up or have signed an upfront credits deal with our growth team.
 
 ## Credit top-ups
 You can top up credits at any time, with a maximum of $999 per top-up. These credits do not expire and are non-refundable.

apps/docs/content/guides/platform/manage-your-subscription.mdx

@@ -4,14 +4,18 @@ title: 'Manage your subscription'
 ---
 
 ## Manage your subscription plan
+
 To change your subscription plan
+
 1. On the [organization's billing page](https://supabase.com/dashboard/org/_/billing), go to section **Subscription Plan**
 2. Click **Change subscription plan**
 3. On the side panel, choose a subscription plan
 4. Follow the prompts
 
 ### Upgrade
+
 Upgrades take effect immediately. During the process, you are informed of the associated costs.
+
 <Image
   alt="Subscription upgrade modal"
   src={{
@@ -22,8 +26,12 @@ Upgrades take effect immediately. During the process, you are informed of the as
   zoomable
 />
 
+If you still have credits in your account, we will use the credits first before charging your card.
+
 ### Downgrade
+
 Downgrades take effect immediately. During the process, you are informed of the implications.
+
 <Image
   alt="Subscription downgrade modal"
   src={{
@@ -35,6 +43,7 @@ Downgrades take effect immediately. During the process, you are informed of the
 />
 
 #### Credits upon downgrade
+
 Upon subscription downgrade, any prepaid subscription fee will be credited back to your organization for unused time in the billing cycle. These credits do not expire and will be applied to future invoices.
 
 **Example:**
@@ -42,29 +51,42 @@ If you start a Pro Plan subscription on January 1 and downgrade to the Free Plan
 
 As stated in our [Terms of Service](https://supabase.com/terms#1-fees), we do not offer refunds to the payment method on file.
 
+#### Charges on downgrade
+
+When you downgrade from a Paid Plan to the Free Plan, you will get credits for the unused time on the Paid Plan. However, you will also be charged for any excessive usage in the billing cycle.
+
+The plan line item (i.e. Pro Plan) gets charged upfront, whereas all usage charges get charged in arrears, as we only know your usage by the end of the billing cycle. Excessive usage is charged whenever a billing cycle resets, so either when your monthly cycle resets, or whenever you do a plan change.
+
+If you got charged after downgrading to the Free Plan, you had excessive usage in the previous billing cycle. You can check your invoices to see what exactly you were charged for.
+
 ## Manage your payment methods
 
 You can add multiple payment methods, but only one can be active at a time.
 
 ### Add a payment method
+
 1. On the [organization's billing page](https://supabase.com/dashboard/org/_/billing), go to section **Payment Methods**
 2. Click **Add new card**
 3. Provide your credit card details
 4. Click **Add payment method**
 
 ### Delete a payment method
+
 1. On the [organization's billing page](https://supabase.com/dashboard/org/_/billing), go to section **Payment Methods**
 2. In the context menu of the payment method you want to delete, click **Delete card**
 3. Click **Confirm**
 
 ### Set a payment method as active
+
 1. On the [organization's billing page](https://supabase.com/dashboard/org/_/billing), go to section **Payment Methods**
 2. In the context menu of the payment method you want to delete, click **Use this card**
 3. Click **Confirm**
 
 ## Manage your billing details
+
 You can update your billing email address, billing address and tax ID on the [organization's billing page](https://supabase.com/dashboard/org/_/billing).
 
 <Admonition type="note">
-  Any changes made to your billing details will only be reflected in your upcoming invoices. Our payment provider cannot regenerate previous invoices.
+  Any changes made to your billing details will only be reflected in your upcoming invoices. Our
+  payment provider cannot regenerate previous invoices.
 </Admonition>

apps/docs/content/guides/platform/your-monthly-invoice.mdx

@@ -4,24 +4,31 @@ title: 'Your monthly invoice'
 ---
 
 ## Billing cycle
+
 When you sign up for a paid plan you get charged once a month at the beginning of the billing cycle. A billing cycle starts with the creation of a Supabase organization. If you create an organization on the sixth of January your billing cycle resets on the sixth of each month. If the anchored day is not present in the current month, then the last day of the month is used.
 
 ## Your invoice explained
+
 When your billing cycle resets an invoice gets issued. That invoice contains line items from both the current and the previous billing cycle. Fixed fees for the current billing cycle, usage based fees for the previous billing cycle.
 
 ### Fixed fees
+
 Fixed fees are independent of usage and paid in-advance. Whether you have one or several projects, hundreds or millions of active users, the fee is always the same, and doesn't vary. Examples are the subscription fee, the fee for HIPAA and for priority support.
 
 ### Usage based fees
+
 Fees vary depending on usage and are paid in arrears. The more usage you have, the higher the fee. Examples are fees for monthly active users and storage size.
 
 ### Discounted line items
+
 Paid plans come with a free quota for certain line items. You only pay for usage that goes beyond the quota. The quota for Storage for example is 100 GB. If you use 105 GB, you pay for 5 GB. If you use 95 GB, you pay nothing. This quota is declared as a discount on your invoice.
 
 #### Compute Credits
+
 Paid plans come with $10 in Compute Credits per month. This suffices for a single project using a Nano or Micro compute instance. Every additional project adds compute fees to your monthly invoice though.
 
 ### Example invoice
+
 The following invoice was issued on January 6, 2025 with the previous billing cycle from December 6, 2024 - January 5, 2025, and the current billing cycle from January 6 - February 5, 2025.
 
 <Image
@@ -33,14 +40,15 @@ The following invoice was issued on January 6, 2025 with the previous billing cy
   zoomable
 />
 
-1) The final amount due
-2) Fixed subscription fee for the current billing cycle
-3) Usage based fee for Compute for the previous billing cycle. There were two projects (wsmmedyqtlrvbcesxdew, wwxdpovgtfcmcnxwsaad) running 744 hours (24 hours * 31 days). These projects incurred $10 in Compute fees each. With $10 in Compute Credits deducted, the final Compute fees are $10.
-4) Usage based fee for Custom Domain for the previous billing cycle. There is no free usage quota for Custom Domain. You get charged for the 744 hours (24 hours * 31 days) a Custom Domain was active. The final Custom Domain fees are $10.19.
-5) Usage based fee for Egress for the previous billing cycle. There is a free usage quota of 250 GB for Egress. You get charged for usage beyond 250 GB only, meaning for 2,119.47 GB. The final Egress fees are $190.75.
-6) Usage based fee for Monthly Active Users for the previous billing cycle. There is a free usage quota of 100,000 users. With 141 users there is no charge for this line item.
+1. The final amount due
+2. Fixed subscription fee for the current billing cycle
+3. Usage based fee for Compute for the previous billing cycle. There were two projects (wsmmedyqtlrvbcesxdew, wwxdpovgtfcmcnxwsaad) running 744 hours (24 hours \* 31 days). These projects incurred $10 in Compute fees each. With $10 in Compute Credits deducted, the final Compute fees are $10.
+4. Usage based fee for Custom Domain for the previous billing cycle. There is no free usage quota for Custom Domain. You get charged for the 744 hours (24 hours \* 31 days) a Custom Domain was active. The final Custom Domain fees are $10.19.
+5. Usage based fee for Egress for the previous billing cycle. There is a free usage quota of 250 GB for Egress. You get charged for usage beyond 250 GB only, meaning for 2,119.47 GB. The final Egress fees are $190.75.
+6. Usage based fee for Monthly Active Users for the previous billing cycle. There is a free usage quota of 100,000 users. With 141 users there is no charge for this line item.
+
+### Why is my invoice more than $25?
 
-### Why is your invoice more than $25?
 The amount due of your invoice being higher than the $25 subscription fee for the Pro Plan can have several reasons.
 
 - **Running several projects:** You had more than one project running in the previous billing cycle. Supabase provides a dedicated server and database for every project. That means that every project you launch incurs compute costs. While the $10 Compute Credits cover a single project using a Nano or Micro compute instance, every additional project adds at least $10 compute costs to your invoice.
@@ -48,23 +56,16 @@ The amount due of your invoice being higher than the $25 subscription fee for th
 - **Usage that is not covered by the Spend Cap:** You had usage in the previous billing cycle that is not covered by the [Spend Cap](/docs/guides/platform/cost-control#spend-cap). For example using an IPv4 address or a custom domain.
 
 ## How to settle your invoices
+
 Monthly invoices are auto-collected by charging the payment method marked as "active" for an organization.
 
 ### Payment failure
+
 If your payment fails, Supabase retries the charge several times. We send you a Payment Failure email with the reason for the failure. Follow the steps outlined in this email. You can manually trigger a charge at any time via
+
 - the link in the Payment Failure email
 - the "Pay Now" button on the [organization's invoices page](https://supabase.com/dashboard/org/_/invoices)
 
-
 ## Where to find your invoices
+
 Your invoice is sent to you via email. You can also find your invoices on the [organization's invoices page](https://supabase.com/dashboard/org/_/invoices).
-
-
-
-
-
-
-
-
-
-