> ## 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 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, 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." />

<Info>
  Multi-Org authentication setup is not self-serve. If your rollout requires centralized authentication, your account team will coordinate the supported identity-provider configuration with you.
</Info>

## Before you start

Make sure you have:

* An [Enterprise plan](/management/plans) with Multi-Org support
* An account-team coordinated authentication plan, including any identity-provider metadata requested by CodeRabbit
* 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 authentication setup is coordinated by the CodeRabbit team

## Multi-Org setup flow

<Steps>
  <Step title="Share authentication requirements with CodeRabbit">
    Send the authentication requirements and any requested identity-provider metadata to the CodeRabbit team so they can prepare your Multi-Org workspace.
  </Step>

  <Step title="CodeRabbit configures the authentication layer">
    After the required identity-provider details are received, the CodeRabbit team configures the authentication layer and prepares the 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">
        If the customer already has organizations onboarded in CodeRabbit:

        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 the configured authentication flow.
      </Tab>

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

        1. CodeRabbit completes the authentication configuration for the new workspace.
        2. Users sign in through the configured authentication flow.
        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 authentication 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 authentication is enabled

## What's next

<CardGroup cols={1}>
  <Card title="Roles and permissions" href="/management/roles" icon="shield-check" horizontal>
    Review how CodeRabbit roles work before planning the workspace access model
  </Card>

  <Card title="Subscription management" href="/management/billing" icon="user-cog" horizontal>
    Review billing, plan details, and seat settings for the Enterprise rollout
  </Card>

  <Card title="Support" href="/support" icon="message-circle" horizontal>
    Contact the CodeRabbit team when you are ready to start Multi-Org onboarding
  </Card>
</CardGroup>