Control GitLab Duo availability

GitLab Duo 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.
• On GitLab Dedicated: Administrators can also lock specific subgroups to Always off so that users with the Owner role cannot enable GitLab Duo in those subgroups.

Lock GitLab Duo on

Turn GitLab Duo on for all users, regardless of group or project settings.

When you set GitLab Duo availability to Always on, experiment and beta features are not automatically turned on. To use experiment and beta features, you must turn them on separately.

Lock GitLab Duo off for selected subgroups

As a GitLab Dedicated administrator, you can lock specific subgroups to Always off for GitLab Duo and GitLab Duo Agent Platform. Users with the Owner role in those subgroups cannot enable GitLab Duo, while other subgroups remain under owner control.

The lock applies to the subgroup and all its descendant groups and projects. Users with the Owner role for the subgroup or its descendants cannot change this setting. Affected owners see a message that GitLab Duo is locked by a parent group.

Only one lock can exist in any chain of ancestor and descendant groups. When you lock a subgroup:

• If an ancestor group already has an lock, the lock is not applied. You must clear the lock from the ancestor group first.
• If one or more descendant subgroups already have admin locks, you are prompted to confirm. When you confirm, the locks on those descendant subgroups are cleared, and the lock is applied to the subgroup you selected.

Lock a subgroup

Prerequisites:

• Administrator access on a GitLab Dedicated instance.

To lock GitLab Duo off for a subgroup:

1. In the upper-right corner, select Admin.
2. In the left sidebar, select GitLab Duo.
3. In the Namespace availability overrides section, find the subgroup.
4. In the row for the subgroup, under GitLab Duo availability, select Always off.

Clear the lock for a subgroup

Prerequisites:

• Administrator access on a GitLab Dedicated instance.

To clear the admin lock for a subgroup:

1. In the upper-right corner, select Admin.
2. In the left sidebar, select GitLab Duo.
3. In the Namespace availability overrides section, find the subgroup.
4. In the row for the subgroup, select Reset.

The subgroup returns to the instance default. Users with the Owner role for the subgroup can now control GitLab Duo availability.

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:

1. In the top bar, 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, select an option.
5. 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:

1. In the top bar, 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, select an option.
5. Select Save changes.

GitLab Duo availability changes for all subgroups and projects.

For a project

Prerequisites:

• The Maintainer or Owner role for the project.

To change GitLab Duo availability for a project:

1. In the top bar, select Search or go to and find your project.
2. In the left sidebar, select Settings > General.
3. Expand GitLab Duo.
4. Turn the GitLab Duo toggle on or off.
5. Select Save changes.

On GitLab Self-Managed

For an instance

Prerequisites:

• Administrator access.

To change GitLab Duo availability for an instance:

1. In the upper-right corner, select Admin.
2. In the left sidebar, select GitLab Duo.
3. Select Change configuration.
4. Under GitLab Duo availability, select an option.
5. 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:

1. In the top bar, 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, select an option.
5. Select Save changes.

GitLab Duo availability changes for all subgroups and projects.

For a project

Prerequisites:

• The Maintainer or Owner role for the project.

To change GitLab Duo availability for a project:

1. In the top bar, select Search or go to and find your project.
2. In the left sidebar, select Settings > General.
3. Expand GitLab Duo.
4. Turn the GitLab Duo toggle on or off.
5. 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 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:

1. In the top bar, 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, select an option.
5. 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.
6. 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:

1. In the upper-right corner, select Admin.
2. In the left sidebar, select GitLab Duo.
3. Select Change configuration.
4. Under GitLab Duo availability, select an option.
5. 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.
6. 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:

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

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

On GitLab Self-Managed