> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coderabbit.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Set up Multi-Org

> Add and configure multiple organizations in CodeRabbit for Enterprise deployments.

export const AdminRoleBadge = ({tip = "This feature requires an organization owner, an admin role or the corresponding permission. Regular Members do not have access.", title = "Admin Only", cta = "View roles", href = "/management/roles", disabled = false}) => {
  return <Tooltip tip={tip} cta={cta} href={href}>
        <Badge icon="lock" color="orange" disabled={disabled || undefined}>
            {title}
        </Badge>
    </Tooltip>;
};

export const AzureBadge = ({tip = "This feature is available on Azure DevOps.", title = "Azure", cta, href, disabled = false}) => {
  return <Tooltip tip={tip} cta={cta} href={href}>
        <Badge icon="microsoft" disabled={disabled || undefined}>
            {title}
        </Badge>
    </Tooltip>;
};

export const BitbucketBadge = ({tip = "This feature is available on Bitbucket.", title = "Bitbucket", cta, href, disabled = false}) => {
  return <Tooltip tip={tip} cta={cta} href={href}>
        <Badge icon="bitbucket" disabled={disabled || undefined}>
            {title}
        </Badge>
    </Tooltip>;
};

export const GitLabBadge = ({tip = "This feature is available on GitLab.", title = "GitLab", cta, href, disabled = false}) => {
  return <Tooltip tip={tip} cta={cta} href={href}>
        <Badge icon="gitlab" disabled={disabled || undefined}>
            {title}
        </Badge>
    </Tooltip>;
};

export const GitHubBadge = ({tip = "This feature is available on GitHub and GitHub Enterprise.", title = "GitHub", cta, href, disabled = false}) => {
  return <Tooltip tip={tip} cta={cta} href={href}>
        <Badge icon="github" disabled={disabled || undefined}>
            {title}
        </Badge>
    </Tooltip>;
};

export const EnterprisePlanBadge = ({tip = "This feature is available exclusively as part of the Enterprise plan. Please refer to our pricing page for more information about our plans and features.", title = "Enterprise Plan", cta = "Read more", href = "https://coderabbit.ai/pricing", disabled = false}) => {
  return <Tooltip tip={tip} cta={cta} href={href}>
        <Badge icon="building-2" disabled={disabled || undefined}>
            {title}
        </Badge>
    </Tooltip>;
};

<EnterprisePlanBadge />

Multi-Org lets Enterprise customers manage multiple organizations inside a single CodeRabbit workspace. The current rollout is support-assisted and tied to Enterprise SSO, so use this guide when you are planning a Multi-Org onboarding with the CodeRabbit team.

## Supported platforms

Multi-Org is available on the following git platforms:

<GitHubBadge tip="GitHub and GitHub Enterprise Cloud organizations are supported." />

<GitLabBadge tip="GitLab groups are supported." />

<BitbucketBadge tip="Bitbucket Cloud workspaces are supported." />

<AzureBadge disabled tip="Azure DevOps is not yet supported for Multi-Org." />

SSO is required for all Multi-Org workspaces. Supported identity providers:

<AdminRoleBadge title="Okta SAML" tip="Okta SAML is a supported identity provider for Multi-Org SSO." cta="Setup guide" href="/management/sso/okta-saml" />

<AdminRoleBadge title="Keycloak SAML" tip="Keycloak SAML is a supported identity provider for Multi-Org SSO." cta="Setup guide" href="/management/sso/keycloak-saml" />

## Before you start

Make sure you have:

* An [Enterprise plan](/management/plans) with Multi-Org support
* A plan for [Enterprise SSO](/management/sso) and the SSO/SAML metadata your identity provider will provide
* A list of the organizations or workspaces that should live in the workspace

## Current availability

Multi-Org is currently **not self-serve**.

At this stage:

* The rollout is handled with the CodeRabbit team, not self-service
* Multi-Org onboarding is paired with Enterprise SSO

## Multi-Org setup flow

<Steps>
  <Step title="Share your SSO configuration with CodeRabbit">
    Send your SSO or SAML configuration details to the CodeRabbit team so they can prepare your Multi-Org workspace. If you are using Okta, start with the [Okta SAML setup guide](/management/sso/okta-saml), and if you are using Keycloak, start with the [Keycloak SAML setup guide](/management/sso/keycloak-saml).
  </Step>

  <Step title="CodeRabbit configures the authentication layer">
    After the required identity-provider details are received, the CodeRabbit team configures Clerk for your workspace and prepares the SSO-backed Multi-Org environment.
  </Step>

  <Step title="Choose the rollout path">
    CodeRabbit then completes one of two onboarding paths depending on your current state:

    <Tabs>
      <Tab title="Existing organizations already onboarded without SSO">
        If the customer already has organizations onboarded in CodeRabbit without SSO:

        1. CodeRabbit creates a workspace for the customer.
        2. CodeRabbit migrates the existing organizations into that workspace.
        3. CodeRabbit updates or cancels subscriptions if the migration requires billing changes.
        4. Users can then sign in to the workspace through SSO.
      </Tab>

      <Tab title="Fresh Multi-Org onboarding">
        If this is a new Enterprise rollout:

        1. CodeRabbit completes the SSO configuration for the new workspace.
        2. Users sign in through SSO.
        3. After login, they continue through the standard onboarding flow for the workspace.
      </Tab>
    </Tabs>
  </Step>
</Steps>

<Info>
  Multi-Org access is an Enterprise feature. If you are evaluating Multi-Org for the first time, contact [sales](https://www.coderabbit.ai/contact-us/sales). If you are ready to begin setup, use the [support page](/support) or your existing CodeRabbit contact to start the rollout.
</Info>

## Recommended prep for customers

Before the handoff to CodeRabbit, it helps to prepare:

* Your identity-provider metadata and SSO contact owner
* The list of organizations that should be grouped into the workspace
* Whether any of those organizations already have active CodeRabbit subscriptions
* The admin owners who should validate first login after SSO is enabled

## What's next

<CardGroup cols={1}>
  <Card title="Enterprise SSO" href="/management/sso" icon="key" horizontal>
    Review the shared SSO rollout flow and supported identity-provider guides
  </Card>

  <Card title="Okta SAML setup" href="/management/sso/okta-saml" icon="shield-check" horizontal>
    Prepare the Okta-specific SAML metadata that CodeRabbit needs for enablement
  </Card>

  <Card title="Keycloak SAML setup" href="/management/sso/keycloak-saml" icon="shield-check" horizontal>
    Prepare the Keycloak-specific SAML metadata that CodeRabbit needs for enablement
  </Card>
</CardGroup>