Skip to content

Control GitLab Duo availability

GitLab Duo availability depends on your subscription add-on:

Depending on your add-on, you can turn GitLab Duo on and off for a group, project, or instance.

Change GitLab Duo Core availability

Version history

If you have the GitLab Duo Core add-on, which is included with Premium and Ultimate subscriptions, GitLab Duo Chat and Code Suggestions are available in your IDEs, and are turned on by default.

If you were an existing user with a Premium or Ultimate subscription before May 15, 2025, Chat and Code Suggestions in your IDEs are turned off by default. To turn on these features:

  1. Upgrade to GitLab 18.0 or later.
  2. Turn on the IDE features for your group or instance.

It may take up to 10 minutes for the change to take effect.

For a group

On GitLab.com, you can turn GitLab Duo Core on or off for a top-level group, but not for a subgroup or project.

Prerequisites:

  • You must have the Owner role for the top-level group.

To turn GitLab Duo Core on or off for a top-level group on GitLab.com:

  1. On the left sidebar, select Search or go to and find your top-level group.
  2. Select Settings > GitLab Duo.
  3. Select Change configuration.
  4. Below GitLab Duo Core, select or clear the Turn on IDE features checkbox.
  5. Select Save changes.

It may take up to 10 minutes for the change to take effect.

For an instance

On GitLab Self-Managed, you can turn GitLab Duo Core on or off for an instance.

Prerequisites:

  • You must be an administrator.

To turn GitLab Duo Core on or off for an instance:

  1. On the left sidebar, at the bottom, select Admin area.
  2. Select GitLab Duo.
  3. Select Change configuration.
  4. Below GitLab Duo Core, select or clear the Turn on IDE features checkbox.
  5. Select Save changes.

Change GitLab Duo Pro and Enterprise availability

Version history

For GitLab Duo Pro or Enterprise, GitLab Duo is turned on by default. For some generally available features, like Code Suggestions, you must also assign seats to the users you want to have access.

You can turn GitLab Duo on or off for a group, project, or instance.

When GitLab Duo is turned off for a group, project, or instance:

  • GitLab Duo features that access resources, like code, issues, and vulnerabilities, are not available.
  • Code Suggestions is not available.
  • GitLab Duo Chat is not available.

For a group or subgroup

In 17.8 and later

In GitLab 17.8 and later, follow these instructions to turn GitLab Duo on or off for a group, including its subgroups and projects.

Prerequisites:

  • You must have the Owner role for the group.

To turn GitLab Duo on or off for a group or subgroup:

  1. On the left sidebar, select Search or go to and find your group or subgroup.
  2. Go to the settings, based on your deployment type and group level:
    • For GitLab.com top-level groups: Select Settings > GitLab Duo and select Change configuration.
    • For GitLab.com subgroups: Select Settings > General and expand GitLab Duo features.
    • For GitLab Self-Managed (all groups and subgroups): Select Settings > General and expand GitLab Duo features.
  3. Choose an option.
  4. Select Save changes.

In 17.7

In GitLab 17.7, follow these instructions to turn GitLab Duo on or off for a group, including its subgroups and projects.

In GitLab 17.7:

  • For GitLab.com, the GitLab Duo settings page is only available for top-level groups, not for subgroups.

  • For GitLab Self-Managed, the GitLab Duo settings page is not available for groups or subgroups.

Prerequisites:

  • You must have the Owner role for the group.

To turn GitLab Duo on or off for a top-level group:

  1. On the left sidebar, select Search or go to and find your top-level group.
  2. Select Settings > GitLab Duo.
  3. Select Change configuration.
  4. Choose an option.
  5. Select Save changes.

In 17.4 to 17.6

In GitLab 17.4 to 17.6, follow these instructions to turn GitLab Duo on or off for a group and its subgroups and projects.

In GitLab 17.4 to 17.6:

  • For GitLab.com, the GitLab Duo settings page is only available for top-level groups, not for subgroups.

  • For GitLab Self-Managed, the GitLab Duo settings page is not available for groups or subgroups.

Prerequisites:

  • You must have the Owner role for the group.

To turn GitLab Duo on or off for a top-level group:

  1. On the left sidebar, select Search or go to and find your top-level group.
  2. Select Settings > GitLab Duo.
  3. Select Change configuration.
  4. Choose an option.
  5. Select Save changes.

In 17.3 and earlier

In GitLab 17.3 and earlier, follow these instructions to turn GitLab Duo on or off for a group and its subgroups and projects.

Prerequisites:

  • You must have the Owner role for the group.

To turn GitLab Duo on or off for a group or subgroup:

  1. On the left sidebar, select Search or go to and find your group or subgroup.

  2. Select Settings > General.

  3. Expand Permissions and group features.

  4. Select or clear the Use GitLab Duo features checkbox.

  5. Optional. Select the Enforce for all subgroups checkbox to cascade the setting to all subgroups.

    Cascading setting

For a project

In 17.4 and later

In GitLab 17.4 and later, follow these instructions to turn GitLab Duo on or off for a project.

Prerequisites:

  • You must have the Owner role for the project.

To turn GitLab Duo on or off for a project:

  1. On the left sidebar, select Search or go to and find your project.
  2. Select Settings > General.
  3. Expand Visibility, project features, permissions.
  4. Under GitLab Duo, turn the toggle on or off.
  5. Select Save changes.

In 17.3 and earlier

In GitLab 17.3 and earlier, follow these instructions to turn GitLab Duo on or off for a project.

  1. Use the GitLab GraphQL API projectSettingsUpdate mutation.
  2. Set the duo_features_enabled setting to true or false.

For an instance

  • Offering: GitLab Self-Managed

In 17.7 and later

In GitLab 17.7 and later, follow these instructions to turn GitLab Duo on or off for an instance.

Prerequisites:

  • You must be an administrator.

To turn GitLab Duo on or off for an instance:

  1. On the left sidebar, at the bottom, select Admin area.
  2. Select GitLab Duo.
  3. Select Change configuration.
  4. Choose an option.
  5. Select Save changes.

In 17.4 to 17.6

In GitLab 17.4 to 17.6, follow these instructions to turn GitLab Duo on or off for the instance.

Prerequisites:

  • You must be an administrator.

To turn GitLab Duo on or off for an instance:

  1. On the left sidebar, at the bottom, select Admin area.
  2. Select Settings > General.
  3. Expand GitLab Duo features.
  4. Choose an option.
  5. Select Save changes.

In 17.3 and earlier

In GitLab 17.3 and earlier, follow these instructions to turn GitLab Duo on or off for an instance.

Prerequisites:

  • You must be an administrator.

To turn GitLab Duo on or off for an instance:

  1. On the left sidebar, at the bottom, select Admin.
  2. Select Settings > General.
  3. Expand AI-powered features.
  4. Select or clear the Use Duo features checkbox.
  5. Optional. Select the Enforce for all subgroups checkbox to cascade the setting to all groups in the instance.

An issue exists to allow administrators to override the setting for specific groups or projects.

Turn on beta and experimental features

GitLab Duo features that are experimental and beta are turned off by default. These features are subject to the Testing Agreement.

On GitLab.com

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

In 17.4 and later

In GitLab 17.4 and later, follow these instructions to turn on GitLab Duo experimental and beta features for your group on GitLab.com.

In GitLab 17.4 to 17.6, you can change this setting for top-level groups only. (Subgroups do not have the required settings.) In GitLab 17.7 and later, the settings are available for all groups.

Prerequisites:

  • You must have the Owner role for the top-level group.

To turn on GitLab Duo experiment and beta features for a top-level group:

  1. On the left sidebar, select Search or go to and find your group.
  2. Select Settings > GitLab Duo.
  3. Under GitLab Duo section, select Change configuration.
  4. Select Turn on experiment and beta GitLab Duo features.
  5. Select Save changes.

In 17.3 and earlier

In GitLab 17.3 and earlier, follow these instructions to turn on GitLab Duo experimental and beta features for your group on GitLab.com.

  1. On the left sidebar, select Search or go to and find your group.
  2. Select Settings > General.
  3. Expand Permissions and group features.
  4. Under GitLab Duo experiment and beta features, select the Use experiment and beta GitLab Duo features checkbox.
  5. Select Save changes.

This setting cascades to all projects that belong to the group.

On GitLab Self-Managed

In 17.4 and later

In GitLab 17.4 and later, follow these instructions to turn on GitLab Duo experiment and beta features for your GitLab Self-Managed instance.

In GitLab 17.4 to 17.6, the GitLab Duo settings page is available for Self-Managed instances. Beginning with GitLab 17.7, the settings page includes more configuration options.

Prerequisites:

  • You must be an administrator.

To turn on GitLab Duo experiment and beta features for an instance:

  1. On the left sidebar, at the bottom, select Admin area.
  2. Select Settings > GitLab Duo.
  3. Expand Change configuration.
  4. Under Feature Preview, select Use experiment and beta GitLab Duo features.
  5. Select Save changes.

In 17.3 and earlier

To enable GitLab Duo beta and experimental features for GitLab versions where GitLab Duo Chat is not yet generally available, see the GitLab Duo Chat documentation.