- Purchase GitLab Duo
- Purchase additional GitLab Duo seats
- Assign GitLab Duo seats
- Assign and remove GitLab Duo seats in bulk
- View assigned GitLab Duo users
- Start GitLab Duo Pro trial
- Start GitLab Duo Enterprise trial
- Automatic seat removal
- Troubleshooting
GitLab Duo add-ons
You can purchase GitLab Duo seats to give users in your organization access to more GitLab features. GitLab Duo is only available for Premium and Ultimate customers. Access to features provided by GitLab Duo is managed through seat assignment. GitLab Duo can be assigned to any user in your group namespace or instance.
Purchase GitLab Duo
To purchase GitLab Duo Pro seats, you can use the Customers Portal, or you can contact the GitLab Sales team. To purchase GitLab Duo Enterprise, contact the GitLab Sales team.
- Sign in to the GitLab Customers Portal.
- On the subscription card, select the vertical ellipsis ().
- Select Buy GitLab Duo Pro.
- Enter the number of seats for GitLab Duo.
- Review the Purchase summary section.
- From the Payment method dropdown list, select your payment method.
- Select Purchase seats.
Purchase additional GitLab Duo seats
You can purchase additional GitLab Duo Pro or GitLab Duo Enterprise seats for your group namespace or self-managed instance. After you complete the purchase, the seats are added to the total number of GitLab Duo seats in your subscription.
Prerequisites:
- You must purchase the GitLab Duo Pro or GitLab Duo Enterprise add-on.
For GitLab.com
Prerequisites:
- You must have the Owner role.
- On the left sidebar, select Search or go to and find your group.
- Select Settings > Usage Quotas.
- Select the GitLab Duo tab.
- Select Add seats.
- In the Customers Portal, in the Add additional seats field, enter the number of seats. The amount cannot be higher than the number of seats in the subscription associated with your group namespace.
- In the Billing information section, select the payment method from the dropdown list.
- Select the Privacy Policy and Terms of Service checkbox.
- Select Purchase seats.
- Select the GitLab SaaS tab and refresh the page.
For self-managed and GitLab Dedicated
Prerequisites:
- You must be an administrator.
- Sign in to the GitLab Customers Portal.
- On the GitLab Duo Pro section of your subscription card select Add seats.
- Enter the number of seats. The amount cannot be higher than the number of seats in the subscription.
- Review the Purchase summary section.
- From the Payment method dropdown list, select your payment method.
- Select Purchase seats.
Assign GitLab Duo seats
Prerequisites:
- You must purchase a GitLab Duo add-on, or have an active GitLab Duo trial.
- For self-managed and GitLab Dedicated:
- The GitLab Duo Pro add-on is available in GitLab 16.8 and later.
- The GitLab Duo Enterprise add-on is only available in GitLab 17.3 and later.
After you purchase GitLab Duo, you can assign seats to users to grant access to the add-on.
For GitLab.com
Prerequisites:
- You must have the Owner role.
To use GitLab Duo features in any project or group, you must assign the user to a seat in at least one top-level group.
- On the left sidebar, select Search or go to and find your group.
- Select Settings > GitLab Duo.
- Select Assign seats on the Seat utilization card.
- To the right of the user, turn on the toggle to assign a GitLab Duo seat.
The user is sent a confirmation email.
For self-managed
Prerequisites:
- You must be an administrator.
- On the left sidebar, at the bottom, select Admin.
- Select GitLab Duo.
- If the GitLab Duo menu item is not available, synchronize your subscription
after purchase:
- On the left sidebar, select Subscription.
- In Subscription details, to the right of Last sync, select synchronize subscription ().
- If the GitLab Duo menu item is not available, synchronize your subscription
after purchase:
- Select Assign seats on the Seat utilization card.
- To the right of the user, turn on the toggle to assign a GitLab Duo seat.
The user is sent a confirmation email.
To turn off these emails, an administrator can disable the duo_seat_assignment_email_for_sm
feature flag.
Configure network and proxy settings
For self-managed instances, to enable GitLab Duo features, you must enable network connectivity.
Assign and remove GitLab Duo seats in bulk
You can assign or remove seats in bulk for multiple users.
For GitLab.com
- On the left sidebar, select Search or go to and find your group.
- Select Settings > GitLab Duo.
- On the bottom right, you can adjust the page display to show 50 or 100 items to increase the number of users available for selection.
- Select the users to assign or remove seats for:
- To select multiple users, to the left of each user, select the checkbox.
- To select all, select the checkbox at the top of the table.
- Assign or remove seats:
- To assign seats, select Assign seat, then Assign seats to confirm.
- To remove users from seats, select Remove seat, then Remove seats to confirm.
For self-managed
Prerequisites:
- You must be an administrator.
- You must have GitLab 17.5 or later.
- On the left sidebar, at the bottom, select Admin.
- Select GitLab Duo.
- On the bottom right, you can adjust the page display to show 50 or 100 items to increase the number of users available for selection.
- Select the users to assign or remove seats for:
- To select multiple users, to the left of each user, select the checkbox.
- To select all, select the checkbox at the top of the table.
- Assign or remove seats:
- To assign seats, select Assign seat, then Assign seats to confirm.
- To remove users from seats, select Remove seat, then Remove seats to confirm.
- To the right of the user, turn on the toggle to assign a GitLab Duo seat.
Administrators of self-managed instances can also use a Rake task to assign or remove seats in bulk.
View assigned GitLab Duo users
Prerequisites:
- You must purchase a GitLab Duo add-on, or have an active GitLab Duo trial.
After you purchase GitLab Duo, you can assign seats to users to grant access to the add-on.
For GitLab.com
Prerequisites:
- You must have the Owner role.
- On the left sidebar, select Search or go to and find your group.
- Select Settings > GitLab Duo.
- Select Assign seats on the Seat utilization card.
- From the filter bar, select Assigned seat and Yes.
- User list is filtered to only users assigned a GitLab Duo seat.
For self-managed
Prerequisites:
- You must be an administrator.
- You must have GitLab 17.5 or later.
- On the left sidebar, at the bottom, select Admin.
- Select GitLab Duo.
- If the GitLab Duo menu item is not available, synchronize your subscription
after purchase:
- On the left sidebar, select Subscription.
- In Subscription details, to the right of Last sync, select synchronize subscription ().
- If the GitLab Duo menu item is not available, synchronize your subscription
after purchase:
- Select Assign seats on the Seat utilization card.
- To filter by users assigned to a GitLab Duo seat, in the Filter users bar, select Assigned seat, then select Yes.
- User list is filtered to only users assigned a GitLab Duo seat.
Start GitLab Duo Pro trial
On GitLab.com
Prerequisites:
- You must have the Owner role for a top-level group that has an active paid Premium subscription.
- On the left sidebar, select Search or go to and find your group.
- Select Settings > Billing.
- Select Start a free GitLab Duo Pro trial.
- Complete the fields.
- Select Continue.
- If prompted, select the group that the trial should be applied to.
- Select Activate my trial.
- Assign seats to the users who need access.
On Self-managed and GitLab Dedicated
Prerequisites:
- You must have an active paid Premium subscription.
- You must have GitLab 16.8 or later and your instance must be able to synchronize your subscription data with GitLab.
- GitLab Duo requires GitLab 17.2 and later for the best user experience and results. Earlier versions might continue to work, however the experience may be degraded.
- Go to the GitLab Duo Pro trial page.
-
Complete the fields.
- To find your subscription name:
- Ensure the email address you submit for trial registration matches the email address of the subscription contact.
- Select Submit.
The trial automatically synchronizes to your instance within 24 hours. After the trial has synchronized, assign seats to users that you want to access GitLab Duo.
Start GitLab Duo Enterprise trial
On GitLab.com
Prerequisites:
- You must have the Owner role for a top-level group that has an active paid Ultimate subscription.
- On the left sidebar, select Search or go to and find your group.
- Select Settings > Billing.
- Select Start a free GitLab Duo Enterprise trial.
- Complete the fields.
- Select Continue.
- If prompted, select the group that the trial should be applied to.
- Select Activate my trial.
- Assign seats to the users who need access.
On GitLab self-managed and GitLab Dedicated
Prerequisites:
- You must have an active paid Ultimate subscription.
- You must have GitLab 17.3 or later and your instance must be able to synchronize your subscription data with GitLab.
- Go to the GitLab Duo Enterprise trial page.
-
Complete the fields.
- To find your subscription name:
- Ensure the email you submit for trial registration matches the email of the subscription contact.
- Select Submit.
The trial automatically syncs to your instance within 24 hours. After the trial has synced, assign seats to users that you want to access GitLab Duo.
Automatic seat removal
GitLab Duo add-on seats are removed automatically to ensure only eligible users have access. This happens when there are:
- Seat overages
- Blocked, banned, and deactivated users
At subscription expiration
If your subscription containing the GitLab Duo add-on expires, seat assignments are retained for 28 days. If the subscription is renewed, or a new subscription containing GitLab Duo is purchased during this 28-day window, users will be automatically re-assigned.
At the end of the 28 day grace period, seat assignments are removed and users will need to be reassigned.
For seat overages
If your quantity of purchased GitLab Duo add-on seats is reduced, seat assignments are automatically removed to match the seat quantity available in the subscription.
For example:
- You have a 50 seat GitLab Duo Pro subscription with all seats assigned.
- You renew the subscription for 30 seats. The 20 users over subscription are automatically removed from GitLab Duo Pro seat assignment.
- If only 20 users were assigned a GitLab Duo Pro seat before renewal, then no removal of seats would occur.
Seats are selected for removal based on the following criteria, in this order:
- Users who have not yet used Code Suggestions, ordered by most recently assigned.
- Users who have used Code Suggestions, ordered by least recent usage of Code Suggestions.
For blocked, banned and deactivated users
Once or twice each day, a CronJob reviews GitLab Duo seat assignments. If a user who is assigned a GitLab Duo seat becomes blocked, banned, or deactivated, their access to GitLab Duo features is automatically removed.
After the seat has been removed, it becomes available and can be re-assigned to a new user.
Troubleshooting
Unable to use the UI to assign seats to your users
On the Usage Quotas page, if you experience both of the following, you will be unable to use the UI to assign seats to your users:
- The Seats tab does not load.
-
The following error message is displayed:
An error occurred while loading billable members list.
As a workaround, you can use the GraphQL queries in this snippet to assign seats to users.