From 52cc87db87a59440ac50a07b872a124153b6b9da Mon Sep 17 00:00:00 2001 From: l-armstrong Date: Thu, 2 Apr 2026 17:43:05 -0400 Subject: [PATCH 01/17] feat: add doc for seat limit based plans for Clerk Billing --- docs/guides/billing/seat-limit-plans.mdx | 34 ++++++++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 docs/guides/billing/seat-limit-plans.mdx diff --git a/docs/guides/billing/seat-limit-plans.mdx b/docs/guides/billing/seat-limit-plans.mdx new file mode 100644 index 0000000000..3bc13a1acc --- /dev/null +++ b/docs/guides/billing/seat-limit-plans.mdx @@ -0,0 +1,34 @@ +--- +title: Seat Limits +description: Create plans with Seat Limits +--- + +Enabling Seat Limits on plans allows you to target plans to organizations of a specfic size. Clerk Billing will automatically manage the seat limits for you, and provide guided upgrade paths for organizations that need to purchase higher plans. +Through the tight integration of Clerk's authentication and billing capabilities, Clerk Billing is able to offer a best in class user experience for managing limits. + +## Enable Seat Limits + +To enable seat limits for your Plans: + +1. Navigate to the [**Subscription plans**](https://dashboard.clerk.com/~/billing/plans) page in the Clerk Dashboard. +1. Create a new Plan. +1. Toggle Seat-based on. +1. Enter the custom limit of maxmium number of members allowed in an organization. Unlimited members are also supported. + +## Managing Seat Limits + +### Organization inviitations + +When an organization subscribes to to any of your plans with seat limits, they'll be able to invite members to their organization up to the plan's limit, as well as revoke invitations that were already sent out. + +Once an organization reached the seat limit, they will no longer be able to invite new members to their organization. + +### Plan Change Seat Limit Behavior + +If an organization wants to switch to a seat limit based plan with a lower limit, and they are currently over that plan's member limit, they must remove members from their organization prior to switching plans. + +If an organization wants to switch from a seat limit based plan, to a non seat limit based plan, and they are currently over the membership limit that you set in orgniazations setting page in dashboard, they must remove members from their organization prior to switching plans. + +### Unlimited Seat Limits + +In order to create a seat limit based plan that's unlimited, you must have the B2B auth add-on on for your Clerk Plan. \ No newline at end of file From d251ab6fb94f442b11e86be835eb4ca45b206503 Mon Sep 17 00:00:00 2001 From: l-armstrong Date: Fri, 3 Apr 2026 14:07:39 -0400 Subject: [PATCH 02/17] fix: fix basic changes --- docs/guides/billing/seat-limit-plans.mdx | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/guides/billing/seat-limit-plans.mdx b/docs/guides/billing/seat-limit-plans.mdx index 3bc13a1acc..5a8386e2a5 100644 --- a/docs/guides/billing/seat-limit-plans.mdx +++ b/docs/guides/billing/seat-limit-plans.mdx @@ -17,18 +17,18 @@ To enable seat limits for your Plans: ## Managing Seat Limits -### Organization inviitations +### Organization invitations When an organization subscribes to to any of your plans with seat limits, they'll be able to invite members to their organization up to the plan's limit, as well as revoke invitations that were already sent out. -Once an organization reached the seat limit, they will no longer be able to invite new members to their organization. +Once an organization reaches their seat limit, they will no longer be able to invite new members to their organization. ### Plan Change Seat Limit Behavior If an organization wants to switch to a seat limit based plan with a lower limit, and they are currently over that plan's member limit, they must remove members from their organization prior to switching plans. -If an organization wants to switch from a seat limit based plan, to a non seat limit based plan, and they are currently over the membership limit that you set in orgniazations setting page in dashboard, they must remove members from their organization prior to switching plans. +If an organization wants to switch from a seat limit based plan to a non seat limit based plan, and they are currently over the default membership limit that for organizations, they must remove members from their organization prior to switching plans. -### Unlimited Seat Limits +### B2B auth add-on -In order to create a seat limit based plan that's unlimited, you must have the B2B auth add-on on for your Clerk Plan. \ No newline at end of file +In order to create a seat limit based plan that allows unlimited or higher than 20 members, you must have the B2B auth add-on enabled for your Clerk Plan. \ No newline at end of file From 93633d62fc24cfa76ed5cfadc80d6d746f6e74a4 Mon Sep 17 00:00:00 2001 From: l-armstrong Date: Fri, 3 Apr 2026 14:29:09 -0400 Subject: [PATCH 03/17] fix: change doc based on suggestions --- docs/guides/billing/seat-limit-plans.mdx | 15 +++++++++------ 1 file changed, 9 insertions(+), 6 deletions(-) diff --git a/docs/guides/billing/seat-limit-plans.mdx b/docs/guides/billing/seat-limit-plans.mdx index 5a8386e2a5..6bd0ab9351 100644 --- a/docs/guides/billing/seat-limit-plans.mdx +++ b/docs/guides/billing/seat-limit-plans.mdx @@ -3,25 +3,28 @@ title: Seat Limits description: Create plans with Seat Limits --- -Enabling Seat Limits on plans allows you to target plans to organizations of a specfic size. Clerk Billing will automatically manage the seat limits for you, and provide guided upgrade paths for organizations that need to purchase higher plans. -Through the tight integration of Clerk's authentication and billing capabilities, Clerk Billing is able to offer a best in class user experience for managing limits. +Starting today, membership limits on organizations can be granted directly by subscribing to a Clerk Billing plan, allowing organizations to purchase a higher membership limit in a self-serve fashion. +This makes it possible to target plans to organizations of specific size. For example, you may let organizations use your most affordable plan for up to ten seats, but require them to upgrade to a more expensive plan to get unlimited seats. -## Enable Seat Limits +## Create a plan with a seat limit -To enable seat limits for your Plans: +To create a plan with a seat limit: 1. Navigate to the [**Subscription plans**](https://dashboard.clerk.com/~/billing/plans) page in the Clerk Dashboard. 1. Create a new Plan. 1. Toggle Seat-based on. 1. Enter the custom limit of maxmium number of members allowed in an organization. Unlimited members are also supported. +> [!IMPORTANT] +> Plans created with seat limits cannot have the seat limit removed. Similarly, plans created without seat limits cannot have seat limits added after the plan is created. + ## Managing Seat Limits ### Organization invitations -When an organization subscribes to to any of your plans with seat limits, they'll be able to invite members to their organization up to the plan's limit, as well as revoke invitations that were already sent out. +When an organization subscribes to any of your plans with seat limits, they'll be able to invite members to their organization up to the plan's limit, as well as revoke invitations that were already sent out. -Once an organization reaches their seat limit, they will no longer be able to invite new members to their organization. +Once an organization reaches the seat limit, they will no longer be able to invite new members. ### Plan Change Seat Limit Behavior From 8c8c30358123e2892ec55f3f81375c233625dba5 Mon Sep 17 00:00:00 2001 From: l-armstrong Date: Fri, 3 Apr 2026 14:46:12 -0400 Subject: [PATCH 04/17] update the create a plan with a seat limit section --- docs/guides/billing/seat-limit-plans.mdx | 14 +++++--------- 1 file changed, 5 insertions(+), 9 deletions(-) diff --git a/docs/guides/billing/seat-limit-plans.mdx b/docs/guides/billing/seat-limit-plans.mdx index 6bd0ab9351..02facdbec4 100644 --- a/docs/guides/billing/seat-limit-plans.mdx +++ b/docs/guides/billing/seat-limit-plans.mdx @@ -10,10 +10,10 @@ This makes it possible to target plans to organizations of specific size. For ex To create a plan with a seat limit: -1. Navigate to the [**Subscription plans**](https://dashboard.clerk.com/~/billing/plans) page in the Clerk Dashboard. -1. Create a new Plan. -1. Toggle Seat-based on. -1. Enter the custom limit of maxmium number of members allowed in an organization. Unlimited members are also supported. +1. Navigate to the [New Organization plan](https://dashboard.clerk.com/~/billing/plans/new/org) page in your instance's settings. +1. Toggle on the Seat-based section. +1. If you'd like to set a limit, leave Custom limit and enter the limit. (You need to have the B2B Authentication add-on to set a limit > 20.) +1. If you'd like the plan to convey an unlimited number of seats, select Unlimited members. (You need to have the B2B Authentication add-on to select this option.) > [!IMPORTANT] > Plans created with seat limits cannot have the seat limit removed. Similarly, plans created without seat limits cannot have seat limits added after the plan is created. @@ -30,8 +30,4 @@ Once an organization reaches the seat limit, they will no longer be able to invi If an organization wants to switch to a seat limit based plan with a lower limit, and they are currently over that plan's member limit, they must remove members from their organization prior to switching plans. -If an organization wants to switch from a seat limit based plan to a non seat limit based plan, and they are currently over the default membership limit that for organizations, they must remove members from their organization prior to switching plans. - -### B2B auth add-on - -In order to create a seat limit based plan that allows unlimited or higher than 20 members, you must have the B2B auth add-on enabled for your Clerk Plan. \ No newline at end of file +If an organization wants to switch from a seat limit based plan to a non seat limit based plan, and they are currently over the default membership limit that for organizations, they must remove members from their organization prior to switching plans. \ No newline at end of file From c9142f53c395f33479c77ebde4af7d07cb282327 Mon Sep 17 00:00:00 2001 From: l-armstrong Date: Fri, 3 Apr 2026 15:11:23 -0400 Subject: [PATCH 05/17] Update plan change seat limit behavior section --- docs/guides/billing/seat-limit-plans.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/guides/billing/seat-limit-plans.mdx b/docs/guides/billing/seat-limit-plans.mdx index 02facdbec4..77b75ca6b1 100644 --- a/docs/guides/billing/seat-limit-plans.mdx +++ b/docs/guides/billing/seat-limit-plans.mdx @@ -28,6 +28,6 @@ Once an organization reaches the seat limit, they will no longer be able to invi ### Plan Change Seat Limit Behavior -If an organization wants to switch to a seat limit based plan with a lower limit, and they are currently over that plan's member limit, they must remove members from their organization prior to switching plans. +If an organization wants to switch to a plan with a seat limit and the organization has more members than allowed by the plan, they must remove members from their organization prior to switching plans. If an organization wants to switch from a seat limit based plan to a non seat limit based plan, and they are currently over the default membership limit that for organizations, they must remove members from their organization prior to switching plans. \ No newline at end of file From c429ca78c4234f8d745fe160f884e6ae6777fbcf Mon Sep 17 00:00:00 2001 From: l-armstrong Date: Fri, 3 Apr 2026 15:33:13 -0400 Subject: [PATCH 06/17] Add important informations for our users --- docs/guides/billing/seat-limit-plans.mdx | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/docs/guides/billing/seat-limit-plans.mdx b/docs/guides/billing/seat-limit-plans.mdx index 77b75ca6b1..56c51af615 100644 --- a/docs/guides/billing/seat-limit-plans.mdx +++ b/docs/guides/billing/seat-limit-plans.mdx @@ -16,7 +16,12 @@ To create a plan with a seat limit: 1. If you'd like the plan to convey an unlimited number of seats, select Unlimited members. (You need to have the B2B Authentication add-on to select this option.) > [!IMPORTANT] -> Plans created with seat limits cannot have the seat limit removed. Similarly, plans created without seat limits cannot have seat limits added after the plan is created. +> Plans created with seat limits cannot have the seat limit removed, or changed. Similarly, plans created without seat limits cannot have seat limits added after the plan is created. +> Plans with seat limits on them will have it's membership limit set to the Plan's seat limit. +> Plans without seat limits on them limit will be set to the membership limit controlled by the max member limit on the instance. +> If you move an organization that was previously on a plan with a seat limit to a plan with a lower seat limit, the organization will keep their currently provisioned seats but cannot invite anyone new until they're under the new seat limit. +> When an organization is on a seat limit plan, you cannot manually set the organization's seat limit. +> In order to have information about seat limits show up in the UI, you must have the Core 3 SDK. ## Managing Seat Limits From 4ca91d3ba8e2ea8561006c6fbc7a6cb0710c883c Mon Sep 17 00:00:00 2001 From: l-armstrong Date: Fri, 3 Apr 2026 15:41:48 -0400 Subject: [PATCH 07/17] fix linting issue --- docs/guides/billing/seat-limit-plans.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/guides/billing/seat-limit-plans.mdx b/docs/guides/billing/seat-limit-plans.mdx index 56c51af615..9113294593 100644 --- a/docs/guides/billing/seat-limit-plans.mdx +++ b/docs/guides/billing/seat-limit-plans.mdx @@ -21,13 +21,13 @@ To create a plan with a seat limit: > Plans without seat limits on them limit will be set to the membership limit controlled by the max member limit on the instance. > If you move an organization that was previously on a plan with a seat limit to a plan with a lower seat limit, the organization will keep their currently provisioned seats but cannot invite anyone new until they're under the new seat limit. > When an organization is on a seat limit plan, you cannot manually set the organization's seat limit. -> In order to have information about seat limits show up in the UI, you must have the Core 3 SDK. +> In order to have information about seat limits show up in the UI, you must have the Core 3 SDK. ## Managing Seat Limits ### Organization invitations -When an organization subscribes to any of your plans with seat limits, they'll be able to invite members to their organization up to the plan's limit, as well as revoke invitations that were already sent out. +When an organization subscribes to any of your plans with seat limits, they'll be able to invite members to their organization up to the plan's limit, as well as revoke invitations that were already sent out. Once an organization reaches the seat limit, they will no longer be able to invite new members. @@ -35,4 +35,4 @@ Once an organization reaches the seat limit, they will no longer be able to invi If an organization wants to switch to a plan with a seat limit and the organization has more members than allowed by the plan, they must remove members from their organization prior to switching plans. -If an organization wants to switch from a seat limit based plan to a non seat limit based plan, and they are currently over the default membership limit that for organizations, they must remove members from their organization prior to switching plans. \ No newline at end of file +If an organization wants to switch from a seat limit based plan to a non seat limit based plan, and they are currently over the default membership limit that for organizations, they must remove members from their organization prior to switching plans. From 35eb4b057d7379fd7a447948af322cd1ef4e69bf Mon Sep 17 00:00:00 2001 From: l-armstrong Date: Fri, 3 Apr 2026 16:11:20 -0400 Subject: [PATCH 08/17] add entry to manifest docs --- docs/guides/billing/seat-limit-plans.mdx | 2 +- docs/manifest.json | 4 ++++ 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/guides/billing/seat-limit-plans.mdx b/docs/guides/billing/seat-limit-plans.mdx index 9113294593..fe7a992a0b 100644 --- a/docs/guides/billing/seat-limit-plans.mdx +++ b/docs/guides/billing/seat-limit-plans.mdx @@ -3,7 +3,7 @@ title: Seat Limits description: Create plans with Seat Limits --- -Starting today, membership limits on organizations can be granted directly by subscribing to a Clerk Billing plan, allowing organizations to purchase a higher membership limit in a self-serve fashion. +Membership limits on organizations can now be granted directly by subscribing to a Clerk Billing plan, allowing organizations to purchase a higher membership limit in a self-serve fashion. This makes it possible to target plans to organizations of specific size. For example, you may let organizations use your most affordable plan for up to ten seats, but require them to upgrade to a more expensive plan to get unlimited seats. ## Create a plan with a seat limit diff --git a/docs/manifest.json b/docs/manifest.json index b968e857ce..3f45869b8b 100644 --- a/docs/manifest.json +++ b/docs/manifest.json @@ -564,6 +564,10 @@ "title": "Free trials", "href": "/docs/guides/billing/free-trials" }, + { + "title": "Seat limits Plans", + "href": "docs/guides/billing/seat-limit-plans" + }, { "title": "Default Plans", "href": "/docs/guides/billing/default-plans" From 71e9c90d65602a11288c8ffd5cdb8692b965058e Mon Sep 17 00:00:00 2001 From: l-armstrong Date: Fri, 3 Apr 2026 16:14:46 -0400 Subject: [PATCH 09/17] fix href --- docs/manifest.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/manifest.json b/docs/manifest.json index 3f45869b8b..1ee63b97c6 100644 --- a/docs/manifest.json +++ b/docs/manifest.json @@ -566,7 +566,7 @@ }, { "title": "Seat limits Plans", - "href": "docs/guides/billing/seat-limit-plans" + "href": "/docs/guides/billing/seat-limit-plans" }, { "title": "Default Plans", From 6604d4d6a9816a69ae789edab0487a3169e5e5fc Mon Sep 17 00:00:00 2001 From: l-armstrong Date: Fri, 3 Apr 2026 16:20:46 -0400 Subject: [PATCH 10/17] fix important section --- docs/guides/billing/seat-limit-plans.mdx | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/guides/billing/seat-limit-plans.mdx b/docs/guides/billing/seat-limit-plans.mdx index fe7a992a0b..60bb3f5e38 100644 --- a/docs/guides/billing/seat-limit-plans.mdx +++ b/docs/guides/billing/seat-limit-plans.mdx @@ -16,12 +16,12 @@ To create a plan with a seat limit: 1. If you'd like the plan to convey an unlimited number of seats, select Unlimited members. (You need to have the B2B Authentication add-on to select this option.) > [!IMPORTANT] -> Plans created with seat limits cannot have the seat limit removed, or changed. Similarly, plans created without seat limits cannot have seat limits added after the plan is created. -> Plans with seat limits on them will have it's membership limit set to the Plan's seat limit. -> Plans without seat limits on them limit will be set to the membership limit controlled by the max member limit on the instance. -> If you move an organization that was previously on a plan with a seat limit to a plan with a lower seat limit, the organization will keep their currently provisioned seats but cannot invite anyone new until they're under the new seat limit. -> When an organization is on a seat limit plan, you cannot manually set the organization's seat limit. -> In order to have information about seat limits show up in the UI, you must have the Core 3 SDK. +> - Plans created with seat limits cannot have the seat limit removed, or changed. Similarly, plans created without seat limits cannot have seat limits added after the plan is created. +> - Plans with seat limits on them will have its membership limit set to the Plan's seat limit. +> - Plans without seat limits on them limit will be set to the membership limit controlled by the max member limit on the instance. +> - If you move an organization that was previously on a plan with a seat limit to a plan with a lower seat limit, the organization will keep their currently provisioned seats but cannot invite anyone new until they're under the new seat limit. +> - When an organization is on a seat limit plan, you cannot manually set the organization's seat limit. +> - In order to have information about seat limits show up in the UI, you must have the Core 3 SDK. ## Managing Seat Limits From 3e0a0ab35d04a176b6889fd7906cf0d24c04af1a Mon Sep 17 00:00:00 2001 From: l-armstrong Date: Fri, 3 Apr 2026 16:26:54 -0400 Subject: [PATCH 11/17] fix some grammar issues --- docs/guides/billing/seat-limit-plans.mdx | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/guides/billing/seat-limit-plans.mdx b/docs/guides/billing/seat-limit-plans.mdx index 60bb3f5e38..9d38698aed 100644 --- a/docs/guides/billing/seat-limit-plans.mdx +++ b/docs/guides/billing/seat-limit-plans.mdx @@ -12,22 +12,22 @@ To create a plan with a seat limit: 1. Navigate to the [New Organization plan](https://dashboard.clerk.com/~/billing/plans/new/org) page in your instance's settings. 1. Toggle on the Seat-based section. -1. If you'd like to set a limit, leave Custom limit and enter the limit. (You need to have the B2B Authentication add-on to set a limit > 20.) +1. If you'd like to set a limit, select **Custom limit** and enter the desired value. (You need the B2B Authentication add-on to set a limit greater than 20.) 1. If you'd like the plan to convey an unlimited number of seats, select Unlimited members. (You need to have the B2B Authentication add-on to select this option.) > [!IMPORTANT] -> - Plans created with seat limits cannot have the seat limit removed, or changed. Similarly, plans created without seat limits cannot have seat limits added after the plan is created. -> - Plans with seat limits on them will have its membership limit set to the Plan's seat limit. -> - Plans without seat limits on them limit will be set to the membership limit controlled by the max member limit on the instance. +> - Plans created with seat limits cannot have the seat limit removed or changed. Similarly, plans created without seat limits cannot have seat limits added after the plan is created. +> - Plans with seat limits on them will have its membership limit set to the plan's seat limit. +> - Plans without seat limits will have their membership limit set to the instance's max member limit. > - If you move an organization that was previously on a plan with a seat limit to a plan with a lower seat limit, the organization will keep their currently provisioned seats but cannot invite anyone new until they're under the new seat limit. > - When an organization is on a seat limit plan, you cannot manually set the organization's seat limit. -> - In order to have information about seat limits show up in the UI, you must have the Core 3 SDK. +> - To display seat limit information in the UI, you must have the Core 3 SDK. ## Managing Seat Limits ### Organization invitations -When an organization subscribes to any of your plans with seat limits, they'll be able to invite members to their organization up to the plan's limit, as well as revoke invitations that were already sent out. +When an organization subscribes to a plan with seat limits, they'll be able to invite members to their organization up to the plan's limit, as well as revoke invitations that were already sent out. Once an organization reaches the seat limit, they will no longer be able to invite new members. @@ -35,4 +35,4 @@ Once an organization reaches the seat limit, they will no longer be able to invi If an organization wants to switch to a plan with a seat limit and the organization has more members than allowed by the plan, they must remove members from their organization prior to switching plans. -If an organization wants to switch from a seat limit based plan to a non seat limit based plan, and they are currently over the default membership limit that for organizations, they must remove members from their organization prior to switching plans. +If an organization wants to switch from a seat limited plan to a non seat limited plan and is currently over the default membership limit for organizations, they must remove members before switching plans. From ac26658517662531a07c6d31488e8c7d8da52b8c Mon Sep 17 00:00:00 2001 From: l-armstrong Date: Fri, 3 Apr 2026 16:30:51 -0400 Subject: [PATCH 12/17] fix linter issue --- docs/guides/billing/seat-limit-plans.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/guides/billing/seat-limit-plans.mdx b/docs/guides/billing/seat-limit-plans.mdx index 9d38698aed..eba95949fe 100644 --- a/docs/guides/billing/seat-limit-plans.mdx +++ b/docs/guides/billing/seat-limit-plans.mdx @@ -16,6 +16,7 @@ To create a plan with a seat limit: 1. If you'd like the plan to convey an unlimited number of seats, select Unlimited members. (You need to have the B2B Authentication add-on to select this option.) > [!IMPORTANT] +> > - Plans created with seat limits cannot have the seat limit removed or changed. Similarly, plans created without seat limits cannot have seat limits added after the plan is created. > - Plans with seat limits on them will have its membership limit set to the plan's seat limit. > - Plans without seat limits will have their membership limit set to the instance's max member limit. From 181e2b6c6a640fd68f5d83b30803f298fc6a69f8 Mon Sep 17 00:00:00 2001 From: l-armstrong Date: Fri, 3 Apr 2026 20:34:57 -0400 Subject: [PATCH 13/17] add Clerk SDK versions --- docs/guides/billing/seat-limit-plans.mdx | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/docs/guides/billing/seat-limit-plans.mdx b/docs/guides/billing/seat-limit-plans.mdx index eba95949fe..6832ab899d 100644 --- a/docs/guides/billing/seat-limit-plans.mdx +++ b/docs/guides/billing/seat-limit-plans.mdx @@ -22,7 +22,12 @@ To create a plan with a seat limit: > - Plans without seat limits will have their membership limit set to the instance's max member limit. > - If you move an organization that was previously on a plan with a seat limit to a plan with a lower seat limit, the organization will keep their currently provisioned seats but cannot invite anyone new until they're under the new seat limit. > - When an organization is on a seat limit plan, you cannot manually set the organization's seat limit. -> - To display seat limit information in the UI, you must have the Core 3 SDK. +> - To use seat limits, you need to be using the following Clerk SDK versions: +> - `@clerk/react` v6.1.4 or higher +> - `@clerk/nextjs` v7.0.8 or higher +> - `@clerk/expo` v3.1.6 or higher +> - `@clerk/react-router` v3.0.8 or higher +> - `@clerk/tanstack-react-start` v1.0.8 or higher ## Managing Seat Limits From 202c0503d55334e51a503dfcff9e008f4cb7adae Mon Sep 17 00:00:00 2001 From: l-armstrong Date: Fri, 3 Apr 2026 20:40:00 -0400 Subject: [PATCH 14/17] add billing beta warning --- docs/guides/billing/seat-limit-plans.mdx | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/guides/billing/seat-limit-plans.mdx b/docs/guides/billing/seat-limit-plans.mdx index 6832ab899d..76cf8ecb31 100644 --- a/docs/guides/billing/seat-limit-plans.mdx +++ b/docs/guides/billing/seat-limit-plans.mdx @@ -3,6 +3,8 @@ title: Seat Limits description: Create plans with Seat Limits --- + + Membership limits on organizations can now be granted directly by subscribing to a Clerk Billing plan, allowing organizations to purchase a higher membership limit in a self-serve fashion. This makes it possible to target plans to organizations of specific size. For example, you may let organizations use your most affordable plan for up to ten seats, but require them to upgrade to a more expensive plan to get unlimited seats. From 65eea9528d44c043d5e6d2ffe194cd0d5f19e906 Mon Sep 17 00:00:00 2001 From: l-armstrong Date: Mon, 6 Apr 2026 12:00:41 -0400 Subject: [PATCH 15/17] fix grammar --- docs/guides/billing/seat-limit-plans.mdx | 18 +++++++++--------- docs/manifest.json | 2 +- 2 files changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/guides/billing/seat-limit-plans.mdx b/docs/guides/billing/seat-limit-plans.mdx index 76cf8ecb31..a2561585b4 100644 --- a/docs/guides/billing/seat-limit-plans.mdx +++ b/docs/guides/billing/seat-limit-plans.mdx @@ -1,14 +1,14 @@ --- -title: Seat Limits -description: Create plans with Seat Limits +title: Seat limits +description: Create plans with seat limits --- Membership limits on organizations can now be granted directly by subscribing to a Clerk Billing plan, allowing organizations to purchase a higher membership limit in a self-serve fashion. -This makes it possible to target plans to organizations of specific size. For example, you may let organizations use your most affordable plan for up to ten seats, but require them to upgrade to a more expensive plan to get unlimited seats. +This makes it possible to target plans to organizations based on their specific size. For example, you may let organizations use your most affordable plan for up to ten seats, but require them to upgrade to a more expensive plan to get unlimited seats. -## Create a plan with a seat limit +## Creating a plan with a seat limit To create a plan with a seat limit: @@ -20,9 +20,9 @@ To create a plan with a seat limit: > [!IMPORTANT] > > - Plans created with seat limits cannot have the seat limit removed or changed. Similarly, plans created without seat limits cannot have seat limits added after the plan is created. -> - Plans with seat limits on them will have its membership limit set to the plan's seat limit. -> - Plans without seat limits will have their membership limit set to the instance's max member limit. -> - If you move an organization that was previously on a plan with a seat limit to a plan with a lower seat limit, the organization will keep their currently provisioned seats but cannot invite anyone new until they're under the new seat limit. +> - Organizations subscribed to plans with seat limits on them will have their membership limit set to the plan's seat limit. +> - Organizations subscribed to plans without seat limits will have their membership limit set to the instance's max member limit. This can be overridden on a per-organization basis. +> - If an organization's seat limits are forcibly lowered (e.g., their subscription ending or their plan being changed by an administrator), the organization will keep their currently provisioned seats but cannot invite new members until they're under the new seat limit. > - When an organization is on a seat limit plan, you cannot manually set the organization's seat limit. > - To use seat limits, you need to be using the following Clerk SDK versions: > - `@clerk/react` v6.1.4 or higher @@ -31,7 +31,7 @@ To create a plan with a seat limit: > - `@clerk/react-router` v3.0.8 or higher > - `@clerk/tanstack-react-start` v1.0.8 or higher -## Managing Seat Limits +## Managing seat limits ### Organization invitations @@ -39,7 +39,7 @@ When an organization subscribes to a plan with seat limits, they'll be able to i Once an organization reaches the seat limit, they will no longer be able to invite new members. -### Plan Change Seat Limit Behavior +### Changing plans If an organization wants to switch to a plan with a seat limit and the organization has more members than allowed by the plan, they must remove members from their organization prior to switching plans. diff --git a/docs/manifest.json b/docs/manifest.json index 1ee63b97c6..13e21f6e18 100644 --- a/docs/manifest.json +++ b/docs/manifest.json @@ -565,7 +565,7 @@ "href": "/docs/guides/billing/free-trials" }, { - "title": "Seat limits Plans", + "title": "Plans with seat limits", "href": "/docs/guides/billing/seat-limit-plans" }, { From c6ef37f7ad70071cf47317b19e43fed0bcabfd4b Mon Sep 17 00:00:00 2001 From: Michael Novotny Date: Mon, 6 Apr 2026 13:56:37 -0500 Subject: [PATCH 16/17] improve consistency and readability of seat-limit-plans doc - Update page title to "Plans with seat limits" to match manifest nav entry - Write a more descriptive frontmatter description instead of restating the title - Capitalize "Plan" consistently as a proper noun, matching sibling billing docs - Bold UI element labels (Seat-based, Unlimited members, New Organization plan) - Change "in your instance's settings" to "in the Clerk Dashboard" per conventions - Replace "convey" with "allow" for clearer wording on unlimited seats - Hyphenate compound adjectives: "seat-limited", "non-seat-limited" - Extract SDK version requirements from the dense IMPORTANT callout into its own section for better scannability - Fix "instance's max member limit" to "default membership limit" to match the established product term used in org configuration docs and later in this same page; added cross-reference link to the membership limits configuration section Co-Authored-By: Claude Opus 4.6 (1M context) --- docs/guides/billing/seat-limit-plans.mdx | 52 +++++++++++++----------- 1 file changed, 28 insertions(+), 24 deletions(-) diff --git a/docs/guides/billing/seat-limit-plans.mdx b/docs/guides/billing/seat-limit-plans.mdx index a2561585b4..2c1da965b2 100644 --- a/docs/guides/billing/seat-limit-plans.mdx +++ b/docs/guides/billing/seat-limit-plans.mdx @@ -1,46 +1,50 @@ --- -title: Seat limits -description: Create plans with seat limits +title: Plans with seat limits +description: Restrict organization membership by Plan tier using seat-based limits --- -Membership limits on organizations can now be granted directly by subscribing to a Clerk Billing plan, allowing organizations to purchase a higher membership limit in a self-serve fashion. -This makes it possible to target plans to organizations based on their specific size. For example, you may let organizations use your most affordable plan for up to ten seats, but require them to upgrade to a more expensive plan to get unlimited seats. +Membership limits on organizations can now be granted directly by subscribing to a Clerk Billing Plan, allowing organizations to purchase a higher membership limit in a self-serve fashion. +This makes it possible to target Plans to organizations based on their specific size. For example, you may let organizations use your most affordable Plan for up to ten seats, but require them to upgrade to a more expensive Plan to get unlimited seats. -## Creating a plan with a seat limit +## Creating a Plan with a seat limit -To create a plan with a seat limit: +To create a Plan with a seat limit: -1. Navigate to the [New Organization plan](https://dashboard.clerk.com/~/billing/plans/new/org) page in your instance's settings. -1. Toggle on the Seat-based section. +1. Navigate to the [**New Organization plan**](https://dashboard.clerk.com/~/billing/plans/new/org) page in the Clerk Dashboard. +1. Toggle on the **Seat-based** section. 1. If you'd like to set a limit, select **Custom limit** and enter the desired value. (You need the B2B Authentication add-on to set a limit greater than 20.) -1. If you'd like the plan to convey an unlimited number of seats, select Unlimited members. (You need to have the B2B Authentication add-on to select this option.) +1. If you'd like the Plan to allow an unlimited number of seats, select **Unlimited members**. (You need to have the B2B Authentication add-on to select this option.) > [!IMPORTANT] > -> - Plans created with seat limits cannot have the seat limit removed or changed. Similarly, plans created without seat limits cannot have seat limits added after the plan is created. -> - Organizations subscribed to plans with seat limits on them will have their membership limit set to the plan's seat limit. -> - Organizations subscribed to plans without seat limits will have their membership limit set to the instance's max member limit. This can be overridden on a per-organization basis. -> - If an organization's seat limits are forcibly lowered (e.g., their subscription ending or their plan being changed by an administrator), the organization will keep their currently provisioned seats but cannot invite new members until they're under the new seat limit. -> - When an organization is on a seat limit plan, you cannot manually set the organization's seat limit. -> - To use seat limits, you need to be using the following Clerk SDK versions: -> - `@clerk/react` v6.1.4 or higher -> - `@clerk/nextjs` v7.0.8 or higher -> - `@clerk/expo` v3.1.6 or higher -> - `@clerk/react-router` v3.0.8 or higher -> - `@clerk/tanstack-react-start` v1.0.8 or higher +> - Plans created with seat limits cannot have the seat limit removed or changed. Similarly, Plans created without seat limits cannot have seat limits added after the Plan is created. +> - Organizations subscribed to Plans with seat limits on them will have their membership limit set to the Plan's seat limit. +> - Organizations subscribed to Plans without seat limits will have their membership limit set to the [default membership limit](/docs/guides/organizations/configure#membership-limits). This can be overridden on a per-organization basis. +> - If an organization's seat limits are forcibly lowered (e.g., their subscription ending or their Plan being changed by an administrator), the organization will keep their currently provisioned seats but cannot invite new members until they're under the new seat limit. +> - When an organization is on a seat-limited Plan, you cannot manually set the organization's seat limit. + +## SDK version requirements + +To use seat limits, you need to be using the following Clerk SDK versions: + +- `@clerk/react` v6.1.4 or higher +- `@clerk/nextjs` v7.0.8 or higher +- `@clerk/expo` v3.1.6 or higher +- `@clerk/react-router` v3.0.8 or higher +- `@clerk/tanstack-react-start` v1.0.8 or higher ## Managing seat limits ### Organization invitations -When an organization subscribes to a plan with seat limits, they'll be able to invite members to their organization up to the plan's limit, as well as revoke invitations that were already sent out. +When an organization subscribes to a Plan with seat limits, they'll be able to invite members to their organization up to the Plan's limit, as well as revoke invitations that were already sent out. Once an organization reaches the seat limit, they will no longer be able to invite new members. -### Changing plans +### Changing Plans -If an organization wants to switch to a plan with a seat limit and the organization has more members than allowed by the plan, they must remove members from their organization prior to switching plans. +If an organization wants to switch to a Plan with a seat limit and the organization has more members than allowed by the Plan, they must remove members from their organization prior to switching Plans. -If an organization wants to switch from a seat limited plan to a non seat limited plan and is currently over the default membership limit for organizations, they must remove members before switching plans. +If an organization wants to switch from a seat-limited Plan to a non-seat-limited Plan and is currently over the default membership limit for organizations, they must remove members before switching Plans. From 977199b6e6327c9595ab341bfa582a65cecfadb7 Mon Sep 17 00:00:00 2001 From: Michael Novotny Date: Mon, 6 Apr 2026 14:08:40 -0500 Subject: [PATCH 17/17] simplify "non-seat-limited Plan" phrasing Use "a Plan without seat limits" instead of "a non-seat-limited Plan" to match the phrasing already used earlier in the same doc. Co-Authored-By: Claude Opus 4.6 (1M context) --- docs/guides/billing/seat-limit-plans.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/guides/billing/seat-limit-plans.mdx b/docs/guides/billing/seat-limit-plans.mdx index 2c1da965b2..01bf0b3c55 100644 --- a/docs/guides/billing/seat-limit-plans.mdx +++ b/docs/guides/billing/seat-limit-plans.mdx @@ -47,4 +47,4 @@ Once an organization reaches the seat limit, they will no longer be able to invi If an organization wants to switch to a Plan with a seat limit and the organization has more members than allowed by the Plan, they must remove members from their organization prior to switching Plans. -If an organization wants to switch from a seat-limited Plan to a non-seat-limited Plan and is currently over the default membership limit for organizations, they must remove members before switching Plans. +If an organization wants to switch from a seat-limited Plan to a Plan without seat limits and is currently over the default membership limit for organizations, they must remove members before switching Plans.