Updates docs for new pricing and terminology changes #3052
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
SarahSoutoul
requested review from
alexisintech,
chanioxaris,
manovotny and
octoper
alexisintech
reviewed
Feb 6, 2026
| The Organization that a user is currently viewing is called the **Active Organization**. The Active Organization determines which Organization-specific data the user can access and which Role and related Permissions they have within the Organization. | ||
|
|
||
| Clerk measures Organization usage through **Monthly Active Organizations (MAOs)**. An MAO is an Organization with at least two users that have signed in that month, where at least one has interacted with the Organization during the current billing cycle. Free plans include up to 50 MAOs in development and 100 in production. Pro plans offer unlimited development MAOs and start at 100 free production MAOs, then $1 per additional MAO. Refer to the [pricing page](/pricing){{ target: '_blank' }} for complete details. | ||
| Clerk measures Organization usage through **Monthly Retained Organizations (MROs)**. An MRO is an Organization with at least two members, where at least one member is a retained user. Free plans include up to 50 MROs in development and 100 in production. Pro plans offer unlimited development MROs and start at 100 free production MROs, then $1 per additional MRO. Refer to the [pricing page](/pricing){{ target: '_blank' }} for complete details. |
Member
There was a problem hiding this comment.
Suggested change
| Clerk measures Organization usage through **Monthly Retained Organizations (MROs)**. An MRO is an Organization with at least two members, where at least one member is a retained user. Free plans include up to 50 MROs in development and 100 in production. Pro plans offer unlimited development MROs and start at 100 free production MROs, then $1 per additional MRO. Refer to the [pricing page](/pricing){{ target: '_blank' }} for complete details. | |
| Clerk measures Organization usage through **Monthly Retained Organizations (MROs)**. An MRO is an Organization with at least two members, where at least one member is a [Monthly Retained User](!mru). Free plans include up to 50 MROs in development and 100 in production. Pro plans offer unlimited development MROs and start at 100 free production MROs, then $1 per additional MRO. Refer to the [pricing page](/pricing){{ target: '_blank' }} for complete details. |
Member
There was a problem hiding this comment.
also it's not the pro plan that offers those org features, its the enhanced B2B Authentication add-on.
imo, i think we should just say something like:
Free plans include up to 50 MROs in development and 100 in production. To increase these limits, refer to the [pricing page](/pricing){{ target: '_blank' }}.and avoid replicating pricing details in the docs. because /pricing is canonical, and /docs can get outdated from that
Co-authored-by: Alexis Aguilar <98043211+alexisintech@users.noreply.github.com>
Member
|
@SarahSoutoul One more change in: clerk.com/docs/pr/ss-update-docs-new-pricing/guides/organizations/configure 
It should be "with/without B2B Authentication add-on", instead of free/pro plans. |
alexisintech
reviewed
Feb 9, 2026
alexisintech
approved these changes
Feb 9, 2026
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
🔎 Previews:
What does this solve? What changed?
A pricing update came out yesterday, and this PR applies changes and adds documentation for any new pricing and terminology changes.
What did I do:
Changed all mentions of Monthly Active Organizations to Monthly Retained Organizations + changed the description accordingly using the pricing page info.
Updated the note referring to Monthly Active Users to refer to Monthly Retained Users + added the limit in place of 50000 MRUs, addressing the following change in the changelog.
The removal of Enhanced Authentication Add-on has already been addressed in this previous PR, which tackles this change.
Added a note for 5 user impersonations per month being free now to address this change
For this change, I understand Entreprise Connections are now metered but it doesn't say much about the limit. In the docs, we say
For development instances, Enterprise connections are always free but limited to a maximum of 25., so that might need changing. But will investigate what that change means.Deadline
Urgent
Other resources
Changelog: https://clerk.com/changelog/2026-02-05-new-plans-more-value
Linear: https://linear.app/clerk/issue/DOCS-11475/update-documentation-for-new-pricing-and-terminology-changes
Pricing page: https://clerk.com/pricing
Previous PRs that have applied some changes already: