Platform

Billing FAQ

This documentation covers frequently asked questions around subscription plans, payments, invoices and billing in general


Organizations and projects

What are organizations and projects?

The Supabase Platform has "organizations" and "projects". An organization may contain multiple projects. Each project is a dedicated Supabase instance with all of its sub-services including Storage, Auth, Functions and Realtime. Each organization only has a single subscription with a single Plan (Free, Pro, Team or Enterprise). Project addons such as Compute, IPv4, Log Drains, Advanced MFA, Custom Domains and PITR are configured per project and are added to your organization subscription. Read more on how billing is organized.

How many free projects can I have?

You are entitled to two active free projects. Paused projects do not count towards your quota. Note that within an organization, we count the free project limits from all members that are either Owner or Admin. If you’ve got another organization member with the Admin or Owner role that has already exhausted their free project quota, you won’t be able to launch another free project in that organization. You can create another Free Plan organization or change the role of the affected member in your organization’s team settings.

Can I mix free and paid projects in a single organization?

The subscription plan is set on the organization level and it is not possible to mix paid and non-paid projects inside a single organization. However, you can have a paid and a free organization and make use of the self-serve project transfers to organize your projects. All projects in an organization benefit from the subscription plan. If your organization is on the Pro Plan, all projects within the organization benefit from no project pausing, automated backups and so on.

Can I transfer my projects to another organization?

Yes, you can transfer your projects to another organization. You can find instructions on how to transfer your projects here.

Can I transfer my credits to another organization?

Yes, you can transfer the credits to another organization. Please submit a support ticket.

Pricing

See the Pricing page for details.

Are there any charges for paused projects?

No, we do not charge for paused projects. Compute hours are only counted for active instances. Paused projects do not incur any compute usage charges.

How are multiple projects billed under a paid organization?

We provide a dedicated server for every Supabase project. Each paid organization comes with $10 in Compute Credits to cover one project on the default compute size. Additional projects start at ~$10 a month (billed hourly). See how billing for compute works here.

Running 3 projects in a Pro Plan organization on the default micro instance:

  • $25 Pro Plan
  • $30 for 3 projects on the default compute size
  • $10 Compute credits ⇒ $45 / month

Refer to our docs on how billing works for more examples and insights.

How does compute billing work?

Each Supabase project is a dedicated VM and Postgres database. By default, your instance runs on the Micro compute instance. You have the option to upgrade your compute size in your Project settings. See Compute Add-ons for available options.

When you change your compute size, there are no immediate upfront charges. Instead, you will be billed based on the compute hours during your billing cycle reset.

If you launch additional instances on your paid plan, we will add the corresponding compute hours to your final invoice.

If you upgrade your project to a larger instance for 10 hours and then downgrade, you’ll only pay for the larger instance for the 10 hours of usage at the end of your billing cycle. You can see your current compute usage on your organization’s usage page.

Read more on how billing for compute works.

What is unified egress and how is it billed?

Unified egress refers to the total egress quota available to each organization. This quota can be utilized for various purposes such as Storage, Realtime, Auth, Functions, Supavisor, Log Drains and Database. Each plan includes a specific egress quota, and any additional usage beyond that quota is billed accordingly.

To learn more about unified egress and its details, please refer to the information provided here.

Plans and subscriptions

How do I change my subscription plan?

Change your subscription plan in your organization's billing settings. To upgrade to an Enterprise Plan, complete the Enterprise request form.

What happens if I cancel my subscription?

The organization is given credits for unused time on the subscription plan or addons. The credits will not expire and can be used again in the future.

I mistakenly upgraded the wrong organization and then downgraded it. Could you please issue a refund?

We can transfer the amount as credits to another organization of your choice. You can use these credits to upgrade the organization, or if you have already upgraded, the credits will be used to pay the next month's invoice. Please create a support ticket for this case.

Quotas and spend caps

What will happen when I exceed the Free Plan quota?

You will be notified when you exceed the Free Plan quota. It is important to take action at this point. If you continue to exceed the limits without reducing your usage, service restrictions will apply. To avoid service restrictions, you have two options: reduce your usage or upgrade to a paid plan. Learn more about restrictions in the Fair Use Policy section.

What will happen when I exceed the Pro Plan quota and have the spend cap on?

You will be notified when you exceed your Pro Plan quota. To unblock yourself, you can toggle off your spend cap in your organization’s billing settings to pay for over-usage beyond the Pro plans limits. If you continue to exceed the limits without reducing your usage or turning off the spend cap, restrictions will apply. Learn more about restrictions in the Fair Use Policy section.

How do I scale beyond the limits of my Pro Plan?

The Pro Plan has a spend cap enabled by default to keep costs under control. If you want to scale beyond the plan's included quota, switch off the spend cap to pay for additional usage beyond the plans included limits. You can toggle the spend cap in the organization's billing settings. Read more about the spend cap.

Fair Use Policy

What is the Fair Use Policy?

Our Fair Use Policy gives developers the freedom to build and experiment with Supabase, while protecting our infrastructure. Under the Fair Use policy, service restrictions may apply to your organization if:

  • You continually exceed the Free Plan quota
  • You continually exceed Pro Plan quota and have the spend cap enabled
  • You have overdue invoices
  • You have an expired credit card

You will receive a notification before Fair Use Policy restrictions are applied. However, in some cases, like suspected abuse of our services, restrictions may be applied without prior notice.

How is the Fair Use Policy applied?

The Fair Use Policy is applied through service restrictions. This could mean:

  • Pausing projects
  • Switching databases to read-only mode
  • Disabling new project launches/transfers
  • Responding with a 402 status code for all API requests

The Fair Use Policy is generally applied to all projects of the restricted organization.

How can I remove restrictions applied from the Fair Use Policy?

To remove restrictions, you will need to address the issue that caused the restriction. This could be reducing your usage, paying overdue invoices, updating your payment method, or any other issue that caused the restriction. Once the issue is resolved, the restriction will be lifted.

Restrictions due to usage limits are lifted with the next billing cycle as your quota refills at the beginning of each cycle. You can see when your current billing cycle ends on the billing page under "Billing Breakdown". If your organization is on the Free Plan, you can also lift restrictions immediately by upgrading to Pro.

Reports and invoices

Where do I find my invoices?

You can find all invoices from your organization on your organization’s invoices page.

Where can I see a breakdown of usage?

You can find the breakdown of your usage on your organization’s usage page.

Where can I check my credit balance?

You can check your Credit balance on the organization’s billing page. Credits will be used on future invoices before charging your payment method. If you have enough credits to cover an invoice, there is no charge at all.

Can I include the VAT number?

You can update your VAT number in the Tax ID section of your organization’s billing page.

Can I change the details of an existing invoice?

Any changes made to your billing details will only be reflected in your upcoming invoices. Our payment provider cannot regenerate previous invoices. Therefore, please make sure to update the billing details before the upcoming invoices are finalized.

Payments and billing cycle

What payment methods are available?

We accept credit card payments only. If you cannot pay via credit card, we do offer alternatives for larger upfront payments. Please create a support ticket in case you’re interested.

What credit card brands are supported?

Visa, Mastercard, American Express, Japan Credit Bureau (JCB), China UnionPay (CUP), Cartes Bancaires

What currency can I pay in?

All our invoices are issued in USD, but you can pay in any currency as long as your credit card provider allows charging in USD after conversion.

Can I change the payment method?

Yes, you will have to add the new payment method before being allowed to remove the old one. This can be done from your dashboard on the organization’s billing page.

When are payments taken?

Payments are taken at the beginning of each billing cycle. You will be charged once a month. You can see the current billing cycle and upcoming invoice in your organization's billing settings. The subscription plan, custom domain and PITR addons are charged upfront, whereas usage-charges, including compute, are charged in hindsight based on your usage.

Where can I change my billing details?

You can update your billing details on the organization’s billing page. Please note that any changes made to your billing details will only be reflected in your upcoming invoices. Our payment provider cannot regenerate previous invoices.

What happens if I am unable to make the payment?

When an invoice becomes overdue, we will pause your projects and downgrade your organization to the Free Plan. You will be able to restore your projects once you have paid all outstanding invoices.

Why am I overdue?

We were unable to charge your payment method. This likely means that the payment was not successfully processed with the credit card on your account profile. You can be overdue when

  • A card is expired
  • The bank declined the payment
  • You had insufficient funds
  • There was no card on record

Check your payment methods in your organization’s billing page to ensure there are no expired payment methods and the correct payment method is marked as default. If you are still facing issues, please raise a support ticket.

Payments are always in USD and may show up as coming from Singapore, given our payment entity is in Singapore. Make sure you allow payments from Singapore and in USD

Can I delay my payment?

No, you cannot delay your payment.

Can I get a refund of my unused credits?

No, we do not provide refunds. Please refer to our Terms of Service.

What do I do if my bill looks wrong?

Please submit a support ticket through the dashboard. Select the affected organization and provide the invoice number for us to look at your case.