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

# Install Qodo on Bitbucket Cloud

> Multi-tenant and single-tenant Bitbucket Cloud install guide for Qodo automated code review.

<Note>
  * Supported from Qodo 2.2.1.
  * Available for both single-tenant and multi-tenant Qodo environments.
  * Not sure which deployment model you need? See [Install Qodo in your Git provider](/code-review/get-started/installation) for a full comparison, or [check your deployment type](/deployment-models#check-your-deployment-type).
</Note>

Qodo works natively with Bitbucket Cloud, using a Qodo Bitbucket account to post code review comments on pull requests. It relies on Bitbucket webhooks and native pull request workflows to deliver automated insights.

You can configure Qodo for selected repositories or across your entire Bitbucket workspace. Configuration typically takes around 5 minutes.

Once installed, Qodo automatically processes pull requests and delivers actionable insights, such as code reviews, descriptions, and improvement suggestions, directly within your Bitbucket workflow.

## Prerequisites

Before you begin, ensure you have:

* Access to your Qodo portal.
* A Qodo environment set up for Bitbucket Cloud. If you're unsure of your environment type, contact your Qodo Account Manager.
* System administrator access to your Bitbucket workspace.
* A dedicated email address to use for the Qodo Bitbucket account (for example, `qodo@yourcompany.com`). The account is created during the installation wizard.

## Access the Bitbucket integration

<Steps>
  <Step>
    Log in to your [Qodo portal](https://app.qodo.ai/signin).
  </Step>

  <Step>
    From the left-hand navigation menu, select **Integrations**.
  </Step>

  <Step>
    Locate the **Bitbucket** card and click **Add installation** to launch the installation wizard.
  </Step>
</Steps>

## Install Qodo on Bitbucket Cloud

<Steps>
  <Step title="Before you begin">
    You must have system administrative access in your Bitbucket workspace to complete the setup.

    1. Create a dedicated Qodo email in your company domain (e.g., `qodo@yourcompany.com`) to be used to create a Qodo Bitbucket account.
    2. Click **Next** to proceed.

    <Frame>
      <img src="https://mintcdn.com/qodo/TkOeiBHI-YSn-Amq/images/code-review/bitbucket/bb-step-1-before-you-begin.png?fit=max&auto=format&n=TkOeiBHI-YSn-Amq&q=85&s=8f61129570c084fb071c3c2de32aa1bb" alt="Bitbucket installation wizard showing Before you begin step with prerequisites and steps overview" width="1712" height="889" data-path="images/code-review/bitbucket/bb-step-1-before-you-begin.png" />
    </Frame>
  </Step>

  <Step title="Add Qodo to Bitbucket">
    Using the email you just created, add Qodo as a user in your Bitbucket workspace.

    * Click **Download Qodo logo for avatar** and save it for use in sub-step 3.

    Complete the following steps in Bitbucket:

    <Steps>
      <Step title="Invite user">
        Go to **Workspace settings → User groups**, open **Add workspace members**, and enter the Qodo email address.

        <Frame>
          <img src="https://mintcdn.com/qodo/TkOeiBHI-YSn-Amq/images/code-review/bitbucket/bb-step-2-invite-user.png?fit=max&auto=format&n=TkOeiBHI-YSn-Amq&q=85&s=b3600910c44a97db07c5a64e1d73c191" alt="Bitbucket wizard step 2 showing Add workspace members dialog with Qodo email address field" width="1073" height="741" data-path="images/code-review/bitbucket/bb-step-2-invite-user.png" />
        </Frame>
      </Step>

      <Step title="Create account">
        Accept the invitation email to create the Qodo Bitbucket account.

        <Frame>
          <img src="https://mintcdn.com/qodo/TkOeiBHI-YSn-Amq/images/code-review/bitbucket/bb-step-2-create-account.png?fit=max&auto=format&n=TkOeiBHI-YSn-Amq&q=85&s=0589c10037e9f9912aab5cd974a6e54a" alt="Bitbucket wizard step 2 showing Finish setting up your account form with Qodo email and name fields" width="1080" height="746" data-path="images/code-review/bitbucket/bb-step-2-create-account.png" />
        </Frame>
      </Step>

      <Step title="Log in with Qodo to Bitbucket">
        Log in to Bitbucket using the Qodo account credentials.

        <Frame>
          <img src="https://mintcdn.com/qodo/TkOeiBHI-YSn-Amq/images/code-review/bitbucket/bb-step-2-login-with-qodo.png?fit=max&auto=format&n=TkOeiBHI-YSn-Amq&q=85&s=d146b3a19580e7631032a365793d7b7d" alt="Bitbucket wizard step 2 showing Choose or add another account screen with Qodo account listed" width="1196" height="788" data-path="images/code-review/bitbucket/bb-step-2-login-with-qodo.png" />
        </Frame>
      </Step>
    </Steps>

    Back in the wizard, select the **Confirm Bitbucket Qodo account creation** checkbox, then click **Next**.
  </Step>

  <Step title="Install Qodo">
    Using the Qodo Bitbucket account you just created, install the Qodo app.

    <Frame>
      <img src="https://mintcdn.com/qodo/TkOeiBHI-YSn-Amq/images/code-review/bitbucket/bb-step-3-install-qodo.png?fit=max&auto=format&n=TkOeiBHI-YSn-Amq&q=85&s=6dffc877817cadbec2fe911c43e3f5da" alt="Bitbucket installation wizard showing Install Qodo step with workspace admin requirements" width="1712" height="889" data-path="images/code-review/bitbucket/bb-step-3-install-qodo.png" />
    </Frame>

    <Note>
      Requirements

      * The Qodo user must be a Bitbucket workspace admin or repo admin to complete the installation.
      * The Qodo user must be logged in to your Bitbucket workspace.
    </Note>

    * Click **Install Bitbucket App** to proceed.
  </Step>

  <Step title="Select repositories">
    Select the repositories for Qodo to review.

    <Frame>
      <img src="https://mintcdn.com/qodo/TkOeiBHI-YSn-Amq/images/code-review/bitbucket/bb-step-4-select-repositories.png?fit=max&auto=format&n=TkOeiBHI-YSn-Amq&q=85&s=e03b4442f6ecd9ed951cc3de9cb2f2ea" alt="Bitbucket installation wizard showing Select repositories step with workspace and repository tree" width="1712" height="889" data-path="images/code-review/bitbucket/bb-step-4-select-repositories.png" />
    </Frame>

    Use the search bar to find specific repositories, or browse by workspace and project. You can select individual repositories or an entire workspace.

    * Click **Setup** to continue.

    <Note>
      You can always add more repositories later by returning to this step.
    </Note>
  </Step>

  <Step title="Setup complete">
    Qodo Code Review is now active for the repositories you selected.

    <Frame>
      <img src="https://mintcdn.com/qodo/TkOeiBHI-YSn-Amq/images/code-review/bitbucket/bb-step-5-setup-complete.png?fit=max&auto=format&n=TkOeiBHI-YSn-Amq&q=85&s=d1a74ad2bcb8763160deecbeca617b6e" alt="Bitbucket installation wizard showing Setup complete screen with enabled repositories confirmation" width="1712" height="889" data-path="images/code-review/bitbucket/bb-step-5-setup-complete.png" />
    </Frame>

    The confirmation screen shows the number of connected repositories and confirms that AI code review, auto rule generation, and codebase context are active.

    * Click **Done** to finish.
  </Step>
</Steps>

Qodo is now active on the selected repositories. To add repositories, return to this wizard at any time and run a new installation with the updated scope. Repositories that already have Qodo installed are not available for selection. To reduce scope, remove the installation and create a new one.

## Verify the installation

<Steps>
  <Step>
    Open a new pull request in one of the connected repositories and confirm Qodo is triggered automatically.
  </Step>

  <Step>
    Add a comment using one of the supported commands:

    * `/agentic_describe`
    * `/agentic_review`

    Qodo should respond with a review or PR summary directly on the pull request.
  </Step>
</Steps>

## Next steps

* [Repositories page](/governance/repositories): Enable or disable Qodo on individual repositories within your current scope.
* [Using Qodo in PRs](/code-review/use-qodo-in-prs): Get the most out of Qodo.