Skip to content
Snippets Groups Projects

Control GitLab Duo availability

  • Tier: Premium, Ultimate
  • Add-on: GitLab Duo Core, Pro, or Enterprise
  • Offering: GitLab.com, GitLab Self-Managed

Version history

GitLab Duo is on by default when you have a subscription.

You can turn GitLab Duo on or off:

  • On GitLab.com: For top-level groups, other groups or subgroups, and projects.
  • On GitLab Self-Managed: For instances, groups or subgroups, and projects.

You can also turn GitLab Duo Core (a subset of GitLab Duo features) on or off.

Turn GitLab Duo Core on or off

Version history

  • Introduced in GitLab 18.0.
  • GitLab availability settings, and group, subgroup, and project controls added in GitLab 18.2.

If you have GitLab Duo Core, 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, when you upgrade to GitLab 18.0 or later, you have access to Chat and Code Suggestions in your IDEs, but are turned off by default. However, you can turn them on.

On GitLab.com

On GitLab.com, you can change availability for GitLab Duo Core for your top-level group (namespace).

Prerequisites:

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

To change GitLab Duo Core availability:

  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. Under GitLab Duo availability in this namespace, select an option.
  5. Under GitLab Duo Core, select or clear the Turn on IDE features checkbox. If you selected Always off for GitLab Duo availability, you cannot access this setting.
  6. Select Save changes.

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

On GitLab Self-Managed

On GitLab Self-Managed, you can change availability for GitLab Duo Core for your instance.

Prerequisites:

  • You must be an administrator.

To change GitLab Duo Core availability:

  1. On the left sidebar, at the bottom, select Admin.
  2. Select GitLab Duo.
  3. Select Change configuration.
  4. Under GitLab Duo availability in this instance, select an option.
  5. Under GitLab Duo Core, select or clear the Turn on IDE features checkbox. If you selected Always off for GitLab Duo availability, you cannot access this setting.
  6. Select Save changes.

Turn GitLab Duo on or off

GitLab Duo is on by default when you have a subscription. You can choose to change its availability for different groups and projects.

On GitLab.com

On GitLab.com, you can control GitLab Duo availability for the top-level group, other groups, subgroups, and projects.

For a top-level group

Prerequisites:

  • You must have the Owner role for the group.

To change GitLab Duo Core availability for the 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. Under GitLab Duo availability in this namespace, select an option.
  5. Select Save changes.

GitLab Duo availability changes for all subgroups and projects.

For a group or subgroup

Prerequisites:

  • You must have the Owner role for the group.

To change GitLab Duo Core availability 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 GitLab Duo features.
  4. Under GitLab Duo availability in this group, select an option.
  5. Select Save changes.

GitLab Duo availability changes for all subgroups and projects.

For a project

Prerequisites:

  • You must have the Owner role for the project.

To change GitLab Duo Core availability for a project:

  1. On the left sidebar, select Search or go to and find your project.
  2. Select Settings > General.
  3. Expand GitLab Duo.
  4. Turn the Use AI-native features in this project toggle on or off.
  5. Select Save changes.

On GitLab Self-Managed

On GitLab Self-Managed, you can control GitLab Duo availability for the instance, groups, subgroups, or projects.

For an instance

Prerequisites:

  • You must be an administrator.

To change GitLab Duo Core availability for the instance:

  1. On the left sidebar, at the bottom, select Admin.
  2. Select GitLab Duo.
  3. Select Change configuration.
  4. Under GitLab Duo availability in this instance, select an option.
  5. Select Save changes.

GitLab Duo availability changes for the entire instance.

For a group or subgroup

Prerequisites:

  • You must have the Owner role for the group or subgroup.

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 GitLab Duo features.
  4. Under GitLab Duo availability in this group, select an option.
  5. Select Save changes.

GitLab Duo availability changes for all subgroups and projects.

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 GitLab Duo.
  4. Turn the Use AI-native features in this project toggle on or off.
  5. Select Save changes.

GitLab Duo availability changes for the project.

For earlier GitLab versions

For information on how to turn GitLab Duo on of off in earlier GitLab versions, see Control GitLab Duo availability for earlier GitLab versions.

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. Under Feature preview, 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.