Control GitLab Duo (Classic) availability
- Tier: Premium, Ultimate
- Add-on: GitLab Duo Core, Pro, or Enterprise
- Offering: GitLab.com, GitLab Self-Managed
GitLab Duo (Classic) is on by default. GitLab Duo includes a set of features.
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.
Turn GitLab Duo on or off
On GitLab.com
For a top-level group
Prerequisites:
- The Owner role for the top-level group.
To change GitLab Duo availability for a top-level group:
- On the top bar, select Search or go to and find your top-level group.
- Select Settings > GitLab Duo.
- Select Change configuration.
- Under GitLab Duo availability, select an option.
- Select Save changes.
GitLab Duo availability changes for all subgroups and projects.
For a group or subgroup
Prerequisites:
- The Owner role for the group or subgroup.
To change GitLab Duo availability for a group or subgroup:
- On the top bar, select Search or go to and find your group or subgroup.
- Select Settings > General.
- Expand GitLab Duo features.
- Under GitLab Duo availability, select an option.
- Select Save changes.
GitLab Duo availability changes for all subgroups and projects.
For a project
Prerequisites:
- The Owner or Maintainer role for the project.
To change GitLab Duo availability for a project:
- On the top bar, select Search or go to and find your project.
- Select Settings > General.
- Expand GitLab Duo.
- Turn the Use AI-native features in this project toggle on or off.
- Select Save changes.
On GitLab Self-Managed
For an instance
Prerequisites:
- Administrator access.
To change GitLab Duo availability for an instance:
- In the upper-right corner, select Admin.
- On the left sidebar, select GitLab Duo.
- Select Change configuration.
- Under GitLab Duo availability, select an option.
- Select Save changes.
For a group or subgroup
Prerequisites:
- The Owner role for the group or subgroup.
To change GitLab Duo availability for a group or subgroup:
- On the top bar, select Search or go to and find your group or subgroup.
- Select Settings > General.
- Expand GitLab Duo features.
- Under GitLab Duo availability, select an option.
- Select Save changes.
GitLab Duo availability changes for all subgroups and projects.
For a project
Prerequisites:
- The Owner or Maintainer role for the project.
To change GitLab Duo availability for a project:
- On the top bar, select Search or go to and find your project.
- Select Settings > General.
- Expand GitLab Duo.
- Turn the Use AI-native features in this project toggle on or off.
- Select Save changes.
For earlier GitLab versions
For information on how to turn GitLab Duo on or off in earlier GitLab versions, see control GitLab Duo (Classic) availability for earlier GitLab versions.
Turn GitLab Duo Core on or off
GitLab Duo Core is included with Premium and Ultimate subscriptions.
- If you are an existing customer from GitLab 17.11 or earlier, you must turn on features for GitLab Duo Core.
- If you are a new customer in GitLab 18.0 or later, GitLab Duo Core is automatically turned on and no further action is needed.
If you were an existing customer with a Premium or Ultimate subscription before May 15, 2025, when you upgrade to GitLab 18.0 or later, to use GitLab Duo Core, you must turn it on.
On GitLab.com
Prerequisites:
- The Owner role for the top-level group.
To change GitLab Duo Core availability for a top-level group:
- On the top bar, select Search or go to and find your top-level group.
- Select Settings > GitLab Duo.
- Select Change configuration.
- Under GitLab Duo availability, select an option.
- Under GitLab Duo Core, select or clear the Turn on features for GitLab Duo Core checkbox. If you selected Always off for GitLab Duo availability, you cannot access this setting.
- Select Save changes.
It might take up to 10 minutes for the change to take effect.
On GitLab Self-Managed
Prerequisites:
- Administrator access.
To change GitLab Duo Core availability for an instance:
- In the upper-right corner, select Admin.
- On the left sidebar, select GitLab Duo.
- Select Change configuration.
- Under GitLab Duo availability, select an option.
- Under GitLab Duo Core, select or clear the Turn on features for GitLab Duo Core checkbox. If you selected Always off for GitLab Duo availability, you cannot access this setting.
- Select Save changes.
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
Prerequisites:
- The Owner role for the top-level group.
To turn on GitLab Duo experiment and beta features for a top-level group:
- On the top bar, select Search or go to and find your group.
- Select Settings > GitLab Duo.
- Select Change configuration.
- Under Feature preview, select Turn on experiment and beta GitLab Duo features.
- Select Save changes.
This setting cascades to all projects that belong to the group.
On GitLab Self-Managed
In GitLab 17.4 and later, follow these instructions to turn on GitLab Duo experiment and beta features for your GitLab Self-Managed instance.
Prerequisites:
- Administrator access.
To turn on GitLab Duo experiment and beta features for an instance:
- In the upper-right corner, select Admin.
- Select Settings > GitLab Duo.
- Expand Change configuration.
- Under Feature preview, select Use experiment and beta GitLab Duo features.
- Select Save changes.
Prerequisites:
- Administrator access.
- Network connectivity enabled.
- Silent Mode turned off.
To turn on GitLab Duo experiment and beta features for an instance:
In the upper-right corner, select Admin.
Select Settings > GitLab Duo.
Expand Change configuration.
Under Feature preview, select Use experiment and beta GitLab Duo features.
Select Save changes.
For GitLab Duo Chat to work immediately, manually synchronize your subscription.
If you do not manually synchronize your subscription, it might take up to 24 hours to activate GitLab Duo Chat on your instance.