> ## 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.

# Add organizations

> Learn how to add new organizations to CodeRabbit and grant the necessary permissions to enable code review across your organization's repositories.

Adding organizations to CodeRabbit allows you to extend code review capabilities across repositories within your organization. You can start this flow from the organization switcher when you add an organization, or when you select an organization that does not have repositories connected yet.

## How to add organizations

Follow these steps to add a new organization to your CodeRabbit account:

<Steps>
  <Step title="Navigate to change organization">
    Go to [app.coderabbit.ai](https://app.coderabbit.ai) and ensure you're
    logged in to your account.
  </Step>

  <Step title="Refresh organization list">
    Click the **Refresh** button next to your organizations list to check for
    new organizations that you have access to. <img src="https://mintcdn.com/coderabbit/D_rqUjBaYiE185JH/images/getting-started/assets/images/check-for-new-orgs-737f894deedee730a79c1123011dc31c.png?fit=max&auto=format&n=D_rqUjBaYiE185JH&q=85&s=7c2836802597279131b52f1bceaf3a98" alt="Checking for new
    organizations" width="1286" height="512" data-path="images/getting-started/assets/images/check-for-new-orgs-737f894deedee730a79c1123011dc31c.png" />

    If a newly added organization or its repositories do not appear immediately after you return from GitHub, use **Refresh organization list** again or retry the add flow. CodeRabbit preserves your place while setup is active. If setup is not completed promptly (about 30 minutes), restart **Add organization**.
  </Step>

  <Step title="Select organization">
    Find the organization you want to add in the list of available
    organizations.
  </Step>

  <Step title="Grant permissions">
    Click the **Grant** button next to the organization name to authorize
    CodeRabbit access. <img src="https://mintcdn.com/coderabbit/D_rqUjBaYiE185JH/images/getting-started/assets/images/grant-permission-25e8329e13fbfa0b9b8a9c377533b58b.png?fit=max&auto=format&n=D_rqUjBaYiE185JH&q=85&s=42a0e99ce39a1e2560f3e1c256210d09" alt="Granting permission to
    organization" width="2988" height="1414" data-path="images/getting-started/assets/images/grant-permission-25e8329e13fbfa0b9b8a9c377533b58b.png" />
  </Step>

  <Step title="Complete GitHub setup">
    After granting CodeRabbit organization access, continue through the GitHub setup steps that CodeRabbit opens for the organization:

    1. **Grant GitHub bot access** - Authorize CodeRabbit bot access on GitHub. This permission enables CodeRabbit write actions, such as opening pull requests or posting commit statuses, when a workflow requires them.
    2. **Select repositories** - Choose which repositories CodeRabbit can access from the GitHub App repository-selection page.
  </Step>
</Steps>

## What permissions does CodeRabbit need?

When you grant CodeRabbit access to an organization, it receives the following permissions:

* **Read organization and team membership** - To understand your team structure
* **Read organization projects** - To access repositories for code review
* **Access user email addresses (read-only)** - For notifications and user identification

<Info>
  Organizations control which applications are allowed to access their private data. You may need organization admin approval to complete this process.

  If you don't see the **Grant** button, contact your organization administrator to approve CodeRabbit's application request. An organization's IP allow list can also block access; see [GitHub troubleshooting](/platforms/github-com#troubleshooting).
</Info>

After the organization is added, manage which repositories CodeRabbit can access from [Repository settings](/guides/repository-settings).

## What's next

Once you've successfully added your organization, you can:

* [Configure CodeRabbit](/getting-started/yaml-configuration) for your organization's specific needs
* [Manage your subscription](/management/subscription-management) to ensure adequate seats for your team
* [Set up repository-specific settings](/guides/repository-settings) for fine-tuned control