Skip to content
This documentation applies to Codacy Self-hosted v11.0.0

For the latest updates and improvements, see the latest Cloud documentation instead.

Bitbucket integration#

The Bitbucket integration incorporates Codacy on your existing Git provider workflows by reporting issues and the analysis status directly on your pull requests.

When the integration is enabled, you can also create pull request comments and Jira issues directly from Codacy when browsing the existing issues on the repository:

Bitbucket integration for issues

Enabling the Bitbucket integration#

To enable the Bitbucket integration, open your repository Settings, tab Integrations. When you add a new repository, the integration is already enabled by default.

Bitbucket integration

If you remove the integration, you can enable it again as follows:

  1. Click the button Add integration and select Bitbucket on the list.
  2. Click the button Enable and follow the instructions.


    The user that enables the integration must have administrator access to the repository. Codacy uses this Bitbucket user to create comments on pull requests.


    We recommend that you use a dedicated service account for integrating Codacy with your repositories. This will avoid disruption of service if the user who originally enabled the integration stops having access to the repository, such as when the user leaves the team or the organization.

    For more information and instructions on how to set up a dedicated service account see Why did Codacy stop commenting on pull requests?

Configuring the Bitbucket integration#

To configure the Bitbucket integration, open your repository Settings, tab Integrations.

Depending on the options that you enable, Codacy will automatically update pull requests on Bitbucket with extra information when accepting pull requests:

Pull Request Status#

Adds a report to your pull requests showing whether your pull requests and coverage are up to standards or not as configured on the quality settings of your repository.


To get a status for coverage you must also:

To block merging pull requests that aren't up to standards see How do I block merging pull requests using Codacy as a quality gate?

Pull request status on Bitbucket

Pull Request Comment#

Adds comments on the lines of the pull request where Codacy finds new issues. Click on the links to open Codacy and see more details about the issues and how to fix them.

Pull request comment on Bitbucket

Pull Request Summary#

This feature isn't available for Bitbucket Server

Shows an overall view of the changes in the pull request, including new issues and metrics such as complexity and duplication.

Pull request summary on Bitbucket

See also#

Share your feedback 📢

Did this page help you?

Thanks for the feedback! Is there anything else you'd like to tell us about this page?

We're sorry to hear that. Please let us know what we can improve:

Alternatively, you can create a more detailed issue on our GitHub repository.

Thanks for helping improve the Codacy documentation.

If you have a question or need help please contact

Last modified November 25, 2022