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/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..a88463fd --- /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 +[email billing](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.