We intend to roll out the application of user and storage limits independently and gradually. Storage limits will not be applied before storage management improvements are available.
Top-level private groups on the Free tier of GitLab SaaS created on/after 2022-12-28 are subject to the application of user limits. For top-level private groups on the Free tier of GitLab SaaS created before 2022-12-28 we will show in-app notifications for user limits to affected top-level private groups, including any subgroups and projects, prior to the limits being applied. Top-level private groups that are already above the limit will see the in-app notifications at least 60 days ahead of the limits being applied. Top-level private groups that go above the limit during the period when the in-app notifications are showing will see them as soon as they go above the threshold. Note personal namespaces are public and therefore excluded from user limit notification and applying the 5-user limit.
For storage limits we will show in-app notifications to affected top-level groups and personal namespaces, including any subgroups and projects, prior to the limits being applied. Namespaces that are already above the storage limit will see the in-app notifications at least 60 days ahead of applying the storage limits. Namespaces that go above the limit during the period when the in-app notifications are showing will see them as soon as they go above the threshold.
In GitLab, a namespace is a unique name for a personal namespace, a group, or subgroup, under which a project can be created. User limits and storage limits are implemented at the top-level group or personal namespace where applicable.
We are introducing a storage limit of 5GB for top-level groups and personal namespaces to the GitLab SaaS Free tier.
|GitLab SaaS Tier||Free|
|Storage (in GB per top-level group / personal namespace)||5 GB|
Note: A 10GB project storage limit for git repository and git LFS is currently active for all projects. Once the namespace storage limit is applicable, the project storage limits will be removed.
Free Storage limits are applicable to users of the Free GitLab SaaS offering. Community programs - including GitLab for Open Source, Education and Startups users - will have the limits applicable for GitLab Ultimate. This change does not apply to self-managed users. Customers who are still on the Bronze subscription are not impacted by this change immediately, and the new limits on Premium / Ultimate will be applicable when they upgrade.
If you have questions regarding the future storage and transfer limits for the Paid GitLab SaaS tiers please see the Storage and Transfer limits for the Paid GitLab SaaS tiers FAQ.
Yes, GitLab Ultimate Trial and Premium Trial will receive entitlements from GitLab Ultimate and Premium respectively.
Yes, the change is applicable to both public and private projects. Free tier users using GitLab for public open source projects should consider applying for the GitLab for Open Source program, which provides access to the GitLab Ultimate features and entitlements for free.
Currently storage includes pipeline job artifacts, repositories, package and container registries, snippets, Git LFS, wiki storage, dependency proxy. Future product features that allow you to store data will also be incorporated into the storage usage count, when available.
You can view the storage usage on the Group Settings page for Usage Quota in the
Storage tab. The summaries are divided into all storage types listed in the answer to the "What constitutes Storage usage?" question. Each type provides details on how to proceed with detailed analysis and cleanup procedures.
Top-level groups and personal namespaces exceeding the storage limit will continue to have read access but will be unable to write any new data. This applies to all types of storage including Repository, LFS, Packages, and Registry.
Below you will find steps for managing the different storage types:
Yes, once namespace storage limits are in effect any previously purchased additional storage, including additional storage purchased due to project storage limits, will be applicable to the top-level group.
If your top-level group is above both the 5-user limit and Free storage limit, it's important you manage your user count first, as the 5-user limit has already been fully rolled out. If you reduce your storage usage and/or buy more storage while your user count is more than 5, and the namespace is still on the Free tier, your top-level group would be immediately placed in the read only state. Please see the recommended ordering of considerations below:
If your top-level group is only over the Free storage limit, it's recommended you manage your storage usage first. Please see the recommended ordering of considerations below:
There will be a 5-user limit for top-level groups with private visibility. At this time, top-level groups with public visibility will not have a user limit.
Note: Personal namespaces are public by default and therefore excluded from the user limit.
These user limits are applicable only to users of the Free tier of the GitLab SaaS offering in a top-level group with private visibility. These changes do not apply to users of the Free tier of the GitLab SaaS offering in a public top-level group, paid tiers, the Free tier of the self-managed offering and community programs, including GitLab for Open Source, GitLab for Education, and GitLab for Startups users.
No. These user limits do not apply to Trials during the trial period.
No, these changes are applicable to top-level groups with private visibility. At this time, public projects in a top-level group with public visibility do not have a user limit. If you're a public open source project, you should consider applying for the GitLab for Open Source Program, which provides access to the GitLab Ultimate features and entitlements for free.
The top-level group is publicly visible, this includes information such as members, issues, and merge requests. The top-level group will be indexed by search engines.
User limits are currently applied based on the visibility of the top-level group. We will monitor how top-level groups with public visibility are using private projects to identify whether any limits on such projects are needed.
We intend to roll out application of the user limits gradually, impacted users will be notified in-app at least 60 days prior to the user limits being applied.
Yes, impacted users will be notified in-app at least 60 days prior to the user limits being applied.
We're applying a 5-user limit to top-level private groups on the GitLab SaaS Free tier. If you are above the 5-user limit on your top-level private group and are not seeing this notification, limits are not currently being applied to that group, so you can continue to use the Free tier until a later date. We'll notify you with at least 60 days notice before applying these limits to your top-level private group. Should any other transition offer be made available it will be presented as part of the notification as applicable.
Please ensure that your subscription has been associated to the correct top-level group and/or has been linked to your Customer Portal SaaS account.
We count the sum of unique users within a top-level group which includes the users in the top-level group, subgroups, and projects. For example:
If a user has a group named
top and two subgroups under
child2 with 4 different unique users in each group, then the
top group will have a total of 8 users, which is above the user limit of 5. If the two subgroups contain the same 4 users, then
top would only have 4 total users.
Users can view and manage the users in their top-level group by going to Group > Group Settings > Usage Quotas > Seats. Only Group Owners can add or remove users from the Usage Quotas page. Owners and Maintainers of individual subgroups and projects can still manage the specific users in their subgroups/projects.
If your project is not located within a group, you can manage the users in each of your personal projects but the sum of the unique users within all your personal projects cannot exceed 5. GitLab strongly encourages personal projects to be moved into Groups which will allow these projects to access all GitLab features as well as give you the ability to manage all users from the Usage Quotas page, start a trial, and purchase a subscription. See Move your project to a group for instructions.
When the 5-user limit is applied to top-level groups with private visibility, top-level groups exceeding the user limit will be placed in a read only state. These top level groups exceeding the user limit will continue to have read access but will be unable to write any new data. This applies to all types of storage including Repository, LFS, Packages, and Registry.
The Free tier has a limit of 5 users on top-level groups with private visibility which cannot be increased. GitLab recommends the paid tiers - Premium or Ultimate - for larger teams as there are no user limits and they contain features designed to increase your team’s productivity. We recommend starting a free trial of GitLab Ultimate to experience the value of the paid features while also getting access to unlimited users for the trial period.
You may have inadvertently created new top-level groups not associated to the one being paid for. To confirm if this is the case, navigate to your Group > Group Settings > Billings. If your group is listed as being on the Free tier, then it is not associated with your paid GitLab subscription. To move this group into your paid subscription, follow the steps documented here: Transfer a group ."
See Transfer a group for instructions on how to move existing groups that are not associated with your top-level namespace. Users that are not part of the top-level namespace will require additional seats to remain active. See Add users to your subscription for instructions on how to add seats.
Free tier users can also consider using the self-managed deployment option that does not have user limits. GitLab also has special programs for Open Source projects and students/educators granting access to GitLab Ultimate. If you believe you could qualify for one of these programs you can learn more here.
The GitLab for Open Source Program was created to give back to the open source community by encouraging individuals and teams to contribute to open source. Public open source projects will need to be part of the GitLab for Open Source program to continue to receive GitLab Ultimate features.
As previously announced, all Free tier public projects will not receive Ultimate by default, and all public projects will be subject to quota of compute minutes applicable to their plan. Free tier users using GitLab for public open source projects should consider applying to the GitLab for Open Source program to continue to take advantage of GitLab Ultimate features such as portfolio management, advanced security testing, security risk mitigation, and compliance.
These changes are applicable to users with public projects on the Free tier of GitLab SaaS. These changes do not apply to self-managed free and paid tier users, SaaS paid tier users, and community programs - including GitLab for Open Source, Education and Startups users.
The CI/CD limits on public projects will be applicable for all users including paid and Free tier with public projects starting 2022-06-01. Public projects on the Free tier will stop receiving Ultimate entitlements by default starting 2022-07-01.
There are two ways:
You will not be able to run new jobs until you purchase additional compute minutes, or until the next month when you receive your monthly allotted compute minutes. Running jobs will be cancelled when a top-level group or personal namespace reaches its limit while a pipeline is running.
This detailed FAQ covers how to manage your compute minutes usage. Watch this deep dive video on how you can manage your compute minutes usage.
Compute minutes are calculated using a formula that includes the job duration and an applied cost factor. Please refer to the documentation to learn more.
All Free tier users receive 50,000 compute minutes for running pipelines on public forks of public open source projects, like GitLab. Contributions to all other projects by Free tier users are subject to the new limits.
The GitLab for Open Source Program gives access to unlimited seats per license of GitLab Ultimate (SaaS or Self-Managed), including 50,000 compute minutes, excluding support. View the program requirements and apply for the GitLab for Open Source program online here. In most cases, GitLab will respond with a decision or request for additional information within 15 business days.
If you are not part of the GitLab for Open Source program, after July 1, 2022, your account will stop receiving GitLab Ultimate capabilities and will receive the entitlements available to the Free tier. You will not lose any data, but you will not be able to create any new jobs or artifacts nor access Ultimate features if you have exceeded the usage limits of the Free tier.
No. In order to meet the requirements of the Open Source Program, all of the code you host in this GitLab group must be published under OSI-approved open source licences. All projects under this group must have public visibility. Individual projects are not eligible for the Open Source Program. Additionally, your organization must not seek to make a profit. Please check all the eligibility requirements for the Open Source program here.
No. You will need to apply for GitLab for Open Source Program at the top-level group.
username. Projects within the username group
usernamewill not be considered. If
usernamecreates a group
user-groupand has open source projects within that group, then
user-groupcan be considered for the Open Source program)
open source project(for example, personal projects), you will need to move out the unrelated projects to a different group to be eligible for the GitLab for Open Source Program.