Please check gitlab-tutorial

Skip to content

GitLab Duo add-ons

DETAILS: Tier: Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

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.

  1. Sign in to the GitLab Customers Portal.
  2. On the subscription card, select the vertical ellipsis ({ellipsis_v}).
  3. Select Buy GitLab Duo Pro.
  4. Enter the number of seats for GitLab Duo.
  5. Review the Purchase summary section.
  6. From the Payment method dropdown list, select your payment method.
  7. 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.
  1. On the left sidebar, select Search or go to and find your group.
  2. Select Settings > Usage Quotas.
  3. Select the GitLab Duo tab.
  4. Select Add seats.
  5. 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.
  6. In the Billing information section, select the payment method from the dropdown list.
  7. Select the Privacy Policy and Terms of Service checkbox.
  8. Select Purchase seats.
  9. Select the GitLab SaaS tab and refresh the page.

For self-managed and GitLab Dedicated

Prerequisites:

  • You must be an administrator.
  1. Sign in to the GitLab Customers Portal.
  2. On the GitLab Duo Pro section of your subscription card select Add seats.
  3. Enter the number of seats. The amount cannot be higher than the number of seats in the subscription.
  4. Review the Purchase summary section.
  5. From the Payment method dropdown list, select your payment method.
  6. 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.

  1. On the left sidebar, select Search or go to and find your group.
  2. Select Settings > GitLab Duo.
  3. Select Assign seats on the Seat utilization card.
  4. 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.
  1. On the left sidebar, at the bottom, select Admin.
  2. Select GitLab Duo.
    • If the GitLab Duo menu item is not available, synchronize your subscription after purchase:
      1. On the left sidebar, select Subscription.
      2. In Subscription details, to the right of Last sync, select synchronize subscription ({retry}).
  3. Select Assign seats on the Seat utilization card.
  4. 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

  1. On the left sidebar, select Search or go to and find your group.
  2. Select Settings > GitLab Duo.
  3. 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.
  4. 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.
  5. 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.
  1. On the left sidebar, at the bottom, select Admin.
  2. Select GitLab Duo.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  1. On the left sidebar, select Search or go to and find your group.
  2. Select Settings > GitLab Duo.
  3. From the filter bar, select Assigned seat and Yes.
  4. 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.
  1. On the left sidebar, at the bottom, select Admin.
  2. Select GitLab Duo.
    • If the GitLab Duo menu item is not available, synchronize your subscription after purchase:
      1. On the left sidebar, select Subscription.
      2. In Subscription details, to the right of Last sync, select synchronize subscription ({retry}).
  3. To filter by users assigned to a GitLab Duo seat, in the Filter users bar, select Assigned seat, then select Yes.
  4. User list is filtered to only users assigned a GitLab Duo seat.

Start GitLab Duo Pro trial

DETAILS: Tier: Premium Offering: GitLab.com, Self-managed, GitLab Dedicated

On GitLab.com

Prerequisites:

  • You must have the Owner role for a top-level group that has an active paid Premium subscription.
  1. On the left sidebar, select Search or go to and find your group.
  2. Select Settings > Billing.
  3. Select Start a free GitLab Duo Pro trial.
  4. Complete the fields.
  5. Select Continue.
  6. If prompted, select the group that the trial should be applied to.
  7. Select Activate my trial.
  8. 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.

  1. Go to the GitLab Duo Pro trial page.

  2. Complete the fields.

    • To find your subscription name:

      1. In the Customers Portal, on the Subscriptions & purchases page, find the subscription you want to apply the trial to.

      2. At the top of the page, the subscription name appears in a badge.

        Subscription name

    • Ensure the email address you submit for trial registration matches the email address of the subscription contact.

  3. 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

DETAILS: Tier: Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

On GitLab.com

Prerequisites:

  • You must have the Owner role for a top-level group that has an active paid Ultimate subscription.
  1. On the left sidebar, select Search or go to and find your group.
  2. Select Settings > Billing.
  3. Select Start a free GitLab Duo Enterprise trial.
  4. Complete the fields.
  5. Select Continue.
  6. If prompted, select the group that the trial should be applied to.
  7. Select Activate my trial.
  8. 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.

  1. Go to the GitLab Duo Enterprise trial page.

  2. Complete the fields.

    • To find your subscription name:

      1. In the Customers Portal, on the Subscriptions & purchases page, find the subscription you want to apply the trial to.

      2. At the top of the page, the subscription name appears in a badge.

        Subscription name

    • Ensure the email you submit for trial registration matches the email of the subscription contact.

  3. 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:

  1. Users who have not yet used Code Suggestions, ordered by most recently assigned.
  2. 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.

Changes to GitLab Duo Pro and GitLab Duo Enterprise access

DETAILS: Tier: Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

Starting October 17, 2024, customers with a Premium or Ultimate subscription must have a GitLab Duo add-on to access AI-powered features.

To continue using GitLab Duo Pro or GitLab Duo Enterprise features, you can either:

  • Start a free trial
  • Purchase GitLab Duo Pro or Duo Enterprise

GitLab Duo Enterprise is available only for Ultimate subscriptions.

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.