Subscription add-ons

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

You can purchase subscription add-ons to give users in your organization access to more GitLab features. Subscription add-ons are purchased as additional seats in your subscription. Access to features provided by subscription add-ons is managed through seat assignment. Subscription add-ons can be assigned to billable users only.

Purchase GitLab Duo Pro seats

You can purchase additional GitLab Duo Pro seats for your group namespace or self-managed instance. After you complete the purchase, you must assign the seats to billable users so that they can use GitLab Duo Pro.

To purchase GitLab Duo Pro seats, you can use the Customers Portal, or you can contact the GitLab Sales team.

  1. Sign in to the GitLab Customers Portal.
  2. On the subscription card, select the vertical ellipsis ().
  3. Select Buy GitLab Duo Pro.
  4. Enter the number of seats for GitLab Duo Pro.
  5. Review the Purchase summary section.
  6. From the Payment method dropdown list, select your payment method.
  7. Select Purchase seats.

Assign GitLab Duo Pro seats

Prerequisites:

  • You must purchase the GitLab Duo Pro add-on.
  • For self-managed and GitLab Dedicated, the GitLab Duo Pro add-on is available for GitLab 16.8 and later only.

After you purchase GitLab Duo Pro, you can assign seats to billable users to grant access to the add-on.

For GitLab.com

  1. On the left sidebar, select Search or go to and find your group.
  2. Select Settings > Usage Quotas.
  3. Select the GitLab Duo Pro tab.
  4. To the right of the user, turn on the toggle to assign GitLab Duo Pro.

To use Code Suggestions in any project or group, a user must be assigned a seat in at least one top-level group.

For self-managed

Prerequisites:

  • You must be an administrator.
  1. On the left sidebar, at the bottom, select Admin Area.
  2. Select GitLab Duo Pro.
    • If the GitLab Duo Pro 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 ().
  3. To the right of the user, turn on the toggle to assign GitLab Duo Pro.

Configure network and proxy settings

For self-managed instances, to enable AI-powered features:

  • Your firewalls and HTTP/S proxy servers must allow outbound connections to cloud.gitlab.com and customers.gitlab.com on port 443 both with https:// and wws://.
  • Both HTTP2 and the 'upgrade' header must be allowed, because GitLab Duo uses both REST and WebSockets.
  • To use an HTTP/S proxy, both gitLab_workhorse and gitLab_rails must have the necessary web proxy environment variables set.
  • Check for restrictions on WebSocket (wss://) traffic to wss://gitlab.com/-/cable and other .com domains. Network policy restrictions on wss:// traffic can cause issues with some GitLab Duo Chat services. Consider policy updates to allow these services.

Assign and remove 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 > Usage Quotas.
  3. Select the GitLab Duo Pro tab.
  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

Administrators of self-managed instances can use a Rake task to assign or remove seats in bulk.

Purchase additional GitLab Duo Pro seats

You can purchase additional GitLab Duo Pro 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 Pro seats in your subscription.

Prerequisites:

  • You must purchase the GitLab Duo Pro add-on.

For GitLab.com

  1. On the left sidebar, select Search or go to and find your group.
  2. Select Settings > Usage Quotas.
  3. Select the GitLab Duo Pro 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 click Add seats button.
  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.

Start GitLab Duo Pro trial

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

On GitLab.com

Prerequisites:

  • You must have an active paid Premium or 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 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 or Ultimate subscription.
  • You must have GitLab 16.8 or later and your instance must be able to synchronize your subscription data with GitLab.
  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 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 Pro.