From 2986f603141d4e1edb3fe0884306e34fc6d5e24e Mon Sep 17 00:00:00 2001 From: Eric Seidel Date: Mon, 21 Sep 2026 21:05:35 -0700 Subject: [PATCH 1/2] docs: add Plans & Upgrading guide Adds account/plans.mdx describing how to upgrade from Free, move between Pro and Business, switch billing intervals, cancel, and reach sales for Enterprise, based on the console's current Plan page. Points the FAQ, Organizations, and Billing pages at it and retires the stale "Manage Plan -> Edit -> Cancel Subscription" instructions. --- src/content/docs/account/api-keys.mdx | 2 +- src/content/docs/account/api.mdx | 2 +- src/content/docs/account/billing.mdx | 5 +- src/content/docs/account/cli.mdx | 2 +- src/content/docs/account/delete-account.mdx | 2 +- src/content/docs/account/orgs.mdx | 5 +- src/content/docs/account/plans.mdx | 110 ++++++++++++++++++++ src/content/docs/code-push/faq.mdx | 16 +-- 8 files changed, 128 insertions(+), 16 deletions(-) create mode 100644 src/content/docs/account/plans.mdx diff --git a/src/content/docs/account/api-keys.mdx b/src/content/docs/account/api-keys.mdx index 9e82ea1d..91a6150b 100644 --- a/src/content/docs/account/api-keys.mdx +++ b/src/content/docs/account/api-keys.mdx @@ -2,7 +2,7 @@ title: API Keys description: Create and manage API keys for CI and programmatic access sidebar: - order: 3 + order: 4 --- import ArcadeEmbed from '~/components/ArcadeEmbed.astro'; diff --git a/src/content/docs/account/api.mdx b/src/content/docs/account/api.mdx index 50078ba6..86b279ca 100644 --- a/src/content/docs/account/api.mdx +++ b/src/content/docs/account/api.mdx @@ -2,7 +2,7 @@ title: API Reference description: Interact programmatically with the Code Push API sidebar: - order: 3 + order: 4 --- # API specification diff --git a/src/content/docs/account/billing.mdx b/src/content/docs/account/billing.mdx index c1807f60..c06b622d 100644 --- a/src/content/docs/account/billing.mdx +++ b/src/content/docs/account/billing.mdx @@ -2,7 +2,7 @@ title: Billing description: How Shorebird handles Billing sidebar: - order: 2 + order: 3 --- import { Image } from 'astro:assets'; @@ -53,7 +53,8 @@ it's an indie/hobby project or a globally launched enterprise application. See the [pricing page](https://shorebird.dev/pricing) for more information. Most customers can easily get started with the self-service Pro and Business -plans. If you need invoice billing, tax support, alternative payment methods, +plans; see [Plans & Upgrading](/account/plans/) for how to upgrade, switch, or +cancel. If you need invoice billing, tax support, alternative payment methods, custom contract/procurement process, or support for more than 2.5 million patches per month, please [reach out regarding an Enterprise Plan](https://shorebird.dev/talk-to-sales). diff --git a/src/content/docs/account/cli.mdx b/src/content/docs/account/cli.mdx index 65c5fcfe..b4d08e92 100644 --- a/src/content/docs/account/cli.mdx +++ b/src/content/docs/account/cli.mdx @@ -4,7 +4,7 @@ description: Learn how to authenticate and manage your Shorebird account via the command line sidebar: - order: 4 + order: 5 --- The Shorebird CLI provides several commands to help you manage your diff --git a/src/content/docs/account/delete-account.mdx b/src/content/docs/account/delete-account.mdx index 240c5f38..c0aa5bf7 100644 --- a/src/content/docs/account/delete-account.mdx +++ b/src/content/docs/account/delete-account.mdx @@ -2,7 +2,7 @@ title: Delete Account description: How to permanently delete your Shorebird account sidebar: - order: 3 + order: 4 --- ## Before you begin diff --git a/src/content/docs/account/orgs.mdx b/src/content/docs/account/orgs.mdx index c4146d43..f54e14d6 100644 --- a/src/content/docs/account/orgs.mdx +++ b/src/content/docs/account/orgs.mdx @@ -21,9 +21,8 @@ patches, and more. ## Account requirements Shorebird's paid plans unlock features for collaborating with your peers. -Shorebird's free plan users can upgrade to a paid plan to access these features -via the account settings page in the -[Shorebird console](https://console.shorebird.dev/account). +Shorebird's free plan users can upgrade to a paid plan to access these features. +See [Plans & Upgrading](/account/plans/) for how. If you do not see the plan you're expecting, please reach out to contact@shorebird.dev for help. diff --git a/src/content/docs/account/plans.mdx b/src/content/docs/account/plans.mdx new file mode 100644 index 00000000..a9d46af0 --- /dev/null +++ b/src/content/docs/account/plans.mdx @@ -0,0 +1,110 @@ +--- +title: Plans & Upgrading +description: How to upgrade, downgrade, switch, or cancel your Shorebird plan +sidebar: + order: 2 +--- + +Shorebird's Pro and Business plans are self-service. You can upgrade, downgrade, +switch between monthly and annual billing, and cancel from the +[Plan page](https://console.shorebird.dev/account/plan) in the Shorebird +Console. Enterprise plans are set up by the Shorebird team. + +See the [pricing page](https://shorebird.dev/pricing) for what each plan +includes. + +## Who can change the plan + +Plans belong to an **account**, not to an organization. Every organization you +own runs on your plan, and their patch installs count against it. + +This means only the [organization owner](/account/orgs#owner) can upgrade the +plan for an organization. If you're an Admin or Developer and your team needs a +bigger plan, ask the owner to upgrade. To see who owns an organization, open the +organization's settings in the console. + +## Upgrade from Free + +1. Go to [Account](https://console.shorebird.dev/account) in the Shorebird + Console and click **Manage Plan**. +2. Click **Upgrade plan**. +3. Pick **Monthly** or **Annual**, then click **Upgrade to Pro** or **Upgrade to + Business**. +4. Complete checkout in Stripe. + +Your new plan is active as soon as checkout completes, and your billing period +starts today. + +## Upgrade from Pro to Business + +1. Go to [Account](https://console.shorebird.dev/account) and click **Manage + Plan**. +2. Click **Change plan**. +3. Click **Upgrade to Business** on the billing interval you want. +4. Review the prorated amount due today and click **Confirm and pay**. + +Upgrades take effect immediately. You're charged a prorated amount for the rest +of the current billing period, and your plan renews as Business at the next +renewal date. + +## Switch between monthly and annual billing + +Open **Manage Plan** → **Change plan** and use the **Monthly** / **Annual** tabs +to pick the interval, then click **Switch to** your plan on that interval. + +- **Monthly to annual** takes effect immediately. You're charged the annual + price, less a prorated credit for the unused part of the current month. +- **Annual to monthly** is scheduled for the end of your current annual period. + Nothing is charged today. + +## Downgrade from Business to Pro + +Open **Manage Plan** → **Change plan** and click **Switch to Pro**. + +Downgrades are scheduled, not immediate: your current plan stays active through +the period you've already paid for, and it becomes Pro at the start of the next +period. Nothing is due today. Until then, the Plan page shows the scheduled +change with a **Keep current plan** button that cancels it. + +## Cancel your plan + +Open **Manage Plan** and click **Cancel plan**. + +Nothing changes today. Your plan runs to the end of the current billing period, +after which your account drops to the Free plan. Your apps and release history +stay on your account, and devices keep the last patch they received. See +[Will your app still work if you cancel?](/code-push/faq#will-your-app-still-work-if-you-cancel-your-shorebird-subscription) + +Until the period ends, the Plan page shows a **Resume plan** button if you +change your mind. + +## Enterprise + +Enterprise plans include SAML single sign-on, invoice billing, custom contracts, +and higher patch volumes. They aren't self-service: +[reach out to sales](https://shorebird.dev/talk-to-sales) and the Shorebird team +will set up your account. See [Enterprise](/enterprise/) for what's included. + +If you're already on an Enterprise or other negotiated plan, the Plan page +doesn't offer self-service changes. Contact your Shorebird representative or +[billing@shorebird.dev](mailto:billing@shorebird.dev) for changes. + +## Troubleshooting + +### I upgraded but my organization still shows the old plan + +Plans belong to the account that owns the organization. If you upgraded your own +account but someone else owns the organization, the organization is still on the +owner's plan. Either the owner upgrades, or ownership of the organization is +transferred to the account with the paid plan. + +### Change plan is disabled + +Plans can't be changed while a payment is past due. Update your payment method +from the **Payment** card on the Plan page to settle the balance, then try +again. + +### I need a plan that isn't listed + +If none of the self-service plans fit, or you need invoice billing or a custom +contract, [talk to sales](https://shorebird.dev/talk-to-sales). diff --git a/src/content/docs/code-push/faq.mdx b/src/content/docs/code-push/faq.mdx index 95cb124e..d5d20c5e 100644 --- a/src/content/docs/code-push/faq.mdx +++ b/src/content/docs/code-push/faq.mdx @@ -866,10 +866,11 @@ For more details on this, please refer to the ### How do you upgrade or downgrade your plan? -To upgrade your plan, you can -[subscribe via the Shorebird console](https://console.shorebird.dev/subscriptions/create). -If you would like to move from a monthly to a yearly plan, please reach out via -[email](mailto:billing@shorebird.dev) to complete the change. +From the [Plan page](https://console.shorebird.dev/account/plan) in the +Shorebird Console. Upgrades take effect immediately; downgrades are scheduled +for the end of your current billing period. See +[Plans & Upgrading](/account/plans/) for step-by-step instructions, including +switching between monthly and annual billing. ### When does your billing period reset? @@ -879,9 +880,10 @@ month, your billing period will reset on the 15th of every month. ### How do you cancel your subscription? -To cancel your subscription, you can view your -[account](https://console.shorebird.dev/account) and click "Manage Plan" -> -"Edit" -> "Cancel Subscription". +To cancel your subscription, open the +[Plan page](https://console.shorebird.dev/account/plan) in the Shorebird Console +and click "Cancel plan". See +[Plans & Upgrading](/account/plans/#cancel-your-plan) for details. You will continue to have all the features of a paid account until the end of your billing period. From d2a628cf159b2ce69174b1027ee336b247980263 Mon Sep 17 00:00:00 2001 From: Eric Seidel Date: Mon, 21 Sep 2026 21:09:40 -0700 Subject: [PATCH 2/2] docs: satisfy Vale on the plans page Plan names are proper nouns, so allow them in headings, and use link text for the billing address so the Terms rule does not read it as a lowercase Shorebird. --- .vale/styles/Shorebird/Headings.yml | 4 ++++ src/content/docs/account/plans.mdx | 2 +- 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/.vale/styles/Shorebird/Headings.yml b/.vale/styles/Shorebird/Headings.yml index 86e6057e..35cb9494 100644 --- a/.vale/styles/Shorebird/Headings.yml +++ b/.vale/styles/Shorebird/Headings.yml @@ -71,6 +71,10 @@ exceptions: - I've - I'll - Stripe + - Free + - Pro + - Business + - Enterprise - Fastfile - BuildContext - RenderObject diff --git a/src/content/docs/account/plans.mdx b/src/content/docs/account/plans.mdx index a9d46af0..a88463fd 100644 --- a/src/content/docs/account/plans.mdx +++ b/src/content/docs/account/plans.mdx @@ -87,7 +87,7 @@ will set up your account. See [Enterprise](/enterprise/) for what's included. If you're already on an Enterprise or other negotiated plan, the Plan page doesn't offer self-service changes. Contact your Shorebird representative or -[billing@shorebird.dev](mailto:billing@shorebird.dev) for changes. +[email billing](mailto:billing@shorebird.dev) for changes. ## Troubleshooting