Project integrations

  • Tier: Free, Premium, Ultimate
  • Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

For administrator documentation, see project integration administration.

You can integrate with external applications to add functionality to GitLab.

You can view and manage integrations for the:

You can use:

Manage group default settings for a project integration

Prerequisites:

  • You must have the Owner role for the group.

To manage the group default settings for a project integration:

  1. In the top bar, select Search or go to and find your group.
  2. In the left sidebar, select Settings > Integrations.
  3. Select an integration.
  4. Complete the fields.
  5. Select Save changes.

This might affect all or most of the subgroups and projects belonging to the group. Review the details below.

If this is the first time you are setting up group settings for an integration:

  • The integration is enabled for all subgroups and projects belonging to the group that don’t already have this integration configured, if you have the Enable integration toggle turned on in the group settings.
  • Subgroups and projects that already have the integration configured are not affected, but can choose to use the inherited settings at any time.

When you make further changes to the group defaults:

  • They are immediately applied to all subgroups and projects belonging to the group that have the integration set to use default settings.
  • They are immediately applied to newer subgroups and projects, even those created after you last saved defaults for the integration. If your group default setting has the Enable integration toggle turned on, the integration is automatically enabled for all such subgroups and projects.
  • Subgroups and projects with custom settings selected for the integration are not immediately affected and may choose to use the latest defaults at any time.

If instance settings have also been configured for the same integration, projects in the group inherit settings from the group.

Only the entire settings for an integration can be inherited. Per-field inheritance is proposed in epic 2137.

Remove a group default setting

Prerequisites:

  • You must have the Owner role for the group.

To remove a group default setting:

  1. In the top bar, select Search or go to and find your group.
  2. In the left sidebar, select Settings > Integrations.
  3. Select an integration.
  4. Select Reset and confirm.

Resetting a group default setting removes integrations that use default settings and belong to a project or subgroup of the group.

Use instance or group default settings for a project integration

Prerequisites:

  • You must have the Maintainer or Owner role for the project.

To use instance or group default settings for a project integration:

  1. In the top bar, select Search or go to and find your project.
  2. In the left sidebar, select Settings > Integrations.
  3. Select an integration.
  4. On the right, from the dropdown list, select Use default settings.
  5. Under Enable integration, ensure the Active checkbox is selected.
  6. Complete the fields.
  7. Select Save changes.

Use custom settings for a project or group integration

Prerequisites:

  • You must have the Maintainer or Owner role for the project integration.
  • You must have the Owner role for the group integration.

To use custom settings for a project or group integration:

  1. In the top bar, select Search or go to and find your project or group.
  2. In the left sidebar, select Settings > Integrations.
  3. Select an integration.
  4. On the right, from the dropdown list, select Use custom settings.
  5. Under Enable integration, ensure the Active checkbox is selected.
  6. Complete the fields.
  7. Select Save changes.

Available integrations

The following integrations can be available on a GitLab instance. If an instance administrator has configured an integration allowlist, only those integrations are available.

CI/CD