Skip to content

GitLab integration#

The GitLab integration incorporates Codacy on your existing Git provider workflows.

Depending on the configuration of the GitLab integration, Codacy can report and notify you about issues directly on your merge requests.

Enabling the GitLab integration#

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

GitLab integration

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

  1. Click the button Add integration and select GitLab 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 GitLab user to create comments on merge 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 GitLab integration#

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

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

Pull Request Status#

Adds a report to your merge requests showing whether your merge requests and coverage are up to standards or not as configured on the quality settings of your project. To see the coverage status, ensure that you enable the option Coverage in the quality settings.

Merge request status on GitLab

Pull Request Comment#

Adds comments on the lines of the merge 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.

Merge request comment on GitLab

Pull Request Summary#

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

Merge request summary on Bitbucket

Share your feedback 📢

Let us know if this page was helpful:

Thank you for the feedback!

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

If you have a question or need help, please ask our community or contact

Last modified September 6, 2021