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

> Learn how to grant updated permissions to CodeRabbit when new features require additional GitHub access.

When CodeRabbit introduces new features, it may require additional GitHub permissions to function properly. If you see permission warnings or notice that certain features aren't working, follow this guide to update your permissions.

## When you need to update permissions

<Warning>
  If you see a permission warning in CodeRabbit or notice missing functionality,
  you likely need to approve updated permissions for the GitHub App.
</Warning>

<img src="https://mintcdn.com/coderabbit/D_rqUjBaYiE185JH/images/getting-started/assets/images/permission-warning-5ae71501a21d040a0a3142c6ae247393.png?fit=max&auto=format&n=D_rqUjBaYiE185JH&q=85&s=5e620abe3a46fb8e9c312b5f10515087" alt="Permission warning example" width="992" height="371" data-path="images/getting-started/assets/images/permission-warning-5ae71501a21d040a0a3142c6ae247393.png" />

## Update permissions

<Steps>
  <Step title="Navigate to GitHub settings">
    Go to your GitHub organization or repository settings page.
  </Step>

  <Step title="Access GitHub Apps">
    Navigate to the "GitHub Apps" or "Installed GitHub Apps" section in the
    settings sidebar.
  </Step>

  <Step title="Find CodeRabbit">
    Locate CodeRabbit in the list of installed applications.
  </Step>

  <Step title="Configure the app">
    Click the "Configure" button next to CodeRabbit.
  </Step>

  <Step title="Review and accept permissions">
    Review the new permissions being requested and click "Accept new
    permissions" to approve them. <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 updated
    permissions" width="2988" height="1414" data-path="images/getting-started/assets/images/grant-permission-25e8329e13fbfa0b9b8a9c377533b58b.png" />
  </Step>
</Steps>

<img src="https://mintcdn.com/coderabbit/D_rqUjBaYiE185JH/images/getting-started/assets/images/updated-permissions-e69565bdcc98dca8616e78f5b0cfa46a.png?fit=max&auto=format&n=D_rqUjBaYiE185JH&q=85&s=dfef0a04e858519621632748a6e97293" alt="Updated permissions" width="628" height="986" data-path="images/getting-started/assets/images/updated-permissions-e69565bdcc98dca8616e78f5b0cfa46a.png" />

## Why permissions are updated

CodeRabbit may request additional permissions for several reasons:

* **New GitHub features**: Access to recently released GitHub APIs and capabilities
* **Enhanced scanning**: Deeper repository analysis and code review features
* **Workflow automation**: Improved CI/CD integration and automated processes
* **Security enhancements**: Advanced security scanning and vulnerability detection

<Note>
  **Not an organization admin?** If you don't have admin privileges, you'll need
  to request approval from your organization administrators to update the
  permissions. Share this guide with them to expedite the process.
</Note>

## Troubleshooting

After updating permissions, CodeRabbit should have all the access it needs. If you continue experiencing issues:

<Steps>
  <Step title="Refresh your browser">
    Clear your browser cache and refresh the CodeRabbit dashboard.
  </Step>

  <Step title="Wait a few minutes">
    Permission changes may take a few minutes to propagate across GitHub's
    systems.
  </Step>

  <Step title="Contact support">
    If problems persist, reach out to our [support
    team](/support) for assistance.
  </Step>
</Steps>

<Check>
  **Need help?** Visit our [support page](/support) or join our
  [Discord community](https://discord.gg/coderabbit) for assistance.
</Check>