clerk-orgs

SKILL.md

Organizations (B2B SaaS)

STOP — prerequisite. Organizations must be enabled before any org-related API, hook, or component works. Two paths: (1) Dashboard → Organizations settings, or (2) clerk enable orgs (see "Agent-first: Programmatic org management" below). Pick the Membership mode deliberately: Membership required (default since 2025-08-22) routes signed-in users through the choose-organization task and disables personal accounts, while Membership optional keeps personal accounts available for B2C + B2B coexistence. Pick optional if you need personal subscriptions alongside org subscriptions.

Version: This skill targets current SDKs (@clerk/nextjs v7+, @clerk/react v6+ — Core 3). Core 2 differences are noted inline with > **Core 2 ONLY (skip if current SDK):** callouts — see clerk skill for the full version table.

Should this app use Organizations?

Decide before enabling anything. Read the project, count the signals, then ask the developer - do not enable Organizations silently.

Signals this app is multi-tenant (recommend Organizations):

A model that groups users: Team, Workspace, Tenant, Company, Account

The same foreign key on most tables: workspace_id, team_id, account_id

Routes scoped to a tenant: /[workspace], /[slug]/settings, /t/:tenantId

"Invite your team", "members", "seats", or "admin" in UI copy or the README

A *_members join table, or hand-rolled role / permission columns

Per-seat or per-company pricing