Licensing and subscription FAQ Close To search repositories and projects, login to gitlab.com . Suggestions GitLab Duo Agent Platform Code Suggestions (AI) CI/CD GitLab on AWS GitLab on Google Cloud Why GitLab? * Platform Execution & Workflows * CI/CD * Source Code Management * Agile Delivery Security & Governance * Application Security Testing * Governance & Compliance * Supply Chain Security Context & AI * Agentic Orchestration * Context Graph * Visibility & Measurement Explore the Platform Why GitLab One platform for speed with control across your software lifecycle. Learn more * Solutions Outcomes * DevOps Modernization * Security Modernization * AI Modernization By size * Enterprise * Small Business * Startups Industries * Financial Services * Public Sector * Telecommunications * Automotive * Education * Aerospace View all Solutions GitLab Transcend Catch our latest innovations announced at the last Transcend. Read the blog * Pricing * Resources Discover * Docs * University * Demo Series * Demo Hub * Services Connect * Blog * Community * Customers * Partners * Events View all resources What’s new in GitLab Stay updated with our latest features and improvements. Read the latest * Company * About * Jobs * Press * Handbook * Leadership * Investor relations * Trust Center * AI Transparency Center * Newsletter * Contact us * Talk to sales * Support portal * Customer portal Request a demo Get free trial Sign in * English * Deutsch * Español * Français * Italiano * 日本語 * Português Get free trial Ship at agent speed. Prove every step. Transcend returns on October 6. Register now Licensing and subscription FAQ Jump to a section * Multiple instances * Users * Using your subscription * Renewing, downgrading, and expired plans * Purchases and payments * Storage space * Free trials * Group plans * Resellers * Licensing Documentation Multiple instances Show all Can I apply one activation code (or license key) to multiple instances? Subject to certain conditions, yes. Please see Acceptable Use of User Licenses Policy . If I use a scaled architecture, do I need to upload the license to all instances? No. The license is stored in the database and will be replicated to all your application instances. Therefore you only need to upload the license file to one application instance. When using GitLab Geo, do I need to upload the license to the secondary node(s) as well? No. The license is stored in the database and is replicated to all instances. You only need to upload the license to your primary Geo instance. Users Show all Who gets counted in the subscription? Generally, every user that occupies a seat in the subscription counts as a billable user. However, some categories of users are not counted in the subscription. Learn more about how seat usage is determined for users on GitLab.com and self-managed . What does “users over subscription” (or “seats owed”) mean? The number of users over subscription (or seats owed ) shows how many users are in excess of the number allowed by the subscription, in the current subscription period. On GitLab self-managed, the users over subscription value is always zero for trial licenses. Do I need the administrator account (aka `root`) that came installed if I am also an administrator? Nope! The root user is just the first admin account, created by default in self-managed versions of GitLab. Just like any other user, this account does occupy a license seat. So, please consider following good security practice and have one or more "real" people play the role of administrator. You're allowed (and encouraged) to rename the user, or even delete or disable it as long as you've promoted other users to administrator. How can I get a list of billable users for my plan? For GitLab.com subscriptions, you can view a list of billable users in the Billing section . For Self-managed subscriptions, you can view a list of billable users in the Admin section or through a Rails console session . How are Maximum Users Calculated? In GitLab 13.7 and later , the number of maximum users reflects the highest number of billable users on your system for the current license period. See the question Who gets counted in the subscription? in this same section . You can also consider restricted access to better control your maximum user count. Prior to GitLab 13.7, the Maximum Users value found in self-managed instances of GitLab reflects the maximum daily active user count recorded in the instance for the period of 1 year prior to the expiration date of the license. Since most GitLab subscriptions are annual, this means the Maximum User count in these cases is simply the highest number of active users at any one time during that subscription. However, for non-standard contract lengths (8 months, 14 months, 24 months), the Maximum Users count is not reflective of the entire subscription term, but rather for the 12 months prior to the expiration date. Can I use my paid seats for different users? The seats for your license are generic and are not specific to a user. GitLab does not use a named license model. The seats you buy can be distributed however you choose. If a user leaves your organization, you can remove or block that user to free the seat. This seat can then be used by another user. Note that this may result in a user over license if your maximum users has been reached. Can I add more users to my subscription? Please see instructions on how to add more users for GitLab.com or GitLab Self-Managed subscriptions. How can I reduce the seats in my subscription? You can reduce seats only during subscription renewal. If you want to reduce the number of seats in your subscription, you can renew for fewer seats . How to reset the Maximum Users and Users over license? Maxmimum Users will be reset once the current license is expired and a new license with a new service period is uploaded. Users over license can be reset either: * During the current license service period by Adding more seats to the subscription so that your total Users in License meet or exceed your current Maximum Users * By paying for quarterly reconciliation or true-ups per quarter or at your renewal. Using your subscription Show all How do I use my subscription? Please take a look at our subscription docs for information on getting set up, applying, and managing your subscription. Support Bot , Migration Bot , and Alert Bot do not count towards the subscription. How can I transfer from a self-managed subscription to a SaaS subscription or vice versa? Currently, we are not able to transfer plans on a subscription. In order to make use of a SaaS subscription or a self-managed subscription, you will need to purchase a new subscription . You can do so by logging into the Customers Portal and selecting the Buy new subscription button. If you need to migrate your data from your self-managed instance to your gitlab.com account, please see our migration docs . Migrating data from gitlab.com to a self-managed instance is a similar process ; the main difference is that users can be created on the self-managed GitLab instance by an admin through the UI or the users API . What do I need in order to use my subscription or license? GitLab.com Subscription To apply a GitLab.com subscription you'll need to have: * Created a GitLab.com account * Linked your customers.gitlab.com account with your GitLab.com account * Owner permission in the place you want to apply the subscription If you've met all those conditions, continue on to How do I use my subscription? . Self-managed Subscription To activate a GitLab Self-managed subscription, you'll need to have: * Administrator access to the GitLab installation Is it possible to apply a GitLab.com subscription to multiple namespaces? Only one top-level namespace (group) can be covered by a single GitLab.com subscription, and all sub-groups under that namespace will share that subscription. If a customer wants to use the purchased subscription in more than one top-level namespace , then they can follow the approach of Converting a top-level group into a subgroup by transferring it to the appropriate licensed group . Renewing, downgrading, and expired plans Show all How do I renew my subscription? If you are unsure of your renewal date, you will be notified in GitLab 15 days before your expiration date . If you have auto-renewal on , you will instead receive appropriate email notifications . GitLab.com and self-managed GitLab Please see this documentation for instructions on how to renew your GitLab.com or self-managed subscription Administrators of self-managed instances can find user usage through the following options: * Within GitLab UI, select Admin Area -> Users to view the Active Users tab which indicates the users currently counted. * View the User Statistics panel from Admin Area -> Overview -> Dashboard to view users available in license and users over license. * Run the command sudo gitlab-rails runner 'p User.active.count' to obtain the Active User count. * Run the command sudo gitlab-rails runner 'p ::HistoricalData.max_historical_user_count' to obtain the Maximum billable user count. * Run the command GET /users to obtain a list of all billable users. GitLab Education Program In order to renew, send an email to [email protected] with the following information: * Indicate the number of seats for the renewal. Seats can be added at this time if needed. * Describe the use case for the license. Specifically, we need verification that the use meets the End User License Agreement . Note that University infrastructure operations and information technology operations do not fall within the stated terms of the Education Program. See the FAQ here . * Include the full name, email address, and phone number of the primary contact who will be signing the renewal quote. Only signatures by faculty or staff with proper signing authority on the behalf of the University will be accepted. Once we receive the above information, we will process the request and return a renewal quote for signature. Please allow a minimum of 2 business days for return. Email us at [email protected] with any questions. GitLab Open Source Program All requests for our GitLab Open Source program (even renewals) must be made via the application process found here . If you have any questions, email the team at [email protected] for assistance. How do I renew for fewer seats than my current subscription? To renew your subscription at a lower seat quantity, please see this documentation . My renewal is not going through or is having payment errors, what should I do? Please check your inbox for any prior email notifications that may explain why the renewal has not gone through. If you are paying with a credit card, it may have been declined for various reasons . If they do not apply or you encounter other payment errors, please contact support . If you are not sure how to renew your subscription, please reach out to your account contact or contact sales if you do not know who your account contact is. I see a charge for a Quarterly Subscription Reconciliation. What is this for? For more information and a breakdown on Quarterly Subscription Reconciliation, see the documentation . My subscription is about to expire. What should I do to maintain access? If your subscription is set to auto-renew it will renew automatically at midnight UTC on the expiration date without a gap in available service. You can also renew your subscription manually up to 15 days before your subscription expires to ensure you don't lose access to paid features. Note: If you want to renew for fewer seats, change the quantities of products being renewed, remove add-on products, upgrade the subscription tier, or otherwise need help renewing your subscription, you should renew your subscription manually or contact the sales team . If you need help accessing the Customer Portal or changing the contact person managing your subscription, contact the support team . Why does my group billing page still show an upcoming renewal for my subscription when I have already renewed? Your group billing page will show an upcoming renewal until the expiration date of your existing subscription, even if you have already renewed. It will be updated automatically to the new subscription period once your existing subscription expires. For example, if your existing subscription ends on 2023-01-31 and you renewed on 2023-01-20, you will still see an upcoming renewal until 2023-01-31. After this date, your subscription end date will reset to 2024-01-31 if you renewed for 1 year. How do I downgrade my subscription? It is not possible to downgrade a subscription after it has been purchased or renewed. A separate subscription for the desired plan and seat count will need to be purchased, and your existing subscription will only be eligible for refund per the terms of our Subscription Agreement . If you would like for your namespace to nevertheless be manually downgraded to the Free tier before the subscription has expired, please submit your request via our support form . Please note: Manually downgrading a namespace will not make the subscription eligible for refund. Purchases and payments Show all How much does GitLab cost? You can find pricing for GitLab.com subscriptions on our pricing page here . Can I pay for the subscription monthly? All subscriptions are paid in annual payments, monthly payments are not an available payment option. What payment methods do you accept? Credit Card - When purchasing via our Customers Portal you may pay with a credit card for a self-service experience. This credit card will also be used for any future purchases and will automatically be used for a renewal if you have auto-renewal on. You can also pay any outstanding invoices you have via the Customers Portal. If you wish to not purchase or pay via our Customers Portal but still use a credit card, you will have to work with our sales team . Wire - You will have to work directly with our sales team so they can set you up for wire transfers. For your first purchase and future payments like for renewals, you will be emailed an invoice that will include instructions with bank details and remittance. Check - Similarly to wire transfers, you will have to work directly with our sales team . Where to update credit card details? You can update your credit card details in the Customers Portal . Why is my purchase not going through? For possible issues and solutions, see My renewal is not going through or is having payment issues, what should I do? in the Purchases and payments section . How do I contact my account manager or the Sales team? If you do not know who your account contact is, please complete our sales form and your account contact or a member of our Sales team will get in touch with you. How can I get a copy of my invoice and pay for it? You can view, pay for, and download your invoice in the Customers Portal by selecting Invoices from the left sidebar. If your invoice is not available, please submit a request via our support portal . How can I request a refund? If you have an Account Contact, please contact them to begin the process of requesting a refund. If you do not have an Contact, please submit a request via our support portal to get in contact with our Billing team. There is an unknown 1 USD charged on my credit card You won't be charged if you haven't made any purchase. If you see 1 USD charge in your account, this is for credit card validation purpose. It happens when: * You use your credit card for the first time * You validate your GitLab.com account with your credit card The amount will be returned to your account within the next 5-30 days depending on your card issuer bank. I purchased a multi-year subscription, why is my license only for 1 year? We issue self-managed GitLab legacy licenses in 12 month increments and check-in at the start of each subsequent term within the subscription period to see if there are any changes to users needed prior to generating the license. If you are using Cloud Licensing or Offline Cloud Licensing , your license will be generated for your entire subscription term. You can always contact us via our support portal as the next term approaches otherwise someone will be in touch as well. Storage space Show all Can I buy more storage? For Free GitLab.com namespaces, there is a 10 GiB Git repository and LFS adjustable storage limit. To purchase more storage, follow these steps . Free trials Show all How do I start a trial? It is possible to obtain a free evaluation of our GitLab.com or self-managed subscriptions and Duo Agent Platform for a 30-day period for up to 100 users. Please visit our free trial page to sign up. For self-managed users, when you decide to purchase a subscription, you will be issued a new license key. Should you not take out a subscription, your key will expire at the end of your evaluation period. At that point you should remove the trial key and the system will revert to our free Core version. Is it possible to transfer trial between namespaces? Since trial is activated per namespace basis, it cannot be transferred. However, Customer can start a new trial for a group by clicking on Start an Ultimate trial in the group's billing page. Group plans Show all How do I purchase a Group Plan on GitLab.com? You will first need to create your group in GitLab.com and add users. Follow the steps below: * Create a group in GitLab.com * Add users to the group * Log into the Customers Portal to purchase the desired plan for your group. * Select the GitLab.com subscription plan using the Order (Premium SaaS, Ultimate SaaS) Plan button * From the This subscription is for dropdown, select the group name you've created * Select the Proceed to checkout button What's the differe