Manage subscription

Buy a subscription

You can buy a subscription for GitLab.com or GitLab Self-Managed.

For GitLab.com

A GitLab.com subscription applies to a top-level group. Members of every subgroup and project in the group:

• Can use the features of the subscription.
• Consume seats in the subscription.

To subscribe to GitLab.com:

1. View the GitLab.com feature comparison and decide which tier you want.
2. Create a user account for yourself by using the sign up page.
3. Create a group. Your subscription tier applies to the top-level group, its subgroups, and projects.
4. Create additional users and add them to the group. The users in this group, its subgroups, and projects can use the features of your subscription tier, and they consume a seat in your subscription.
5. On the left sidebar, select Settings > Billing and choose a tier. You are taken to the Customers Portal.
6. Fill out the form to complete your purchase.

For GitLab Self-Managed

To subscribe to GitLab for a GitLab Self-Managed instance:

1. Go to the Pricing page and select a self-managed plan. You are redirected to the Customers Portal to complete your purchase.
2. After purchase, an activation code is sent to the email address associated with the Customers Portal account. You must add this code to your GitLab instance.

View subscription

For GitLab.com

Prerequisites:

• You must have the Owner role for the group.

To see the status of your GitLab.com subscription:

1. On the left sidebar, select Search or go to and find your group.
2. Select Settings > Billing.

The following information is displayed:

For GitLab Self-Managed

Prerequisites:

• You must be an administrator.

You can view the status of your subscription:

1. On the left sidebar, at the bottom, select Admin.
2. Select Subscription.

The Subscription page includes the following information:

• Licensee
• Plan
• When it was uploaded, started, and when it expires
• Number of users in subscription
• Number of billable users
• Maximum users
• Number of users over subscription

Upgrade subscription tier

To upgrade your GitLab tier:

1. Sign in to the Customers Portal.
2. Select Upgrade plan on the relevant subscription card.
3. Confirm the active form of payment, or add a new form of payment.
4. Select the I accept the Privacy Statement and Terms of Service checkbox.
5. Select Upgrade subscription.

The following is emailed to you:

• A payment receipt. You can also access this information in the Customers Portal under Invoices.
• On GitLab Self-Managed, a new activation code for your license.

On GitLab Self-Managed, the new tier takes effect on the next subscription sync. You can also synchronize your subscription manually to upgrade right away.

Expired subscription

Subscriptions expire at the start of the expiration date, 00:00 server time.

For example, if a subscription is valid from January 1, 2024 until January 1, 2025:

• It expires at 11:59:59 PM UTC December 31, 2024.
• It is considered expired from 12:00:00 AM UTC January 1, 2025.
• The grace period of 14 days starts at 12:00:00 AM UTC January 1, 2025 and ends at 11:59:59 PM UTC January 14, 2025.

For GitLab.com

When your subscription expires, you can continue to use paid features of GitLab for 14 days. After 14 days, paid features are no longer available, but you can continue to use free features. To resume paid feature functionality, purchase a new subscription.

For GitLab Self-Managed

When your license expires, after a 14 day grace period:

• Your instance becomes read-only.
• GitLab locks features, such as Git pushes and issue creation.
• An expiration message is displayed to all instance administrators.

After your license has expired:

• To resume functionality, activate a new subscription.
• To keep using Free tier features only, remove the expired license.

Subscription data synchronization

Prerequisites:

• GitLab Enterprise Edition (EE).
• Connection to the internet, and must not have an offline environment.
• Activated your instance with an activation code.

Your subscription data is automatically synchronized once a day between your GitLab Self-Managed instance and GitLab.

At approximately 3:00 AM (UTC), this daily synchronization job sends subscription data to the Customers Portal. For this reason, updates and renewals might not apply immediately.

The data is sent securely through an encrypted HTTPS connection to customers.gitlab.com on port 443. If the job fails, it retries up to 12 times over approximately 17 hours.

After you have set up automatic data synchronization, the following processes are also automated.

• Quarterly subscription reconciliation.
• Subscription renewals.
• Subscription updates, such as adding more seats or upgrading a GitLab tier.

Manually synchronize subscription data

You can also manually synchronize subscription data at any time.

1. On the left sidebar, at the bottom, select Admin.
2. Select Subscription.
3. In the Subscription details section, select Sync ( ).

A synchronization job is then queued. When the job finishes, the subscription details are updated.

Subscription data

The daily synchronization job sends the following information to the Customers Portal:

• Date
• Timestamp
• License key, with the following encrypted within the key:
  • Company name
  • Licensee name
  • Licensee email
• Historical maximum user count
• Billable users count
• GitLab version
• Hostname
• Instance ID

Additionally, we also send add-on metrics such as:

• Add-on type
• Purchased seats
• Assigned seats

Example of a license sync request:

{
  "gitlab_version": "14.1.0-pre",
  "timestamp": "2021-06-14T12:00:09Z",
  "date": "2021-06-14",
  "license_key": "XXX",
  "max_historical_user_count": 75,
  "billable_users_count": 75,
  "hostname": "gitlab.example.com",
  "instance_id": "9367590b-82ad-48cb-9da7-938134c29088",
  "add_on_metrics": [
    {
      "add_on_type": "duo_enterprise",
      "purchased_seats": 100,
      "assigned_seats": 50
    }
  ]
}

Link subscription to a group

To change the group linked to a GitLab.com subscription:

1. Sign in to the Customers Portal with a linked GitLab.com account.

2. Do one of the following:

   • If the subscription is not linked to a group, select Link subscription to a group.
   • If the subscription is already linked to a group, select Subscription actions ( ) > Change linked group.

3. Select the desired group from the New Namespace dropdown list. For a group to appear here, you must have the Owner role for that group.

4. If the total number of users in your group exceeds the number of seats in your subscription, you are prompted to pay for the additional users. Subscription charges are calculated based on the total number of users in a group, including its subgroups and nested projects.

   If you purchased your subscription through an authorized reseller, you are unable to pay for additional users. You can either:

   • Remove additional users, so that no overage is detected.
   • Contact the partner to purchase additional seats now or at the end of your subscription term.

5. Select Confirm changes.

Only one namespace can be linked to a subscription.

For a demo, see Linking GitLab Subscription to the Namespace.

Transfer restrictions

You can change the linked namespace, however this is not supported for all subscription types.

You cannot transfer:

• An expired or trial subscription.
• A subscription with compute minutes which is already linked to a namespace.
• A subscription with a Premium or Ultimate plan to a namespace which already has a Premium or Ultimate plan.
• A subscription with a GitLab Duo add-on to a namespace which already has a subscriptions with a GitLab Duo add-on.

Enterprise Agile Planning

GitLab Enterprise Agile Planning is an add-on that helps bring non-technical users into the same DevSecOps platform where engineers build, test, secure, and deploy code. The add-on enables cross-team collaboration between developers and non-developers without having to purchase full GitLab licenses for non-engineering team members. With Enterprise Agile Planning seats, non-engineering team members can participate in planning workflows, measure software delivery velocity and impact with Value Stream Analytics, and use executive dashboards to drive organizational visibility.

To purchase additional Enterprise Agile Planning seats, contact your GitLab sales representative for more information.