_index.md

stage: Fulfillment
group: Subscription Management
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://handbook.gitlab.com/handbook/product/ux/technical-writing/#assignments
description: Seat usage, compute minutes, storage limits, renewal info.
title: GitLab.com subscription

{{< details >}}

• Tier: Premium, Ultimate
• Offering: GitLab.com

{{< /details >}}

{{< alert type="note" >}}

The GitLab SaaS subscription is being renamed to GitLab.com. During this transition, you might see references to GitLab SaaS and GitLab.com in the UI and documentation.

{{< /alert >}}

GitLab.com is the GitLab multi-tenant software-as-a-service (SaaS) offering. You don't need to install anything to use GitLab.com, you only need to sign up. When you sign up, you choose:

• A subscription.
• The number of seats you want.

The subscription determines which features are available for your private projects. Organizations with public open source projects can actively apply to our GitLab for Open Source Program.

Qualifying open source projects also get 50,000 compute minutes and free access to the Ultimate tier through the GitLab for Open Source program.

Obtain a GitLab.com subscription

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.

View GitLab.com subscription

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:

Field	Description
Seats in subscription	If this is a paid plan, represents the number of seats you've bought for this group.
Seats currently in use	Number of seats in use. Select See usage to see a list of the users using these seats.
Maximum seats used	Highest number of seats you've used.
Seats owed	Max seats used minus Seats in subscription.
Subscription start date	Date your subscription started.
Subscription end date	Date your current subscription ends.

Renew GitLab.com subscription

15 days before a subscription expires, a banner with the subscription expiry date displays for group owners in the GitLab user interface.

Before you renew your GitLab.com subscription, you should review your account.

You can renew your subscription manually or automatically. Your updated subscription is applied to your namespace. The renewal period start date is displayed on the group Billing page under Next subscription term start date.

You can view and manage renewal invoice at any time.

Renew for fewer seats

Subscription renewals with fewer seats must have or exceed the current number of billable users. Before you renew your subscription, reduce the number of billable users if it exceeds the number of seats you want to renew for.

To manually renew your subscription for fewer seats, you can either:

• Manually renew within 15 days of the subscription renewal date. Ensure that you specify the seat quantity when you renew.
• Disable automatic renewal of your subscription, and contact the sales team to renew it for the number of seats you want.

Automatic subscription renewal

When a subscription is set to auto-renew, it renews automatically at midnight UTC on the expiration date without a gap in available service. You receive email notifications before a subscription automatically renews. Subscriptions purchased through the Customers Portal or GitLab.com are set to auto-renew by default, but you can disable automatic subscription renewal.

The number of seats is adjusted to fit the number of billable users in your group at the time of renewal, if that number is higher than the current subscription quantity.

Expired subscriptions

When your subscription expires, you can continue to use paid features of GitLab for 14 days. On the 15th day, paid features are no longer available. You can continue to use free features.

For example, if a subscription has a start date of January 1, 2024 and an end date of 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.
• Paid features are no longer available as of 12:00:00 AM UTC January 15, 2025.

To resume paid feature functionality, purchase a new subscription.

Upgrade subscription tier

To upgrade your GitLab tier:

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

When the purchase has been processed, you receive confirmation of your new subscription tier.

Add or change subscription contacts

Contacts can renew a subscription, cancel a subscription, or transfer the subscription to a different namespace.

You can change profile owner information and add a secondary contact for your subscription.

How seat usage is determined

A GitLab.com subscription uses a concurrent (seat) model. You pay for a subscription according to the maximum number of users assigned to the top-level group, its subgroups and projects during the billing period. You can add and remove users during the subscription period without incurring additional charges, as long as the total users at any given time doesn't exceed the subscription count. If the total users exceeds your subscription count, you will incur an overage, which must be paid at your next reconciliation.

A top-level group can be changed like any other group.

Billable users

Billable users count toward the number of subscription seats purchased in your subscription.

A user is not counted as a billable user if:

• They are pending approval.
• They have only the Guest role on an Ultimate subscription.
• They have only the Minimal Access role for any GitLab.com subscriptions.
• They are a banned member.
• They are a blocked user.
• The account is a GitLab-created service account:
  • Ghost User.
  • Bots:
    • Support Bot.
    • Bot users for projects.
    • Bot users for groups.

Seat usage is reviewed quarterly or annually.

If a user views or selects a different top-level group (one they have created themselves, for example) and that group does not have a paid subscription, the user does not see any of the paid features.

A user can belong to two different top-level groups with different subscriptions. In this case, the user sees only the features available to that subscription.

Free Guest users

{{< details >}}

• Tier: Ultimate
• Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

{{< /details >}}

In the Ultimate tier, users who are assigned the Guest role do not consume a seat. The user must not be assigned any other role, anywhere in the instance or in the namespace for GitLab.com.

• If your project is:
  • Private or internal, a user with the Guest role has a set of permissions.
  • Public, all users, including those with the Guest role, can access your project.
• For GitLab.com, if a user with the Guest role creates a project in their personal namespace, the user does not consume a seat. The project is under the user's personal namespace and does not relate to the group with the Ultimate subscription.

Seats owed

If the number of billable users exceeds the number of seats in subscription, known as the number of seats owed, you must pay for the excess number of users.

For example, if you purchase a subscription for 10 users:

Event	Billable members	Maximum users
Ten users occupy all 10 seats.	10	10
Two new users join.	12	12
Three users leave and their accounts are removed.	9	12

Seats owed = 12 - 10 (Maximum users - users in subscription)

To prevent charges from seats owed, you can turn on restricted access. This setting restricts groups from adding new billable users when there are no seats left in the subscription.

Seat usage alerts

{{< history >}}

• Introduced in GitLab 15.2 with a flag named seat_flag_alerts.
• Generally available in GitLab 15.4. Feature flag seat_flag_alerts removed.

{{< /history >}}

If you have the Owner role for the top-level group, an alert notifies you of your total seat usage.

The alert displays on group, subgroup, and project pages, and only for top-level groups linked to subscriptions enrolled in quarterly subscription reconciliations. After you dismiss the alert, it doesn't display until another seat is used.

The alert displays based on the following seat usage. You cannot configure the amounts at which the alert displays.

Seats in subscription	Alert displays when
0-15	One seat remains.
16-25	Two seats remain.
26-99	10% of seats remain.
100-999	8% of seats remain.
1000+	5% of seats remain.

View seat usage

To view a list of seats being used:

1. On the left sidebar, select Search or go to and find your group.
2. Select Settings > Usage Quotas.
3. Select the Seats tab.

For each user, a list shows groups and projects where the user is a direct member.

• Group invite indicates the user is a member of a group invited to a group.
• Project invite indicates the user is a member of a group invited to a project.

The data in seat usage listing, Seats in use, and Seats in subscription are updated live. The counts for Max seats used and Seats owed are updated once per day.

View billing information

To view your subscription information and a summary of seat counts:

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

• The usage statistics are updated once per day, which may cause a difference between the information in the Usage Quotas page and the Billing page.
• The Last login field is updated when a user signs in after they have signed out. If there is an active session when a user re-authenticates (for example, after a 24 hour SAML session timeout), this field is not updated.

Search seat usage

To search seat usage:

1. On the left sidebar, select Search or go to and find your group.
2. Select Settings > Usage Quotas.
3. On the Seats tab, enter a string in the search field. A minimum of 3 characters are required.

The search returns users whose first name, last name, or username contain the search string.

For example:

First name	Search string	Match ?
Amir	ami	Yes
Amir	amr	No

Export seat usage

To export seat usage data as a CSV file:

1. On the left sidebar, select Search or go to and find your group.
2. Select Settings > Usage Quotas.
3. In the Seats tab, select Export list.

Export seat usage history

Prerequisites:

• You must have the Owner role for the group.

To export seat usage history as a CSV file:

1. On the left sidebar, select Search or go to and find your group.
2. Select Settings > Usage Quotas.
3. In the Seats tab, select Export seat usage history.

The generated list contains all seats being used, and is not affected by the current search.

Add seats to subscription

Your subscription cost is based on the maximum number of seats you use during the billing period.

• If restricted access is turned on, when there are no seats left in your subscription you must purchase more seats for groups to add new billable users.
• If restricted access is turned off, when there are no seats left in your subscription groups can continue to add billable users. GitLab bills you for the overage.

You cannot add seats to your subscription if either:

• You purchased your subscription through an authorized reseller (including GCP and AWS marketplaces). Contact the reseller to add more seats.
• You have a multi-year subscription. Contact the sales team to add more seats.

To add seats to a subscription:

1. Sign in to the Customers Portal.
2. Go to the Subscriptions & purchases page.
3. Select Add seats on the relevant subscription card.
4. Enter the number of additional users.
5. Review the Purchase summary section. The system lists the total price for all users on the system and a credit for what you've already paid. You are only charged for the net change.
6. Enter your payment information.
7. Check the I accept the Privacy Statement and Terms of Service checkbox.
8. Select Purchase seats.

You receive the payment receipt by email. You can also access the receipt in the Customers Portal under Invoices.