Repository navigation
docs: Add a Plans and billing page for Serverpod Cloud #924
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Open
developerjamiu
wants to merge
3
commits into
main
Choose a base branch
from
docs/plans-and-billing
base: main
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
Changes from all commits
Commits
Show all changes
3 commits
Select commit
Hold shift + click to select a range
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,143 @@ | ||
| --- | ||
| sidebar_position: 12 | ||
| title: Plans and billing | ||
| description: Plans decide which features a Serverpod Cloud project can use, and the card and billing details on your account keep every project you own running. | ||
| --- | ||
|
|
||
| # Plans and billing | ||
|
|
||
| Your project's plan decides which features it can use, such as custom domains and database backups, and how far its server and database can grow. You pick a plan when you create a project, and you can change it later. Every project you own is billed to the card and billing details on your Serverpod Cloud account. | ||
|
|
||
| ## Choose a plan | ||
|
|
||
| Serverpod Cloud has two standard plans, Starter and Growth. Starter fits an app before launch or a side project. Growth fits production apps, and adds features Starter doesn't include, such as custom domains, database backups, future calls, and team members. The [pricing page](https://serverpod.dev/pricing) lists what each plan includes and costs. | ||
|
|
||
| For needs beyond Growth, Serverpod also offers an Enterprise plan, which you arrange with the Serverpod team. The pricing page lists what it includes. | ||
|
|
||
| To see which plan your project is on, open its **Settings** in the [Serverpod Cloud console](https://console.serverpod.dev). The **Plan** section shows the plan's name. From the terminal, run `serverpod cloud project show` in your project's directory and look at the `Plan` row. | ||
|
|
||
| ## Free trial | ||
|
|
||
| Your first Starter project includes a one-month free trial. You don't need a card or billing details until the trial ends. | ||
|
|
||
| Any other project, including every Growth project, needs a card and billing details when you create it. The **New project** page asks for whichever is missing. | ||
|
|
||
| To see when the trial ends, open the project's **Settings**. The **Plan** section shows the end date. Serverpod Cloud also emails you a reminder before it ends. | ||
|
|
||
| What happens when the trial ends depends on your account: | ||
|
|
||
| - **Billing is set up:** The project keeps running, and its monthly plan fee starts. | ||
| - **Billing isn't set up:** The project is [suspended](#why-is-my-project-suspended) right away. | ||
|
|
||
| To keep the project running, [set up billing](#set-up-billing) before the trial ends. Until you do, the console shows a **Set up billing** banner at the top. | ||
|
|
||
| ## Set up billing | ||
|
|
||
| Your account needs a card to pay for your projects and billing details for your invoices. Your billing details are your billing address, plus your company name if you're billed as a business. Without them, an invoice can't be issued, and the project is [suspended](#why-is-my-project-suspended). | ||
|
|
||
| You need both to: | ||
|
|
||
| - Keep a project running after its [free trial](#free-trial) | ||
| - [Change a project's plan](#change-your-projects-plan) | ||
| - Create a project without a free trial | ||
|
|
||
| Projects you were invited to are billed to their owner, so they don't need your card or billing details. | ||
|
|
||
| To set up billing: | ||
|
|
||
| 1. In the [Serverpod Cloud console](https://console.serverpod.dev), select the person icon in the top bar, then **Billing**. The **Set up billing** buttons open the same page. | ||
|
|
||
| <!-- screenshot: cloud-console/account-menu-billing.png. Owner: docs team. Last verified: 2026-11-16 against console.serverpod.dev. --> | ||
| <img src="/img/cloud-console/account-menu-billing.png" alt="The person icon at the right of the Serverpod Cloud console's top bar, with the account menu open below it, listing Billing, Account settings, Security, Theme, and Log out." width="337" /> | ||
|
|
||
| 2. Add your card under **Payment methods**. | ||
| 3. Fill in your billing address under **Billing info**. If you're billed as a business, select **Are you a business?** and add your company name. **VAT information** is optional. | ||
| 4. Under **Billing emails**, add anyone else who should get billing messages, such as trial reminders and failed payments. | ||
| 5. Select **Save**. Your billing info and billing emails are saved only when you do. | ||
|
|
||
| Once your account has a card and billing details, the **Set up billing** banner and buttons go away. | ||
|
|
||
| ## Change your project's plan | ||
|
|
||
| You can move a project between Starter and Growth in either direction. The move changes which features the project can use and which monthly fee it pays. | ||
|
|
||
| ### Before you start | ||
|
|
||
| Make sure: | ||
|
|
||
| - **You own the project:** Only the project's owner can change its plan. For anyone else, the **Upgrade plan** or **Edit plan** button is dimmed, and hovering it explains who can change the plan. | ||
| - **Billing is in order:** Your account has [billing details](#set-up-billing) and no overdue payment. | ||
|
|
||
| **Moving to Growth:** If the project is on its free trial, the move ends the trial. | ||
|
|
||
| **Moving to Starter:** First remove what Starter doesn't include: | ||
|
|
||
| - **Backups:** Turn off the backup schedule with `serverpod cloud db schedule unset`, then [delete every snapshot](/cloud/concepts/database-backups#delete-a-snapshot), including scheduled ones. | ||
| - **Custom domains:** [Detach them](/cloud/concepts/custom-domains#detach-a-custom-domain). | ||
| - **Team members:** Remove each one with `serverpod cloud project user revoke` followed by their email. | ||
| - **Storages:** [Delete storages](/cloud/concepts/storage#delete-a-storage) until two remain. Deleting a storage removes its files for good, so copy out anything you need first. | ||
|
|
||
| ### Change the plan | ||
|
|
||
| 1. In the [Serverpod Cloud console](https://console.serverpod.dev), open your project's **Settings**. On Starter, select **Upgrade plan** in the **Plan** section. On Growth, select **Edit plan**. | ||
| 2. Under **Project plan**, choose the plan. | ||
| 3. Review **Compute** and **Database**, because choosing a plan resets both to that plan's defaults, which are one small podlet (a running copy of your server) and the small database size. On Starter, the podlet scales to zero. On Growth, it keeps running. | ||
| 4. Select **Save**. If your account has no card, the button reads **Add card and upgrade**, and the console asks for the card first. | ||
|
|
||
| The change can take up to a minute to apply. The **Plan** section then shows the new plan's name. If the project has been deployed, your server restarts with the new plan's settings. | ||
|
|
||
| If the console says "We couldn't confirm your plan change", refresh the page. If the **Plan** section still shows the old plan, check each point under [Before you start](#before-you-start). If you're moving to Starter, also check the **Moving to Starter** list. | ||
|
|
||
| ## View your invoices | ||
|
|
||
| Your invoices are kept in your billing portal, a separate page that opens in a new tab. To open it, go to the [Billing page](https://console.serverpod.dev/account/billing) of the Serverpod Cloud console and select **View invoices**. | ||
|
|
||
| ## Stop charges | ||
|
|
||
| A project's charges stop when you delete it, because deleting ends its plan right away. Moving the project to Starter doesn't stop them, since Starter has a monthly fee too. Fees are billed after the period they cover, so a last invoice still arrives for the time before the deletion. | ||
|
|
||
| Deleting a project removes its server, database, and stored files. It can't be undone, and the project ID can't be used again. | ||
|
|
||
| To delete a project, including a suspended one, open its **Settings** in the console and select **Delete project**. From the terminal, run `project delete` with the project ID: | ||
|
|
||
| ```bash | ||
| serverpod cloud project delete my-app | ||
| ``` | ||
|
|
||
| ## Troubleshooting | ||
|
|
||
| ### What happens if a payment fails? | ||
|
|
||
| Serverpod Cloud charges your card for each invoice. When a payment fails, what happens next depends on the invoice: | ||
|
|
||
| - **The first invoice on a project's plan:** The project is suspended right away. This includes the first invoice after you change the project's plan, or after you switch your account between business and individual on **Billing**. | ||
| - **Later invoices:** You have 10 days to pay, counted from the day the payment first fails. Your billing emails get a message with the date the project will be suspended. | ||
|
|
||
| While a payment is overdue, the console shows **Payment overdue** at the top of every page. You can't create projects, add resources such as storages, or change a project's plan until it's paid. To pay, select **Manage billing** in that banner, then pay the overdue invoice in your billing portal. | ||
|
|
||
| ### Why is my project suspended? | ||
|
|
||
| A suspended project's server stops, and you can't deploy to it until it's reactivated. When a project is suspended for payment or billing setup, your billing emails get a message, and they get another when it's reactivated. | ||
|
|
||
| The project's page shows **Project suspended** with the reason and a button, and the project list marks it **Suspended**. From the terminal, `serverpod cloud project show` prints the reason in its `Status` row. | ||
|
|
||
| What to do depends on the button on the project's page: | ||
|
|
||
| <div className="full-width-table"> | ||
|
|
||
| | Button | Why the project is suspended | To reactivate it | | ||
| | -------------------------- | ------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------- | | ||
| | **Pay invoices** | A payment is overdue | Select **Pay invoices** and pay the overdue invoices in your billing portal | | ||
| | **Complete billing setup** | Your account was missing a card or billing details when the free trial ended, or billing details when an invoice was due | [Set up billing](#set-up-billing) | | ||
| | **Manage plan** | The project's plan ended | Select **Manage plan**, then choose a plan on the project's **Settings** | | ||
| | **Contact support** | Serverpod Cloud support suspended it | Contact support from the **Need help?** menu in the console's top bar | | ||
|
|
||
| </div> | ||
|
|
||
| After you pay, complete billing setup, or choose a plan, the project is reactivated, and its server starts again with its last deployment. | ||
|
|
||
| ## Related | ||
|
|
||
| - [Scale to zero](/cloud/concepts/scale-to-zero): why Starter projects scale to zero when idle, and how to turn it on or off on Growth. | ||
| - [Database backups](/cloud/concepts/database-backups): the backups that Growth includes. | ||
| - [Storage](/cloud/concepts/storage): the storages each plan includes and their limits. | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Comment: I'm not sure if this is true @christerswahn @vfiruz97 are we using the billing email or the owner email when sending notifications like this, probably should send them to the billing emails too actually.