From adb2c2f39f0cdd5ff681a4b0c0218d3e9a7112c1 Mon Sep 17 00:00:00 2001 From: danciaclara Date: Fri, 13 Mar 2026 14:59:05 +0530 Subject: [PATCH 1/8] Updated Billing and plans page --- .../workspaces-and-users/billing-and-plans.md | 216 +++++++++++++++--- 1 file changed, 184 insertions(+), 32 deletions(-) diff --git a/docs/workspaces-and-users/billing-and-plans.md b/docs/workspaces-and-users/billing-and-plans.md index 448bc6a5..24036a2b 100644 --- a/docs/workspaces-and-users/billing-and-plans.md +++ b/docs/workspaces-and-users/billing-and-plans.md @@ -1,68 +1,220 @@ --- title: How billing works toc_max_heading_level: 4 -description: Learn how Plane's per-seat billing works, how to manage seats for admins and members and upgrade workspaces. +description: Learn how Plane's per-seat billing works, and how billing cycles, upgrades, and payments are handled. --- # How billing works -Unlike a majority of SaaS, our subscription models on Pro and higher plans are per-seat, not per-users. Learn why this model works great for you and how to manage your members versus seats. +Plane uses a per-seat billing model for paid plans. This means you pay for the number of seats in your workspace, not the total number of users. Understanding this distinction helps you manage costs effectively while giving flexibility to your team structure. -## Per-seat model and billing +## Why per-seat instead of per-user? -- You are billed per workspace you upgrade. On both Cloud and self-hosted Plane you can upgrade your workspace from **Billing and plans**. On self-hosted instances, your license key only unlocks one workspace. +Most SaaS tools charge per user. Every person who accesses the system counts toward your bill. Plane takes a different approach. - ![Billings and plans](https://media.docs.plane.so/activate-license/billing-and-plans-cloud.webp#hero) +**The per-seat model separates billing from user roles.** You purchase seats for users who need full access (Admins and Members), while users who need limited access (Guests) don't consume paid seats. This reflects how teams actually work: not everyone needs the same level of access. -- You are billed by the total number of seats in a workspace. So, if you have 100 Admins and Members across projects in a workspace, you will be billed for 100 seats. -- You get 5 Guests per paid seat. -- In the upgrade flow, you get as many seats as paid users—Admins or Members already in your workspace. For self-hosted instances, if you upgrade through the Prime portal, you can specify the number of seats you would like to purchase. You can also change this number later from the **Members** screen in **Workspace settings**. +For example, a typical workspace might have: +- 20 Admins and Members (core team) = 20 paid seats +- 100 Guests (stakeholders, clients, contractors) = 0 additional cost - ![Add seats](https://media.docs.plane.so/activate-license/add-seats.webp#hero) +With per-seat pricing, you pay for 20 seats and get 5 Guest slots per paid seat (100 total Guest slots). -- When you want to add members or change non-paid roles—Guests—to paid ones—Admins or Members—, you must add seats first. All new seats are immediately charged to the card on file. Depending on when you are adding more seats, your bill will either be prorated or show the full price of those seats. - ::: warning - If we don't have your card on file, you will have to reach out to us each time you want to increase the number of seats or get your bill adjusted to a lower number of seats. - ::: +This model becomes more cost-effective as your Guest population grows. -- When you remove members, their seats are freed up and go to the available pool so you can assign them to other users. - **Removing members doesn't automatically remove seats. You must remove seats separately to affect your billing.** See [Manage paid users](/workspaces-and-users/add-remove-seats) for more details. -- When you remove seats, the reduced billing for those seats is added as a credit line item to your next bill, so your overall bill is reduced by the price of the removed seats. +## How seat-based billing works -- Unless you change the number of seats in a month or year depending on your billing cycle, your subscription price for that cycle doesn't change. _The exception to that are limited-period discounts that some upgrades enjoy._ +### Workspace-level billing -- Your subscription renews automatically each month or year at the beginning of the billing cycle. +Billing happens per workspace, not per organization. If you have multiple workspaces, each requires its own subscription. On self-hosted instances, each license key unlocks one workspace. -### Free tiers, cancelations, and downgrades +When you upgrade a workspace from **Workspace Settings > Billing and plans**, you're charged for all paid seats in that workspace, regardless of how those seats are distributed across projects within the workspace. -Starting with v1.3.0 of the Commercial Edition, the Free plan will have a 12-seat limit just as there is for the Free tier on Cloud. If you are getting a new Free workspace on either our Cloud or our self-hosted Commercial Edition, this is the seat limit you will start with. +### Seat allocation and usage -#### Older workspaces +**Seats are workspace resources that you assign to users.** When you upgrade, you purchase a specific number of seats. Those seats form a pool that you allocate to Admins and Members. -For everyone on the Free tier on both Cloud and the Commercial Edition before this change came in, you will see your workspace grandfathered to the same number of seats as the total number of admins or members in your workspace at the time of this change. +For example: +- You upgrade with 50 seats. +- You assign 45 seats to current Admins and Members. +- 5 seats remain available for future. -Say, you had 20 members and admins on your workspace before this change. Now, you will see a limit of 20 seats in your workspace instead of 12 and they will work exactly as detailed above. If you want to upgrade this workspace to Pro, you will be charged for all 20 seats. If you remove one of your 20 grandfathered seats, your new limit will be 19. +**The initial seat count matches your current team size.** When upgrading through Plane's interface, you automatically get as many seats as the number of Admins and Members currently in your workspace. On self-hosted instances upgrading through the Prime portal, you specify the seat count yourself. -You can remove seats down to 12 on such accounts. At 12, your workspace will downgrade to a standard Free account and you will lose your grandfathered status. +![Add seats](https://media.docs.plane.so/activate-license/add-seats.webp#hero) -#### All workspaces +### Guest allocation -If you have upgraded to a Pro or higher subscription and have unpaid bills, you will get a 30-day notice to pay them. After that period, your workspace will lock out all members except Workspace Admin to help them clear unpaid dues. +Every paid seat includes 5 Guest slots. These Guest slots are pooled at the workspace level, just like seats. If you have 20 paid seats, you get 100 Guest slots total (20 × 5). -Once you have paid your bills, you can continue with your subscription, change its frequency, adjust the number of seats, or downgrade to the Free tier by manually removing seats down to 12. +## Managing seats over time -Should you cancel your subscription outright, your workspace will retain your subscription until the end of the billing cycle and then lock out all members except Workspace Admins who can renew the subscription or downgrade to the Free tier. +### Adding seats -#### Refunds +**You must add seats before adding new paid users.** If all your seats are assigned and you want to add another Admin or Member, you first [purchase additional seats](/workspaces-and-users/add-remove-seats#add-seats) from **Workspace Settings > Members > Manage seats**. -We don’t offer refunds except in the most unusual circumstances. Your Plane billing happens automatically and our payment partners send alerts before each bill is attempted to be paid. +New seats are charged immediately to your card on file. The charge is either prorated (if you're mid-cycle) or at full price (if you're at the start of a cycle). -Should you think you have an exceptional circumstance and deserve a refund, write to us. +**Prorating works proportionally.** If you add 10 seats halfway through a monthly billing cycle, you're charged for 10 seats × 15 days (roughly half the monthly price). Those seats then renew at full price in your next billing cycle. -## AI credits and usage +:::warning +If you don't have a payment method on file, you must contact [Plane support](/support/get-help) to adjust your seat count. The system can't automatically charge for new seats without payment information. +::: + +### Removing seats + +**Removing members doesn't reduce your bill.** When you remove a user from your workspace, their seat becomes available in the pool. You can reassign it to someone else. Your seat count and billing remain unchanged. + +To actually reduce your billing, you must explicitly [remove seats](/workspaces-and-users/add-remove-seats#remove-unused-seats) from **Workspace Settings > Members > Manage seats**. This action removes any seats that aren't currently assigned to users. + +When you remove seats, the cost reduction is applied as a credit on your next invoice. This credit is prorated based on how much of the billing cycle remains. + +For example, if you remove 10 seats halfway through your monthly cycle, you receive a credit for 10 seats × 15 days (roughly half the monthly cost). + +### The seats-versus-members distinction + +This distinction causes confusion, so it's worth emphasizing: + +**Seats are billing units.** They represent capacity, the maximum number of paid users you can have. + +**Members are people.** They're the actual users assigned to your workspace. + +Actions on members (adding, removing, changing roles) don't automatically affect your seat count or billing. Actions on seats (purchasing, removing) directly affect your billing. + +## Subscription lifecycle + +### Automatic renewals + +Subscriptions renew automatically at the start of each billing cycle (monthly or annual, depending on what you selected). The renewal charge is processed through your payment method on file. + +Stripe, Plane's payment processor, handles the renewal: +1. An invoice is generated at the renewal date. +2. The charge is attempted on your payment method. +3. If successful, your subscription continues. +4. If unsuccessful, Stripe retries the payment 3-5 times over 14 days. +5. After 14 days of failed attempts, the subscription is automatically cancelled. + +You receive email alerts before each billing attempt and after failed payments. + +### Mid-cycle changes + +**Billing frequency changes** (monthly to annual, or vice versa) take effect at your next billing cycle. You can request this change from **Workspace Settings > Billing and plans > Manage Subscription**. + +On Cloud, the change happens automatically. On self-hosted instances, you accept the change in the Stripe portal, then return to Plane and click [Sync plan](/workspaces-and-users/manage-licenses#sync-plan) from Workspace Settings to apply the changes locally. + +**Plan upgrades** happen immediately: +- On Cloud: Accept the change from **Manage Subscription**. Any additional cost is prorated and charged immediately. If the new plan costs less, the difference is credited to your next invoice. +- On self-hosted: Currently requires purchasing a new license and activating it. This process will be simplified in future releases. + +**Plan downgrades** to the Free tier cancel your subscription at the end of the current billing cycle. Your workspace continues with paid features until that date. + +### Price stability + +Your subscription price doesn't change mid-cycle unless you add or remove seats. Monthly subscriptions renew at the same price each month. Annual subscriptions remain constant for the full year. + +The exception: limited-period discounts that some workspaces receive during promotional periods. These discounts expire according to their specific terms. + +## Free plan and trial access + +### Free trial for new workspaces + +When you create a new Plane workspace, you automatically start a 14-day free trial of the Business plan. This gives you full access to premium features without requiring payment information. + +The trial includes: +- All Business plan features +- Full seat capacity for your team +- AI credits for Plane AI features +- No payment method required + +After 14 days, your workspace automatically reverts to the Free plan if you haven't upgraded to a paid subscription. + +### Free plan seat limits + +The Free plan supports up to 12 seats. This applies to both Cloud and self-hosted Commercial Edition workspaces. + +**Grandfathered workspaces** +Workspaces on the Free tier before v1.3.0 on the Commercial Edition were grandfathered at their current seat count. If you had 20 Admins and Members when the limit was introduced, your Free workspace retains 20 seats. + +Grandfathered workspaces keep their higher seat count until you manually remove seats. Once you drop to 12 seats, you lose grandfathered status and cannot add seats without upgrading. +If you upgrade a grandfathered workspace to a paid plan, you're charged for all grandfathered seats. A workspace with 20 grandfathered seats would be billed for 20 seats on a Pro or Business plan. + +## AI credits and usage Plane AI uses a separate credit-based system for AI features. Credits measure the computational work required for AI tasks, from quick queries to bulk automations. Each plan includes monthly AI credits per seat that pool at the workspace level. AI credits are separate from your seat-based subscription. You can run out of AI credits without affecting your paid seats, and vice versa. Learn more about [how AI credits work](/ai/plane-ai-credits) including consumption rates, rollover policies, and top-up options. + +## Payment and invoicing + +### Payment methods + +Plane requires a payment method on file for all paid subscriptions created through the standard upgrade flow. Stripe (our payment processor) doesn't allow removing all payment methods once a subscription is active. + +You can update your payment method anytime from **Workspace Settings > Billing and plans > Manage Subscription**. + +### Download invoice + +All invoices are available from **Workspace Settings > Billing and plans > Manage Subscription**. You can view and download past invoices for accounting purposes. + +### Failed payments + +When a payment fails, Stripe attempts to collect payment 3-5 times over 14 days. You receive email notifications after each failed attempt. + +If all payment attempts fail: +- Cloud workspaces: Subscription cancels after 14 days +- Self-hosted workspaces: Subscription cancels 7 days after the failed payment cycle + +## Unpaid bills + +If you have an active subscription with unpaid invoices, you receive a 30-day notice to clear the balance. After 30 days, your workspace enters a restricted state: + +- All members except Workspace Admins are locked out. +- Workspace Admins can access **Workspace Settings > Billing and plans**. +- No project work is accessible until bills are paid. + +Once you pay outstanding invoices, full workspace access is restored immediately. + +## Subscription cancellations + +When you cancel your subscription from **Manage Subscription**, the cancellation takes effect at the end of your current billing cycle. Your workspace retains all paid features until that date. + +After the billing cycle ends: +- Cloud workspaces: Immediate return to Free plan +- Self-hosted workspaces: Return to Free plan after 7-day grace period + +### Post-cancellation behavior + +If your workspace exceeds the Free plan's 12-seat limit when your subscription ends, the workspace enters a locked state: + +- Only the **Members** page is accessible +- Workspace Admins can remove users to get below 12 seats +- Alternatively, Workspace Admins can reactivate a paid subscription + +You must either reduce your team to 12 seats or renew your subscription to regain full access. + +## Cloud versus self-hosted billing differences + +Most billing mechanics work identically across Cloud and self-hosted instances, with a few key differences: + +**License activation** +Self-hosted instances require [license key activation](/workspaces-and-users/manage-licenses#activate-license). Each license key unlocks one workspace on one instance. Cloud workspaces activate directly through the Stripe integration. + +**Plan changes** +Cloud workspaces handle plan changes (upgrades, frequency changes) automatically. Self-hosted instances require using [Sync plan](/workspaces-and-users/manage-licenses#sync-plan) from Workspace Settings after accepting changes in the Stripe portal. + +**License portability** +Self-hosted license keys are tied to both a workspace and a machine. If you switch servers or workspaces, you must [delink your license key](https://docs.plane.so/workspaces-and-users/manage-licenses#delink-license-key) from the old workspace before reactivating it elsewhere. + +## Refund policy + +Plane doesn't offer refunds except in exceptional circumstances. Billing happens automatically with advance email notifications before each charge. + +If you believe you have an exceptional case warranting a refund, contact [Plane support](https://docs.plane.so/support/get-help) with details about your situation. + +## See also + +- [Upgrade to a paid plan](/workspaces-and-users/upgrade-plan) +- [Add or remove seats](/workspaces-and-users/add-remove-seats) +- [Manage licenses for self-hosted](/workspaces-and-users/manage-licenses)
 \ No newline at end of file From 241e673d64aa32176db35528df9698acd1d621c6 Mon Sep 17 00:00:00 2001 From: danciaclara Date: Thu, 19 Mar 2026 02:29:26 +0530 Subject: [PATCH 2/8] Added downgrade plan and enterprise grid changes --- .../workspaces-and-users/billing-and-plans.md | 152 +++++++++--------- 1 file changed, 73 insertions(+), 79 deletions(-) diff --git a/docs/workspaces-and-users/billing-and-plans.md b/docs/workspaces-and-users/billing-and-plans.md index 24036a2b..3a2a9830 100644 --- a/docs/workspaces-and-users/billing-and-plans.md +++ b/docs/workspaces-and-users/billing-and-plans.md @@ -14,30 +14,27 @@ Most SaaS tools charge per user. Every person who accesses the system counts tow **The per-seat model separates billing from user roles.** You purchase seats for users who need full access (Admins and Members), while users who need limited access (Guests) don't consume paid seats. This reflects how teams actually work: not everyone needs the same level of access. -For example, a typical workspace might have: -- 20 Admins and Members (core team) = 20 paid seats -- 100 Guests (stakeholders, clients, contractors) = 0 additional cost +For example, a typical workspace might have 20 Admins and Members (your core team) and 100 Guests (stakeholders, clients, contractors). With per-seat pricing, you pay for 20 seats and get 5 Guest slots per paid seat (100 total Guest slots). The Guests cost nothing extra. This model becomes more cost-effective as your Guest population grows. -With per-seat pricing, you pay for 20 seats and get 5 Guest slots per paid seat (100 total Guest slots). - -This model becomes more cost-effective as your Guest population grows. +:::warning +Guest allocation works differently on Enterprise Grid. Since Enterprise includes Granular Access Control(GAC) where any role can have any permission, the preset system-defined roles don't apply. All users at the instance level are billable seats. +::: ## How seat-based billing works -### Workspace-level billing +### Billing scope -Billing happens per workspace, not per organization. If you have multiple workspaces, each requires its own subscription. On self-hosted instances, each license key unlocks one workspace. +On Pro and Business plans, billing happens per workspace. If you have multiple workspaces, each requires its own subscription. -When you upgrade a workspace from **Workspace Settings > Billing and plans**, you're charged for all paid seats in that workspace, regardless of how those seats are distributed across projects within the workspace. +On the Enterprise Grid, billing happens at the instance level. A single Enterprise license covers the entire instance, including all workspaces within it. This means you can have multiple workspaces under one license. + +When you upgrade a workspace to a paid plan, you're charged for all seats, regardless of how those seats are distributed across projects. ### Seat allocation and usage -**Seats are workspace resources that you assign to users.** When you upgrade, you purchase a specific number of seats. Those seats form a pool that you allocate to Admins and Members. +**Seats are resources that you assign to users.** When you upgrade, you purchase a specific number of seats. Those seats form a pool that you allocate to users. -For example: -- You upgrade with 50 seats. -- You assign 45 seats to current Admins and Members. -- 5 seats remain available for future. +For example, you might upgrade with 50 seats, assign 45 to current Admins and Members, and keep 5 available for future hires. **The initial seat count matches your current team size.** When upgrading through Plane's interface, you automatically get as many seats as the number of Admins and Members currently in your workspace. On self-hosted instances upgrading through the Prime portal, you specify the seat count yourself. @@ -45,7 +42,9 @@ For example: ### Guest allocation -Every paid seat includes 5 Guest slots. These Guest slots are pooled at the workspace level, just like seats. If you have 20 paid seats, you get 100 Guest slots total (20 × 5). +On Pro and Business plans, every paid seat includes 5 Guest slots. These Guest slots are pooled at the workspace level, just like seats. If you have 20 paid seats, you get 100 Guest slots total (20 × 5). + +This does not apply to the Enterprise Grid. There, all users are billable seats at the instance level regardless of role. The rationale is that GAC (Granular Access Control) is coming on Enterprise Grid, which lets you define custom permissions for any role. This means our preset system-defined roles no longer apply in the same way. Plus, your Enterprise Grid license isn't tied to a single workspace. You can have multiple workspaces with Enterprise features turned on. ## Managing seats over time @@ -53,9 +52,7 @@ Every paid seat includes 5 Guest slots. These Guest slots are pooled at the work **You must add seats before adding new paid users.** If all your seats are assigned and you want to add another Admin or Member, you first [purchase additional seats](/workspaces-and-users/add-remove-seats#add-seats) from **Workspace Settings > Members > Manage seats**. -New seats are charged immediately to your card on file. The charge is either prorated (if you're mid-cycle) or at full price (if you're at the start of a cycle). - -**Prorating works proportionally.** If you add 10 seats halfway through a monthly billing cycle, you're charged for 10 seats × 15 days (roughly half the monthly price). Those seats then renew at full price in your next billing cycle. +New seats are charged immediately to your card on file. The charge is prorated if you're mid-cycle or at full price if you're at the start of a cycle. See [How proration works](#how-proration-works) for details. :::warning If you don't have a payment method on file, you must contact [Plane support](/support/get-help) to adjust your seat count. The system can't automatically charge for new seats without payment information. @@ -67,20 +64,28 @@ If you don't have a payment method on file, you must contact [Plane support](/su To actually reduce your billing, you must explicitly [remove seats](/workspaces-and-users/add-remove-seats#remove-unused-seats) from **Workspace Settings > Members > Manage seats**. This action removes any seats that aren't currently assigned to users. -When you remove seats, the cost reduction is applied as a credit on your next invoice. This credit is prorated based on how much of the billing cycle remains. - -For example, if you remove 10 seats halfway through your monthly cycle, you receive a credit for 10 seats × 15 days (roughly half the monthly cost). +When you remove seats, the prorated amount for the unused portion of the billing cycle is deducted from your next invoice. See [How proration works](#how-proration-works) for details. ### The seats-versus-members distinction This distinction causes confusion, so it's worth emphasizing: -**Seats are billing units.** They represent capacity, the maximum number of paid users you can have. +**Seats are billing units.** They represent capacity - the maximum number of paid users you can have. **Members are people.** They're the actual users assigned to your workspace. Actions on members (adding, removing, changing roles) don't automatically affect your seat count or billing. Actions on seats (purchasing, removing) directly affect your billing. +### How proration works + +Proration ensures you only pay for what you use. Whenever you change your seat count mid-cycle, Plane calculates the charge or deduction based on how much of the billing cycle remains. + +**When you add seats mid-cycle**, you're charged immediately at the prorated price for the remaining days. If you add 10 seats halfway through a monthly billing cycle, you pay for 10 seats × the remaining 15 days (roughly half the monthly price per seat). Those seats then renew at full price in the next billing cycle. + +**When you remove seats mid-cycle**, the unused portion is deducted from your next invoice. If you remove 10 seats halfway through a monthly billing cycle, your next invoice is reduced by the value of 10 seats × the remaining 15 days. + +Proration applies to both monthly and annual billing cycles, calculated proportionally based on the number of days remaining in the cycle. + ## Subscription lifecycle ### Automatic renewals @@ -88,25 +93,22 @@ Actions on members (adding, removing, changing roles) don't automatically affect Subscriptions renew automatically at the start of each billing cycle (monthly or annual, depending on what you selected). The renewal charge is processed through your payment method on file. Stripe, Plane's payment processor, handles the renewal: + 1. An invoice is generated at the renewal date. 2. The charge is attempted on your payment method. 3. If successful, your subscription continues. -4. If unsuccessful, Stripe retries the payment 3-5 times over 14 days. +4. If unsuccessful, Stripe retries the payment 3–5 times over 14 days. 5. After 14 days of failed attempts, the subscription is automatically cancelled. You receive email alerts before each billing attempt and after failed payments. ### Mid-cycle changes -**Billing frequency changes** (monthly to annual, or vice versa) take effect at your next billing cycle. You can request this change from **Workspace Settings > Billing and plans > Manage Subscription**. +**Billing frequency changes** (monthly to annual, or vice versa) take effect at your next billing cycle. You can request this change from **Workspace Settings > Billing & Plans > Manage Subscription**. On Cloud, the change happens automatically. On self-hosted instances, you accept the change in the Stripe portal, then return to Plane and click [Sync plan](/workspaces-and-users/manage-licenses#sync-plan) from Workspace Settings to apply the changes locally. -**Plan upgrades** happen immediately: -- On Cloud: Accept the change from **Manage Subscription**. Any additional cost is prorated and charged immediately. If the new plan costs less, the difference is credited to your next invoice. -- On self-hosted: Currently requires purchasing a new license and activating it. This process will be simplified in future releases. - -**Plan downgrades** to the Free tier cancel your subscription at the end of the current billing cycle. Your workspace continues with paid features until that date. +**Plan upgrades** happen immediately. On Cloud, accept the change from **Manage Subscription**. Any additional cost is prorated and charged immediately. If the new plan costs less per seat, the difference is deducted from your next invoice. On self-hosted instances, this currently requires purchasing a new license and activating it. This process will be simplified in future releases. ### Price stability @@ -114,107 +116,99 @@ Your subscription price doesn't change mid-cycle unless you add or remove seats. The exception: limited-period discounts that some workspaces receive during promotional periods. These discounts expire according to their specific terms. +## Downgrade your plan + +You can downgrade from a higher plan to a lower one or cancel your subscription entirely to return to the Free plan. + +### Downgrade to a lower paid plan + +1. Go to **Workspace Settings > Billing and Plans**. +2. Click **Manage Subscription**. This opens the Stripe portal. +3. Click **Update subscription**. +4. Select the plan you want to downgrade to and click **Continue**. +5. Confirm the change. + +The downgrade takes effect at the end of your current billing cycle. You keep access to the higher plan's features until the cycle ends. The difference in cost is deducted from your next invoice. + +### Cancel and return to the Free plan + +1. Go to **Workspace Settings > Billing & Plans**. +2. Click **Manage Subscription**. This opens the Stripe portal. +3. Click **Cancel subscription**. +4. Confirm the cancellation. + +Your workspace retains all paid features until the end of the current billing cycle. + +If your workspace exceeds the Free plan's 12-seat limit when your subscription ends, the workspace enters a locked state. Only the **Members** page is accessible. Workspace Admins can either remove users to get below 12 seats or reactivate a paid subscription to regain full access. + ## Free plan and trial access ### Free trial for new workspaces When you create a new Plane workspace, you automatically start a 14-day free trial of the Business plan. This gives you full access to premium features without requiring payment information. -The trial includes: -- All Business plan features -- Full seat capacity for your team -- AI credits for Plane AI features -- No payment method required +The trial includes all Business plan features, full seat capacity for your team, and AI credits for Plane AI features. No payment method is required. After 14 days, your workspace automatically reverts to the Free plan if you haven't upgraded to a paid subscription. ### Free plan seat limits -The Free plan supports up to 12 seats. This applies to both Cloud and self-hosted Commercial Edition workspaces. +The Free plan supports up to 12 seats. -**Grandfathered workspaces** -Workspaces on the Free tier before v1.3.0 on the Commercial Edition were grandfathered at their current seat count. If you had 20 Admins and Members when the limit was introduced, your Free workspace retains 20 seats. +**Grandfathered workspaces** — Cloud workspaces on the Free tier before v1.3.0 were grandfathered at their current seat count. If you had 20 Admins and Members when the limit was introduced, your Free workspace retains 20 seats. Grandfathered workspaces keep their higher seat count until you manually remove seats. Once you drop to 12 seats, you lose grandfathered status and cannot add seats without upgrading. If you upgrade a grandfathered workspace to a paid plan, you're charged for all grandfathered seats. A workspace with 20 grandfathered seats would be billed for 20 seats on a Pro or Business plan. ## AI credits and usage -Plane AI uses a separate credit-based system for AI features. Credits measure the computational work required for AI tasks, from quick queries to bulk automations. -Each plan includes monthly AI credits per seat that pool at the workspace level. +Plane AI uses a separate credit-based system for AI features. Credits measure the computational work required for AI tasks, from quick queries to bulk automations. -AI credits are separate from your seat-based subscription. You can run out of AI credits without affecting your paid seats, and vice versa. Learn more about [how AI credits work](/ai/plane-ai-credits) including consumption rates, rollover policies, and top-up options. +Each plan includes monthly AI credits per seat that pool at the workspace level. AI credits are separate from your seat-based subscription — you can run out of AI credits without affecting your paid seats, and vice versa. Learn more about [how AI credits work](/ai/plane-ai-credits) including consumption rates, rollover policies, and top-up options. ## Payment and invoicing ### Payment methods -Plane requires a payment method on file for all paid subscriptions created through the standard upgrade flow. Stripe (our payment processor) doesn't allow removing all payment methods once a subscription is active. +Plane requires a payment method on file for all paid subscriptions created through the standard upgrade flow. Stripe (Plane's payment processor) doesn't allow removing all payment methods once a subscription is active. -You can update your payment method anytime from **Workspace Settings > Billing and plans > Manage Subscription**. +You can update your payment method anytime from **Workspace Settings > Billing & Plans > Manage Subscription**. -### Download invoice +### Download invoices -All invoices are available from **Workspace Settings > Billing and plans > Manage Subscription**. You can view and download past invoices for accounting purposes. +All invoices are available from **Workspace Settings > Billing & Plans > Manage Subscription**. You can view and download past invoices for accounting purposes. ### Failed payments -When a payment fails, Stripe attempts to collect payment 3-5 times over 14 days. You receive email notifications after each failed attempt. +When a payment fails, Stripe attempts to collect payment 3–5 times over 14 days. You receive email notifications after each failed attempt. -If all payment attempts fail: -- Cloud workspaces: Subscription cancels after 14 days -- Self-hosted workspaces: Subscription cancels 7 days after the failed payment cycle +If all payment attempts fail, Cloud workspaces are cancelled after 14 days. Self-hosted workspaces are cancelled 7 days after the failed payment cycle. ## Unpaid bills -If you have an active subscription with unpaid invoices, you receive a 30-day notice to clear the balance. After 30 days, your workspace enters a restricted state: - -- All members except Workspace Admins are locked out. -- Workspace Admins can access **Workspace Settings > Billing and plans**. -- No project work is accessible until bills are paid. +If you have an active subscription with unpaid invoices, you receive a 30-day notice to clear the balance. After 30 days, your workspace enters a restricted state where all members except Workspace Admins are locked out. Workspace Admins can access **Workspace Settings > Billing & Plans** but no project work is accessible until bills are paid. Once you pay outstanding invoices, full workspace access is restored immediately. -## Subscription cancellations - -When you cancel your subscription from **Manage Subscription**, the cancellation takes effect at the end of your current billing cycle. Your workspace retains all paid features until that date. - -After the billing cycle ends: -- Cloud workspaces: Immediate return to Free plan -- Self-hosted workspaces: Return to Free plan after 7-day grace period - -### Post-cancellation behavior - -If your workspace exceeds the Free plan's 12-seat limit when your subscription ends, the workspace enters a locked state: - -- Only the **Members** page is accessible -- Workspace Admins can remove users to get below 12 seats -- Alternatively, Workspace Admins can reactivate a paid subscription - -You must either reduce your team to 12 seats or renew your subscription to regain full access. - ## Cloud versus self-hosted billing differences Most billing mechanics work identically across Cloud and self-hosted instances, with a few key differences: -**License activation** -Self-hosted instances require [license key activation](/workspaces-and-users/manage-licenses#activate-license). Each license key unlocks one workspace on one instance. Cloud workspaces activate directly through the Stripe integration. +**License activation** — Self-hosted instances require [license key activation](/workspaces-and-users/manage-licenses#activate-license). Each license key unlocks one workspace on one instance. Cloud workspaces activate directly through the Stripe integration. -**Plan changes** -Cloud workspaces handle plan changes (upgrades, frequency changes) automatically. Self-hosted instances require using [Sync plan](/workspaces-and-users/manage-licenses#sync-plan) from Workspace Settings after accepting changes in the Stripe portal. +**Plan changes** — Cloud workspaces handle plan changes (upgrades, frequency changes) automatically. Self-hosted instances require using [Sync plan](/workspaces-and-users/manage-licenses#sync-plan) from Workspace Settings after accepting changes in the Stripe portal. -**License portability** -Self-hosted license keys are tied to both a workspace and a machine. If you switch servers or workspaces, you must [delink your license key](https://docs.plane.so/workspaces-and-users/manage-licenses#delink-license-key) from the old workspace before reactivating it elsewhere. +**License portability** — Self-hosted license keys are tied to both a workspace and a machine. If you switch servers or workspaces, you must [delink your license key](/workspaces-and-users/manage-licenses#delink-license-key) from the old workspace before reactivating it elsewhere. ## Refund policy Plane doesn't offer refunds except in exceptional circumstances. Billing happens automatically with advance email notifications before each charge. -If you believe you have an exceptional case warranting a refund, contact [Plane support](https://docs.plane.so/support/get-help) with details about your situation. +If you believe you have an exceptional case warranting a refund, contact [Plane support](/support/get-help) with details about your situation. ## See also - [Upgrade to a paid plan](/workspaces-and-users/upgrade-plan) - [Add or remove seats](/workspaces-and-users/add-remove-seats) -- [Manage licenses for self-hosted](/workspaces-and-users/manage-licenses)
 \ No newline at end of file +- [Manage licenses for self-hosted](/workspaces-and-users/manage-licenses) From c16fa283f4fd29e1574b727b10c99df9e09d8e58 Mon Sep 17 00:00:00 2001 From: danciaclara Date: Thu, 19 Mar 2026 02:41:02 +0530 Subject: [PATCH 3/8] minor fix --- docs/workspaces-and-users/billing-and-plans.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/docs/workspaces-and-users/billing-and-plans.md b/docs/workspaces-and-users/billing-and-plans.md index 3a2a9830..86895e43 100644 --- a/docs/workspaces-and-users/billing-and-plans.md +++ b/docs/workspaces-and-users/billing-and-plans.md @@ -195,11 +195,14 @@ Once you pay outstanding invoices, full workspace access is restored immediately Most billing mechanics work identically across Cloud and self-hosted instances, with a few key differences: -**License activation** — Self-hosted instances require [license key activation](/workspaces-and-users/manage-licenses#activate-license). Each license key unlocks one workspace on one instance. Cloud workspaces activate directly through the Stripe integration. +**License activation** +Self-hosted instances require [license key activation](/workspaces-and-users/manage-licenses#activate-license). Each license key unlocks one workspace on one instance. Cloud workspaces activate directly through the Stripe integration. -**Plan changes** — Cloud workspaces handle plan changes (upgrades, frequency changes) automatically. Self-hosted instances require using [Sync plan](/workspaces-and-users/manage-licenses#sync-plan) from Workspace Settings after accepting changes in the Stripe portal. +**Plan changes** +Cloud workspaces handle plan changes (upgrades, frequency changes) automatically. Self-hosted instances require using [Sync plan](/workspaces-and-users/manage-licenses#sync-plan) from Workspace Settings after accepting changes in the Stripe portal. -**License portability** — Self-hosted license keys are tied to both a workspace and a machine. If you switch servers or workspaces, you must [delink your license key](/workspaces-and-users/manage-licenses#delink-license-key) from the old workspace before reactivating it elsewhere. +**License portability** +Self-hosted license keys are tied to both a workspace and a machine. If you switch servers or workspaces, you must [delink your license key](/workspaces-and-users/manage-licenses#delink-license-key) from the old workspace before reactivating it elsewhere. ## Refund policy From 267800b8cd8e4a29b57b147dd8fb5e0a07c98baf Mon Sep 17 00:00:00 2001 From: danciaclara Date: Thu, 19 Mar 2026 03:13:22 +0530 Subject: [PATCH 4/8] minor fix --- .../workspaces-and-users/billing-and-plans.md | 27 ++++++++++--------- 1 file changed, 14 insertions(+), 13 deletions(-) diff --git a/docs/workspaces-and-users/billing-and-plans.md b/docs/workspaces-and-users/billing-and-plans.md index 86895e43..975e4bc6 100644 --- a/docs/workspaces-and-users/billing-and-plans.md +++ b/docs/workspaces-and-users/billing-and-plans.md @@ -44,7 +44,7 @@ For example, you might upgrade with 50 seats, assign 45 to current Admins and Me On Pro and Business plans, every paid seat includes 5 Guest slots. These Guest slots are pooled at the workspace level, just like seats. If you have 20 paid seats, you get 100 Guest slots total (20 × 5). -This does not apply to the Enterprise Grid. There, all users are billable seats at the instance level regardless of role. The rationale is that GAC (Granular Access Control) is coming on Enterprise Grid, which lets you define custom permissions for any role. This means our preset system-defined roles no longer apply in the same way. Plus, your Enterprise Grid license isn't tied to a single workspace. You can have multiple workspaces with Enterprise features turned on. +This does not apply to the Enterprise Grid. All users are billable seats at the instance level regardless of role. This is because Enterprise Grid will include Global Access Control, which lets you define custom permissions for any role. This means our preset system-defined roles no longer apply in the same way. Plus, your Enterprise Grid license isn't tied to a single workspace. You can have multiple workspaces with Enterprise features turned on. ## Managing seats over time @@ -97,14 +97,14 @@ Stripe, Plane's payment processor, handles the renewal: 1. An invoice is generated at the renewal date. 2. The charge is attempted on your payment method. 3. If successful, your subscription continues. -4. If unsuccessful, Stripe retries the payment 3–5 times over 14 days. +4. If unsuccessful, Stripe retries the payment 3-5 times over 14 days. 5. After 14 days of failed attempts, the subscription is automatically cancelled. You receive email alerts before each billing attempt and after failed payments. ### Mid-cycle changes -**Billing frequency changes** (monthly to annual, or vice versa) take effect at your next billing cycle. You can request this change from **Workspace Settings > Billing & Plans > Manage Subscription**. +**Billing frequency changes** (monthly to annual, or vice versa) take effect at your next billing cycle. You can request this change from **Workspace Settings > Billing and plans > Manage Subscription**. On Cloud, the change happens automatically. On self-hosted instances, you accept the change in the Stripe portal, then return to Plane and click [Sync plan](/workspaces-and-users/manage-licenses#sync-plan) from Workspace Settings to apply the changes locally. @@ -132,7 +132,7 @@ The downgrade takes effect at the end of your current billing cycle. You keep ac ### Cancel and return to the Free plan -1. Go to **Workspace Settings > Billing & Plans**. +1. Go to **Workspace Settings > Billing and Plans**. 2. Click **Manage Subscription**. This opens the Stripe portal. 3. Click **Cancel subscription**. 4. Confirm the cancellation. @@ -155,7 +155,8 @@ After 14 days, your workspace automatically reverts to the Free plan if you have The Free plan supports up to 12 seats. -**Grandfathered workspaces** — Cloud workspaces on the Free tier before v1.3.0 were grandfathered at their current seat count. If you had 20 Admins and Members when the limit was introduced, your Free workspace retains 20 seats. +**Grandfathered workspaces** +Cloud workspaces on the Free tier before v1.3.0 were grandfathered at their current seat count. If you had 20 Admins and Members when the limit was introduced, your Free workspace retains 20 seats. Grandfathered workspaces keep their higher seat count until you manually remove seats. Once you drop to 12 seats, you lose grandfathered status and cannot add seats without upgrading. @@ -165,7 +166,7 @@ If you upgrade a grandfathered workspace to a paid plan, you're charged for all Plane AI uses a separate credit-based system for AI features. Credits measure the computational work required for AI tasks, from quick queries to bulk automations. -Each plan includes monthly AI credits per seat that pool at the workspace level. AI credits are separate from your seat-based subscription — you can run out of AI credits without affecting your paid seats, and vice versa. Learn more about [how AI credits work](/ai/plane-ai-credits) including consumption rates, rollover policies, and top-up options. +Each plan includes monthly AI credits per seat that pool at the workspace level. AI credits are separate from your seat-based subscription - you can run out of AI credits without affecting your paid seats, and vice versa. Learn more about [how AI credits work](/ai/plane-ai-credits) including consumption rates, rollover policies, and top-up options. ## Payment and invoicing @@ -173,21 +174,21 @@ Each plan includes monthly AI credits per seat that pool at the workspace level. Plane requires a payment method on file for all paid subscriptions created through the standard upgrade flow. Stripe (Plane's payment processor) doesn't allow removing all payment methods once a subscription is active. -You can update your payment method anytime from **Workspace Settings > Billing & Plans > Manage Subscription**. +You can update your payment method anytime from **Workspace Settings > Billing and plans > Manage Subscription**. ### Download invoices -All invoices are available from **Workspace Settings > Billing & Plans > Manage Subscription**. You can view and download past invoices for accounting purposes. +All invoices are available from **Workspace Settings > Billing and plans > Manage Subscription**. You can view and download past invoices for accounting purposes. ### Failed payments -When a payment fails, Stripe attempts to collect payment 3–5 times over 14 days. You receive email notifications after each failed attempt. +When a payment fails, Stripe attempts to collect payment 3-5 times over 14 days. You receive email notifications after each failed attempt. If all payment attempts fail, Cloud workspaces are cancelled after 14 days. Self-hosted workspaces are cancelled 7 days after the failed payment cycle. ## Unpaid bills -If you have an active subscription with unpaid invoices, you receive a 30-day notice to clear the balance. After 30 days, your workspace enters a restricted state where all members except Workspace Admins are locked out. Workspace Admins can access **Workspace Settings > Billing & Plans** but no project work is accessible until bills are paid. +If you have an active subscription with unpaid invoices, you receive a 30-day notice to clear the balance. After 30 days, your workspace enters a restricted state where all members except Workspace Admins are locked out. Workspace Admins can access **Billing and plans** page, but no project work is accessible until bills are paid. Once you pay outstanding invoices, full workspace access is restored immediately. @@ -196,13 +197,13 @@ Once you pay outstanding invoices, full workspace access is restored immediately Most billing mechanics work identically across Cloud and self-hosted instances, with a few key differences: **License activation** -Self-hosted instances require [license key activation](/workspaces-and-users/manage-licenses#activate-license). Each license key unlocks one workspace on one instance. Cloud workspaces activate directly through the Stripe integration. +Self-hosted instances require [license key activation](https://developers.plane.so/self-hosting/manage/manage-licenses/activate-pro-and-business). On Pro and Business, each license key unlocks one workspace on one instance. On Enterprise, the license activates at the instance level, covering all workspaces within it. Cloud workspaces activate directly through the billing portal. There is no need to activate using a license key. **Plan changes** -Cloud workspaces handle plan changes (upgrades, frequency changes) automatically. Self-hosted instances require using [Sync plan](/workspaces-and-users/manage-licenses#sync-plan) from Workspace Settings after accepting changes in the Stripe portal. +Cloud workspaces handle plan changes (upgrades, frequency changes) automatically. Self-hosted instances require using [Sync plan](/workspaces-and-users/manage-licenses#sync-plan) from Workspace Settings after accepting changes in the billing portal. **License portability** -Self-hosted license keys are tied to both a workspace and a machine. If you switch servers or workspaces, you must [delink your license key](/workspaces-and-users/manage-licenses#delink-license-key) from the old workspace before reactivating it elsewhere. +On Pro and Business, license keys are tied to both a workspace and a machine. If you switch servers or workspaces, you must [delink your license key](https://developers.plane.so/self-hosting/manage/manage-licenses/activate-pro-and-business#delink-license-key) from the old workspace before reactivating it elsewhere. On Enterprise Grid, [license activation](https://developers.plane.so/self-hosting/manage/manage-licenses/activate-enterprise) and delinking happens at the instance level through [God mode](https://developers.plane.so/self-hosting/govern/instance-admin). ## Refund policy From 6e5001c85539229011ee8a2a39b7354f67bc22c6 Mon Sep 17 00:00:00 2001 From: danciaclara Date: Thu, 19 Mar 2026 03:14:23 +0530 Subject: [PATCH 5/8] minor fix --- docs/workspaces-and-users/billing-and-plans.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/workspaces-and-users/billing-and-plans.md b/docs/workspaces-and-users/billing-and-plans.md index 975e4bc6..a19f6ae7 100644 --- a/docs/workspaces-and-users/billing-and-plans.md +++ b/docs/workspaces-and-users/billing-and-plans.md @@ -17,7 +17,7 @@ Most SaaS tools charge per user. Every person who accesses the system counts tow For example, a typical workspace might have 20 Admins and Members (your core team) and 100 Guests (stakeholders, clients, contractors). With per-seat pricing, you pay for 20 seats and get 5 Guest slots per paid seat (100 total Guest slots). The Guests cost nothing extra. This model becomes more cost-effective as your Guest population grows. :::warning -Guest allocation works differently on Enterprise Grid. Since Enterprise includes Granular Access Control(GAC) where any role can have any permission, the preset system-defined roles don't apply. All users at the instance level are billable seats. +Guest allocation works differently on Enterprise Grid. Since Enterprise includes Granular Access Control (GAC) where any role can have any permission, the preset system-defined roles don't apply. All users at the instance level are billable seats. ::: ## How seat-based billing works From 287cae6287d69a327eb40973ed1859a5317136d7 Mon Sep 17 00:00:00 2001 From: danciaclara Date: Thu, 19 Mar 2026 23:05:35 +0530 Subject: [PATCH 6/8] review fixes --- .../workspaces-and-users/billing-and-plans.md | 67 ++++++++++--------- 1 file changed, 36 insertions(+), 31 deletions(-) diff --git a/docs/workspaces-and-users/billing-and-plans.md b/docs/workspaces-and-users/billing-and-plans.md index a19f6ae7..a9c2e9fa 100644 --- a/docs/workspaces-and-users/billing-and-plans.md +++ b/docs/workspaces-and-users/billing-and-plans.md @@ -6,35 +6,34 @@ description: Learn how Plane's per-seat billing works, and how billing cycles, u # How billing works -Plane uses a per-seat billing model for paid plans. This means you pay for the number of seats in your workspace, not the total number of users. Understanding this distinction helps you manage costs effectively while giving flexibility to your team structure. +Plane uses a per-seat billing model for paid plans. You pay for the number of seats in your workspace, not the total number of users. Understanding this distinction helps you manage costs effectively while giving you the flexibility to map seats to your teams. ## Why per-seat instead of per-user? Most SaaS tools charge per user. Every person who accesses the system counts toward your bill. Plane takes a different approach. -**The per-seat model separates billing from user roles.** You purchase seats for users who need full access (Admins and Members), while users who need limited access (Guests) don't consume paid seats. This reflects how teams actually work: not everyone needs the same level of access. +**The per-seat model separates billing from user roles.** You purchase seats for users who need full access—Admins and Members—while users who need limited access—Guests—are not billed at all. This reflects how teams actually work. Not everyone needs the same level of access. -For example, a typical workspace might have 20 Admins and Members (your core team) and 100 Guests (stakeholders, clients, contractors). With per-seat pricing, you pay for 20 seats and get 5 Guest slots per paid seat (100 total Guest slots). The Guests cost nothing extra. This model becomes more cost-effective as your Guest population grows. +For example, a typical workspace might have 20 Admins and Members and 100 Guests 100 Guests spanning non-participating stakeholders, clients, contractors, and other users. With per-seat pricing, you pay for 20 seats and get 5 Guest slots per paid seat for a total 100 Guest slots. Guests cost nothing extra. This model becomes more cost-effective as your Guest population grows. :::warning -Guest allocation works differently on Enterprise Grid. Since Enterprise includes Granular Access Control (GAC) where any role can have any permission, the preset system-defined roles don't apply. All users at the instance level are billable seats. +Guest allocation works differently on Enterprise Grid. Since Enterprise Grid includes Granular Access Control (GAC) where any role can have any permission, the preset system-defined roles don't apply. All users at the instance level are billable seats. ::: ## How seat-based billing works -### Billing scope +### Pro and Business plans -On Pro and Business plans, billing happens per workspace. If you have multiple workspaces, each requires its own subscription. +Billing happens per workspace. If you have multiple workspaces, each requires its own subscription. When you upgrade a workspace to a paid plan, you're charged for all seats, regardless of how those seats are distributed across projects. -On the Enterprise Grid, billing happens at the instance level. A single Enterprise license covers the entire instance, including all workspaces within it. This means you can have multiple workspaces under one license. - -When you upgrade a workspace to a paid plan, you're charged for all seats, regardless of how those seats are distributed across projects. +### Enterprise Grid +Billing happens at the instance or the tenant level. A single Enterprise Grid license covers the entire instance, including all workspaces within it. This means you can have multiple workspaces under one license. ### Seat allocation and usage **Seats are resources that you assign to users.** When you upgrade, you purchase a specific number of seats. Those seats form a pool that you allocate to users. -For example, you might upgrade with 50 seats, assign 45 to current Admins and Members, and keep 5 available for future hires. +For example, you might upgrade with 50 seats, assign 45 to current Admins and Members, and keep 5 available for the future. **The initial seat count matches your current team size.** When upgrading through Plane's interface, you automatically get as many seats as the number of Admins and Members currently in your workspace. On self-hosted instances upgrading through the Prime portal, you specify the seat count yourself. @@ -52,10 +51,10 @@ This does not apply to the Enterprise Grid. All users are billable seats at the **You must add seats before adding new paid users.** If all your seats are assigned and you want to add another Admin or Member, you first [purchase additional seats](/workspaces-and-users/add-remove-seats#add-seats) from **Workspace Settings > Members > Manage seats**. -New seats are charged immediately to your card on file. The charge is prorated if you're mid-cycle or at full price if you're at the start of a cycle. See [How proration works](#how-proration-works) for details. +New seats are charged immediately to your card on file. The charge is prorated if you're mid-cycle or at full price if you're at the start of a cycle. See [How proration works](#how-proration-works) for more. :::warning -If you don't have a payment method on file, you must contact [Plane support](/support/get-help) to adjust your seat count. The system can't automatically charge for new seats without payment information. +If you don't have an online payment method on file or you have an offline subscription, you must contact [Plane support](/support/get-help) to adjust your seat count. The system can't automatically charge for new seats without payment information. ::: ### Removing seats @@ -64,23 +63,23 @@ If you don't have a payment method on file, you must contact [Plane support](/su To actually reduce your billing, you must explicitly [remove seats](/workspaces-and-users/add-remove-seats#remove-unused-seats) from **Workspace Settings > Members > Manage seats**. This action removes any seats that aren't currently assigned to users. -When you remove seats, the prorated amount for the unused portion of the billing cycle is deducted from your next invoice. See [How proration works](#how-proration-works) for details. +When you remove seats, the prorated amount for the unused portion of the billing cycle is deducted from your next invoice. See [How proration works](#how-proration-works) for more. ### The seats-versus-members distinction This distinction causes confusion, so it's worth emphasizing: -**Seats are billing units.** They represent capacity - the maximum number of paid users you can have. +**Seats are billing units.** They represent capacity, the maximum number of paid users you can have. -**Members are people.** They're the actual users assigned to your workspace. +**Members are people.** They're the actual users in your workspace. -Actions on members (adding, removing, changing roles) don't automatically affect your seat count or billing. Actions on seats (purchasing, removing) directly affect your billing. +Actions on members—adding, removing, changing roles—don't automatically affect your seat count or billing. Actions on seats—purchasing, removing—directly affect your billing. ### How proration works Proration ensures you only pay for what you use. Whenever you change your seat count mid-cycle, Plane calculates the charge or deduction based on how much of the billing cycle remains. -**When you add seats mid-cycle**, you're charged immediately at the prorated price for the remaining days. If you add 10 seats halfway through a monthly billing cycle, you pay for 10 seats × the remaining 15 days (roughly half the monthly price per seat). Those seats then renew at full price in the next billing cycle. +**When you add seats mid-cycle**, you're charged immediately at the prorated price for the remaining days. If you add 10 seats halfway through a monthly billing cycle, you pay for 10 seats × the remaining 15 days, roughly half the monthly price per seat. Those seats then renew at full price in the next billing cycle. **When you remove seats mid-cycle**, the unused portion is deducted from your next invoice. If you remove 10 seats halfway through a monthly billing cycle, your next invoice is reduced by the value of 10 seats × the remaining 15 days. @@ -90,9 +89,9 @@ Proration applies to both monthly and annual billing cycles, calculated proporti ### Automatic renewals -Subscriptions renew automatically at the start of each billing cycle (monthly or annual, depending on what you selected). The renewal charge is processed through your payment method on file. +Subscriptions renew automatically at the start of each billing cycle, monthly or annua, depending on what you selected. The renewal charge is processed through your payment method on file. -Stripe, Plane's payment processor, handles the renewal: +Stripe, Plane's payment processor, handles the renewal. 1. An invoice is generated at the renewal date. 2. The charge is attempted on your payment method. @@ -104,17 +103,18 @@ You receive email alerts before each billing attempt and after failed payments. ### Mid-cycle changes -**Billing frequency changes** (monthly to annual, or vice versa) take effect at your next billing cycle. You can request this change from **Workspace Settings > Billing and plans > Manage Subscription**. +**Billing frequency changes**—monthly to annual, or vice versa—take effect at your next billing cycle. You can request this change from **Workspace Settings > Billing and plans > Manage Subscription**. On Cloud, the change happens automatically. On self-hosted instances, you accept the change in the Stripe portal, then return to Plane and click [Sync plan](/workspaces-and-users/manage-licenses#sync-plan) from Workspace Settings to apply the changes locally. -**Plan upgrades** happen immediately. On Cloud, accept the change from **Manage Subscription**. Any additional cost is prorated and charged immediately. If the new plan costs less per seat, the difference is deducted from your next invoice. On self-hosted instances, this currently requires purchasing a new license and activating it. This process will be simplified in future releases. +**Plan upgrades** happen immediately. On Cloud, change the plan from **Manage Subscription**. Any additional cost is prorated and charged immediately. If the new plan costs less per seat, the difference is deducted from your next invoice. On self-hosted instances, this currently requires purchasing a new license and activating it. This process will be simplified in future releases. ### Price stability Your subscription price doesn't change mid-cycle unless you add or remove seats. Monthly subscriptions renew at the same price each month. Annual subscriptions remain constant for the full year. -The exception: limited-period discounts that some workspaces receive during promotional periods. These discounts expire according to their specific terms. +**The exception** +Limited-period discounts that some workspaces get during promotional periods expire according to their specific terms. ## Downgrade your plan @@ -122,7 +122,7 @@ You can downgrade from a higher plan to a lower one or cancel your subscription ### Downgrade to a lower paid plan -1. Go to **Workspace Settings > Billing and Plans**. +1. Go to **Workspace Settings > Billing and plans**. 2. Click **Manage Subscription**. This opens the Stripe portal. 3. Click **Update subscription**. 4. Select the plan you want to downgrade to and click **Continue**. @@ -132,7 +132,7 @@ The downgrade takes effect at the end of your current billing cycle. You keep ac ### Cancel and return to the Free plan -1. Go to **Workspace Settings > Billing and Plans**. +1. Go to **Workspace Settings > Billing and plans**. 2. Click **Manage Subscription**. This opens the Stripe portal. 3. Click **Cancel subscription**. 4. Confirm the cancellation. @@ -145,7 +145,7 @@ If your workspace exceeds the Free plan's 12-seat limit when your subscription e ### Free trial for new workspaces -When you create a new Plane workspace, you automatically start a 14-day free trial of the Business plan. This gives you full access to premium features without requiring payment information. +When you create a new Plane workspace on our Cloud, you automatically start a 14-day free trial of the Business plan. This gives you full access to premium features without requiring payment information. The trial includes all Business plan features, full seat capacity for your team, and AI credits for Plane AI features. No payment method is required. @@ -156,29 +156,34 @@ After 14 days, your workspace automatically reverts to the Free plan if you have The Free plan supports up to 12 seats. **Grandfathered workspaces** -Cloud workspaces on the Free tier before v1.3.0 were grandfathered at their current seat count. If you had 20 Admins and Members when the limit was introduced, your Free workspace retains 20 seats. +Cloud workspaces on the Free tier before December 17th, 2024 were grandfathered at their current seat count. If you had 20 Admins and Members when the limit was introduced, your Free workspace retains 20 seats. Grandfathered workspaces keep their higher seat count until you manually remove seats. Once you drop to 12 seats, you lose grandfathered status and cannot add seats without upgrading. -If you upgrade a grandfathered workspace to a paid plan, you're charged for all grandfathered seats. A workspace with 20 grandfathered seats would be billed for 20 seats on a Pro or Business plan. +If you upgrade a grandfathered workspace to a paid plan, you're charged for all grandfathered seats. A workspace with 20 grandfathered seats would be billed for 20 seats on a paid plan. ## AI credits and usage Plane AI uses a separate credit-based system for AI features. Credits measure the computational work required for AI tasks, from quick queries to bulk automations. -Each plan includes monthly AI credits per seat that pool at the workspace level. AI credits are separate from your seat-based subscription - you can run out of AI credits without affecting your paid seats, and vice versa. Learn more about [how AI credits work](/ai/plane-ai-credits) including consumption rates, rollover policies, and top-up options. +Each plan includes monthly AI credits per seat that pool at the workspace level. AI credits are separate from your seat-based subscription. You can run out of AI credits without affecting your paid seats, and vice versa. Learn more about [how AI credits work](/ai/plane-ai-credits) including consumption rates, rollover policies, and top-up options. + +::: warning IMPORTANT +AI credits apply only to Plane Cloud. +On self-hosted instances, you use your own AI provider's API keys, and all AI usage and costs are managed directly through your provider. +::: ## Payment and invoicing ### Payment methods -Plane requires a payment method on file for all paid subscriptions created through the standard upgrade flow. Stripe (Plane's payment processor) doesn't allow removing all payment methods once a subscription is active. +Plane requires a payment method on file for all paid subscriptions created through the standard upgrade flow. Stripe, Plane's payment processor, doesn't allow removing all payment methods once a subscription is active. You can update your payment method anytime from **Workspace Settings > Billing and plans > Manage Subscription**. ### Download invoices -All invoices are available from **Workspace Settings > Billing and plans > Manage Subscription**. You can view and download past invoices for accounting purposes. +All invoices are available from **Workspace Settings > Billing and plans > Manage Subscription**. You can view and download past invoices from that screen. ### Failed payments @@ -200,7 +205,7 @@ Most billing mechanics work identically across Cloud and self-hosted instances, Self-hosted instances require [license key activation](https://developers.plane.so/self-hosting/manage/manage-licenses/activate-pro-and-business). On Pro and Business, each license key unlocks one workspace on one instance. On Enterprise, the license activates at the instance level, covering all workspaces within it. Cloud workspaces activate directly through the billing portal. There is no need to activate using a license key. **Plan changes** -Cloud workspaces handle plan changes (upgrades, frequency changes) automatically. Self-hosted instances require using [Sync plan](/workspaces-and-users/manage-licenses#sync-plan) from Workspace Settings after accepting changes in the billing portal. +Cloud workspaces handle plan changes—upgrades, frequency changes—automatically. Self-hosted instances require using [Sync plan](/workspaces-and-users/manage-licenses#sync-plan) from Workspace Settings after accepting changes in the billing portal. **License portability** On Pro and Business, license keys are tied to both a workspace and a machine. If you switch servers or workspaces, you must [delink your license key](https://developers.plane.so/self-hosting/manage/manage-licenses/activate-pro-and-business#delink-license-key) from the old workspace before reactivating it elsewhere. On Enterprise Grid, [license activation](https://developers.plane.so/self-hosting/manage/manage-licenses/activate-enterprise) and delinking happens at the instance level through [God mode](https://developers.plane.so/self-hosting/govern/instance-admin). From 0c54a83d86a54b423d1ceaf1b47142d67e749696 Mon Sep 17 00:00:00 2001 From: danciaclara Date: Thu, 19 Mar 2026 23:07:57 +0530 Subject: [PATCH 7/8] formatting fixes --- docs/workspaces-and-users/billing-and-plans.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/workspaces-and-users/billing-and-plans.md b/docs/workspaces-and-users/billing-and-plans.md index a9c2e9fa..c6b58aaa 100644 --- a/docs/workspaces-and-users/billing-and-plans.md +++ b/docs/workspaces-and-users/billing-and-plans.md @@ -27,6 +27,7 @@ Guest allocation works differently on Enterprise Grid. Since Enterprise Grid inc Billing happens per workspace. If you have multiple workspaces, each requires its own subscription. When you upgrade a workspace to a paid plan, you're charged for all seats, regardless of how those seats are distributed across projects. ### Enterprise Grid + Billing happens at the instance or the tenant level. A single Enterprise Grid license covers the entire instance, including all workspaces within it. This means you can have multiple workspaces under one license. ### Seat allocation and usage @@ -113,7 +114,7 @@ On Cloud, the change happens automatically. On self-hosted instances, you accept Your subscription price doesn't change mid-cycle unless you add or remove seats. Monthly subscriptions renew at the same price each month. Annual subscriptions remain constant for the full year. -**The exception** +**The exception** Limited-period discounts that some workspaces get during promotional periods expire according to their specific terms. ## Downgrade your plan @@ -177,7 +178,7 @@ On self-hosted instances, you use your own AI provider's API keys, and all AI us ### Payment methods -Plane requires a payment method on file for all paid subscriptions created through the standard upgrade flow. Stripe, Plane's payment processor, doesn't allow removing all payment methods once a subscription is active. +Plane requires a payment method on file for all paid subscriptions created through the standard upgrade flow. Stripe, Plane's payment processor, doesn't allow removing all payment methods once a subscription is active. You can update your payment method anytime from **Workspace Settings > Billing and plans > Manage Subscription**. From 41b8b952d50f8563cce718a37c8c6a64616931f1 Mon Sep 17 00:00:00 2001 From: danciaclara Date: Thu, 19 Mar 2026 23:09:54 +0530 Subject: [PATCH 8/8] review fixes --- docs/workspaces-and-users/billing-and-plans.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/workspaces-and-users/billing-and-plans.md b/docs/workspaces-and-users/billing-and-plans.md index c6b58aaa..1662f355 100644 --- a/docs/workspaces-and-users/billing-and-plans.md +++ b/docs/workspaces-and-users/billing-and-plans.md @@ -14,7 +14,7 @@ Most SaaS tools charge per user. Every person who accesses the system counts tow **The per-seat model separates billing from user roles.** You purchase seats for users who need full access—Admins and Members—while users who need limited access—Guests—are not billed at all. This reflects how teams actually work. Not everyone needs the same level of access. -For example, a typical workspace might have 20 Admins and Members and 100 Guests 100 Guests spanning non-participating stakeholders, clients, contractors, and other users. With per-seat pricing, you pay for 20 seats and get 5 Guest slots per paid seat for a total 100 Guest slots. Guests cost nothing extra. This model becomes more cost-effective as your Guest population grows. +For example, a typical workspace might have 20 Admins and Members and 100 Guests spanning non-participating stakeholders, clients, contractors, and other users. With per-seat pricing, you pay for 20 seats and get 5 Guest slots per paid seat for a total 100 Guest slots. Guests cost nothing extra. This model becomes more cost-effective as your Guest population grows. :::warning Guest allocation works differently on Enterprise Grid. Since Enterprise Grid includes Granular Access Control (GAC) where any role can have any permission, the preset system-defined roles don't apply. All users at the instance level are billable seats. @@ -90,7 +90,7 @@ Proration applies to both monthly and annual billing cycles, calculated proporti ### Automatic renewals -Subscriptions renew automatically at the start of each billing cycle, monthly or annua, depending on what you selected. The renewal charge is processed through your payment method on file. +Subscriptions renew automatically at the start of each billing cycle, monthly or annual, depending on what you selected. The renewal charge is processed through your payment method on file. Stripe, Plane's payment processor, handles the renewal.