[GH-ISSUE #3465] Organization plugin membershipLimit option incorrectly documented #18243

Closed
opened 2026-04-15 16:39:11 -05:00 by GiteaMirror · 2 comments
Owner

Originally created by @wottpal on GitHub (Jul 19, 2025).
Original GitHub issue: https://github.com/better-auth/better-auth/issues/3465

Is this suited for github?

  • Yes, this is suited for github

To Reproduce

Image

The number of memberships a user can have in an organization.

This is wrong. What's actually enforced is the number of members an organization can have.

Current vs. Expected behavior

Current: "The number of memberships a user can have in an organization."
Expected: "The maximum number of members allowed in an organization."

What version of Better Auth are you using?

1.2.12

Provide environment information

Every environment

Which area(s) are affected? (Select all that apply)

Documentation, Types

Auth config (if applicable)

import { betterAuth } from "better-auth"
export const auth = betterAuth({
  emailAndPassword: {  
    enabled: true
  },
});

Additional context

No response

Originally created by @wottpal on GitHub (Jul 19, 2025). Original GitHub issue: https://github.com/better-auth/better-auth/issues/3465 ### Is this suited for github? - [x] Yes, this is suited for github ### To Reproduce <img width="1914" height="488" alt="Image" src="https://github.com/user-attachments/assets/189d15d0-3af9-4504-98d6-7b9c145606c6" /> > The number of memberships a user can have in an organization. This is wrong. What's actually enforced is the number of members an organization can have. * ✅ Correctly documented here: https://github.com/better-auth/better-auth/blob/93698afd456fdb94909999e14fbc7ea446b2be24/docs/content/docs/plugins/organization.mdx * ❌ Incorrectly documented here: https://github.com/better-auth/better-auth/blob/93698afd456fdb94909999e14fbc7ea446b2be24/packages/better-auth/src/plugins/organization/types.ts ### Current vs. Expected behavior Current: "The number of memberships a user can have in an organization." Expected: "The maximum number of members allowed in an organization." ### What version of Better Auth are you using? 1.2.12 ### Provide environment information ```bash Every environment ``` ### Which area(s) are affected? (Select all that apply) Documentation, Types ### Auth config (if applicable) ```typescript import { betterAuth } from "better-auth" export const auth = betterAuth({ emailAndPassword: { enabled: true }, }); ``` ### Additional context _No response_
GiteaMirror added the locked label 2026-04-15 16:39:11 -05:00
Author
Owner

@dosubot[bot] commented on GitHub (Jul 19, 2025):

You're right—the documentation in the types file is incorrect. The membershipLimit option actually sets the maximum number of members allowed in an organization, not the number of memberships a user can have. The Markdown documentation is accurate: "The maximum number of members allowed in an organization. By default, it's 100. You can set it to any number you want" (source). The type comment in types.ts should be updated to match this description (source). No other references or issues about this discrepancy were found.

To reply, just mention @dosu.


How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other  Join Discord Share on X

<!-- gh-comment-id:3092290795 --> @dosubot[bot] commented on GitHub (Jul 19, 2025): <!-- Answer --> You're right—the documentation in the types file is incorrect. The `membershipLimit` option actually sets the maximum number of members allowed in an organization, not the number of memberships a user can have. The Markdown documentation is accurate: "The maximum number of members allowed in an organization. By default, it's 100. You can set it to any number you want" [(source)](https://github.com/better-auth/better-auth/blob/8e4f9b6c6fe9b1d97b7fd6f615e0b120b47e87b0/docs/content/docs/plugins/organization.mdx). The type comment in `types.ts` should be updated to match this description [(source)](https://github.com/better-auth/better-auth/blob/8e4f9b6c6fe9b1d97b7fd6f615e0b120b47e87b0/packages/better-auth/src/plugins/organization/types.ts). No other references or issues about this discrepancy were found. <!-- Dosu Comment Footer --> *To reply, just mention [@dosu](https://go.dosu.dev/dosubot).* --- <sup>How did I do? [Good](https://app.dosu.dev/response-feedback/b7d97892-9f9f-4e38-ab7a-e0676e83fdea?feedback_type=great_response) | [Irrelevant](https://app.dosu.dev/response-feedback/b7d97892-9f9f-4e38-ab7a-e0676e83fdea?feedback_type=irrelevant_answer) | [Incorrect](https://app.dosu.dev/response-feedback/b7d97892-9f9f-4e38-ab7a-e0676e83fdea?feedback_type=incorrect_sources) | [Verbose](https://app.dosu.dev/response-feedback/b7d97892-9f9f-4e38-ab7a-e0676e83fdea?feedback_type=too_verbose) | [Hallucination](https://app.dosu.dev/response-feedback/b7d97892-9f9f-4e38-ab7a-e0676e83fdea?feedback_type=hallucination) | [Report 🐛](https://app.dosu.dev/response-feedback/b7d97892-9f9f-4e38-ab7a-e0676e83fdea?feedback_type=bug_report) | [Other](https://app.dosu.dev/response-feedback/b7d97892-9f9f-4e38-ab7a-e0676e83fdea?feedback_type=other)</sup>&nbsp;&nbsp;[![Join Discord](https://img.shields.io/badge/join-5865F2?logo=discord&logoColor=white&label=)](https://go.dosu.dev/discord-bot)&nbsp;[![Share on X](https://img.shields.io/badge/X-share-black)](https://twitter.com/intent/tweet?text=%40dosu_ai%20helped%20me%20solve%20this%20issue!&url=https%3A//github.com/better-auth/better-auth/issues/3465)
Author
Owner

@Kinfe123 commented on GitHub (Jul 22, 2025):

it is fixed via #3534

<!-- gh-comment-id:3101965587 --> @Kinfe123 commented on GitHub (Jul 22, 2025): it is fixed via #3534
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/better-auth#18243