Where can I find my GitLab invoices on gitlab.com?

Start at gitlab.com/-/profile/billings to see every paid namespace you own. Click Manage next to the group you want, then follow the invoice link into customers.gitlab.com to download the PDF. If you own several groups on paid plans, each group has its own invoice trail, so you repeat the process for each one. Maintainers cannot see any of this, only Owners can.

What is the Customers Portal and why do I end up there?

customers.gitlab.com is the GitLab Customers Portal, which handles subscriptions, seat management, true-ups, and invoice PDFs for both SaaS and self-managed products. The in-app billing pages on gitlab.com surface a summary and then link you out to the portal for the actual downloads. You sign in with the same GitLab credentials, and your profile is linked across both sites automatically.

How do I find invoices for my self-managed GitLab instance?

Self-managed billing does not live inside your server. Sign in to customers.gitlab.com, open the Subscriptions section, pick the subscription linked to your instance, and download PDFs from the Invoices list. The admin area of your GitLab server only shows which subscription key is active; it never stores invoice files. Finance teams often miss this because the UI looks so different from the gitlab.com SaaS view.

Does GitLab bill per user or per project?

GitLab bills per billable user on Premium and Ultimate, not per project or per repository. A billable user is someone with at least Guest access on a paid SaaS namespace (Premium includes Guests free on some tiers, so check the plan page for the current rule). Adding a user mid-term can trigger a true-up at renewal, and invoices show the seat count you are being charged for on that cycle.

What is a true-up and when does GitLab charge one?

A true-up is a back-charge for seats you added during the subscription year beyond what you paid for at the start. GitLab calculates it at renewal time on annual subscriptions. If you started the year with 10 seats and ended with 14, you pay for the extra 4 seats pro-rated for the time they were active, plus the new seat count going forward. The true-up appears as a line on the renewal invoice, not as a separate PDF.

Can my accountant download GitLab invoices without seeing the code?

Yes on SaaS, with a caveat. Invite them as a group Owner on the billing namespace only. Owners see billing and members, and you can keep them out of sub-groups where the code lives by managing group structure carefully. There is no separate billing-only role in GitLab SaaS self-serve, so Owner on a billing-only top-level group is the practical workaround. For self-managed, create a Customers Portal login for them at customers.gitlab.com so they never touch your instance.

How do I add my VAT or tax ID to GitLab invoices?

Sign in to customers.gitlab.com, open Account Settings, and update the billing address and tax ID fields. Future invoices include the information on the PDF. Past invoices cannot be edited, but GitLab support can reissue recent ones with corrected tax details on request. Do this before the next renewal cycle if you want clean documents for the whole tax year.

Does GitLab send invoices by email automatically?

Yes, to the billing contact on the Customers Portal account. If that contact is a personal email belonging to a developer who has since left, invoices are still arriving at an inbox nobody checks, which is a very common reason finance teams think GitLab stopped billing them. Update the billing contact in customers.gitlab.com to your finance alias as soon as you start paying for seats.

What happens to GitLab invoices when I move from SaaS to self-managed (or the other way)?

The two subscriptions stay separate unless you explicitly migrate them with sales. If you cancel SaaS and buy self-managed, historical invoices stay in the Customers Portal under the old subscription, and the new subscription gets its own invoice trail. Nothing is consolidated automatically. Plan the cutover date carefully so you do not end up paying both at once for a month.

Can I bulk download every GitLab invoice at once?

Not from the UI. The Customers Portal gives you one PDF per click across both SaaS and self-managed. There is a GraphQL API for GitLab itself but no public endpoint for bulk invoice PDF export on either billing surface. For any team running GitLab across multiple groups or a mix of SaaS and self-managed, connecting GitLab to Inbox Ledger is faster than the manual walk.

Why does my GitLab SaaS invoice look different from my self-managed invoice?

They use different billing systems underneath. SaaS invoices are generated from per-user subscription data on gitlab.com and rendered through the Customers Portal template. Self-managed invoices come from the enterprise subscription system and often include a purchase order reference if you bought on invoiced billing. Both are valid, both list GitLab Inc. as the seller, and your accountant will treat them the same even though the layout differs.

How long does GitLab keep old invoices in the Customers Portal?

Invoices stay accessible for the life of the Customers Portal account, which generally matches the life of your subscription. Downgrade to Free or cancel the subscription and access can become restricted over time. Do not treat the portal as a long-term archive. Tax authorities in most jurisdictions require multi-year retention, so download copies and store them in your own accounting system as soon as they land.

How to get GitLab invoices

Step-by-step guide to downloading your GitLab billing documents.

Last verified: 2026-04-24

Step-by-step: download invoices from GitLab

1
Pick the right billing surface first
GitLab has two completely separate billing stacks. GitLab SaaS (gitlab.com) is paid per user per month under a namespace, and invoices live in your GitLab profile. Self-managed instances (you run the server) are billed through a different site, customers.gitlab.com, where you manage the subscription key for your installation. Work out which one you need before you start clicking, because the paths do not overlap.
2
Open Billing in your GitLab profile (SaaS)
For gitlab.com, sign in and go to your avatar menu, then Edit profile, then Billing in the left sidebar. The direct URL is gitlab.com/-/profile/billings. This view lists every namespace you are linked to (personal namespace plus any groups you own) and the plan, seat count, and renewal date attached to each one. You must be the group Owner to see invoices for a group subscription. On the Billing page, each paid namespace has a Manage button that jumps to the billing details for that specific group, where the invoice list sits next to the seat usage chart.
3
Download invoices from the Customers Portal
GitLab routes invoice PDFs through its Customers Portal at customers.gitlab.com. Click an invoice link from the namespace billing page and you land there, or sign in directly with the same credentials. In the portal, open Invoices, filter by subscription or date, and download the PDF. Self-managed customers also manage their subscription key and true-up seats from this same portal.
4
File the PDF where your finance team can find it
Rename each invoice with a consistent pattern (date, namespace or instance, amount) and drop it where your accountant expects. If you run SaaS groups plus a self-managed instance, keep them in separate folders. They come from different billing flows and often use different payment methods, and mixing them up at quarter-close is how mistakes happen.

About GitLab billing

GitLab charges you in two completely different ways depending on where it runs. Same logo, same company, two billing stacks that barely talk to each other. Figure out which one applies before you start hunting for PDFs.

GitLab SaaS (gitlab.com) is the hosted product, sold per user per month on Free, Premium, or Ultimate tiers, with invoices that surface in your profile and finalize in the Customers Portal. Self-managed is the software you install on your own infrastructure, sold as an annual enterprise subscription with a license key that you apply to the server. They share a Customers Portal for invoice downloads, but nothing else.

The most common GitLab billing confusion is running both products at once. A company starts on SaaS for a small team, buys a self-managed instance for a regulated division, and now has two subscriptions, two seat counts, two renewal dates, and two PDF streams. Neither UI tells you the other one exists, so finance has to know.

About GitLab

GitLab Inc. is a DevOps platform founded in 2011 and headquartered in San Francisco, offering an integrated suite for source control, CI/CD, security scanning, and project management. The product ships in two forms: GitLab SaaS on gitlab.com (paid per user per month across Free, Premium, and Ultimate tiers) and GitLab Self-Managed (customer-installed under the same tier names, sold as annual subscriptions). Billing for both flows through the Customers Portal at customers.gitlab.com, though the in-app experience is very different on each side.

Manual vs automated

Manual

Sign in to gitlab.com with 2FA
Open Edit profile then Billing
Click Manage for each paid namespace
Jump out to customers.gitlab.com
Download each PDF one at a time
For self-managed, sign in to customers.gitlab.com separately
Track seat counts before renewal to avoid true-up surprises

Automated with Inbox Ledger

Connect GitLab once in Inbox Ledger
SaaS and self-managed invoices arrive automatically
Export to Drive, Sheets, or your accounting system

Why people stop doing this by hand

A one-person gitlab.com account on Premium? Receipts arrive, you save the PDFs, done. The pain starts when a company adds a second paid namespace for a subsidiary, brings a self-managed instance online for a compliance-heavy team, and hires a contractor group that needs its own Ultimate seats on a different renewal cycle. Now finance is chasing three invoice streams on three cadences with two different seat-count logics, and the Customers Portal makes you click into each subscription individually.

Annual renewals make it worse. True-up charges on the renewal invoice confuse people who forgot they added users in March, and the reconciliation against the seat usage chart becomes a quarterly headache. If your legal entities are split (US Inc. on SaaS, EU GmbH on self-managed), the tax treatment also differs, and mixing the PDFs at year-end is how audits get uncomfortable.

GitLab is one of the portals our Chrome Extension auto-detects. Install it, visit either gitlab.com billing pages or the Customers Portal, and the extension captures new invoices in the background across both surfaces. No OAuth juggling, no separate script for self-managed. Works alongside the main Inbox Ledger sync for email PDFs from the billing team.

Next step

One gitlab.com namespace on Premium, one renewal a year, a finance alias on the billing contact: the dashboard is enough. Multiple groups, a self-managed instance alongside SaaS, or true-up reconciliation at every renewal: connect GitLab to Inbox Ledger once and keep every invoice from both stacks in one place.

Extract your first 10 invoices free

No credit card required.

Start for Free

Quick access

Jump straight to the GitLab billing page in a new tab.

Open GitLab billing

Where to look in the dashboard

gitlab.com/-/profile/billings shows SaaS namespaces and their plans
Manage button opens per-group billing with seat usage and invoice list
customers.gitlab.com is where invoice PDFs actually download from
customers.gitlab.com also holds the subscription key for self-managed instances
Group Settings → Billing is an alternative path to the same per-group view
Self-managed admins use the Admin Area → Subscription page to apply keys, but not to download invoices

Before you start — quick checklist

Invoice is addressed to the correct legal entity (personal namespace vs company group vs self-managed org)
The plan tier (Premium or Ultimate) matches what you actually use, not a leftover trial upgrade
Seat count on the invoice equals the billable users you agreed to at renewal, including any mid-term true-ups
Annual subscriptions show the full year charge, not a misleading monthly equivalent line
VAT or GST is broken out if you added a tax ID, or correctly omitted under reverse-charge rules
For self-managed, the subscription key applied to your instance matches the one on the invoice

Pro tips

SaaS and self-managed are two completely different products from a billing perspective. Same vendor, same logo, different invoice templates, different renewal cadence, different portal. Do not assume finding one gets you the other.
Group Owners see billing; Maintainers do not. If your bookkeeper needs PDF access on GitLab SaaS, promote them to Owner or invite them with the Owner role on the billing namespace. Maintainer is not enough.
Self-managed renewals go through customers.gitlab.com, not through the admin UI of your GitLab server. The server just consumes the subscription key. Many teams lose half a day during renewal because they look in the wrong place.
Seat counts matter. GitLab bills per billable user, and adding users mid-term can trigger a true-up charge at renewal on Premium and Ultimate. Watch the seat usage chart in the billing namespace or the instance admin page before renewal season.
Annual contracts are paid once per year. Monthly contracts bill every month. Mixing them across groups is common at agencies, and each group generates its own PDF on its own cadence, which multiplies the folders you need to track.
Enterprise customers with invoiced billing (wire transfer, purchase order) get PDFs sent by email from the GitLab billing team in addition to the Customers Portal copies. Forward those to accounting as soon as they arrive, because they are easy to miss in a busy inbox.

Skip this entirely. Automate GitLab invoices

Inbox Ledger scans your email for GitLab invoices, extracts the data with AI, and syncs it to QuickBooks, Xero, or Google Sheets. No manual downloads.

Extract your first 10 invoices free

Frequently asked questions

Related portals

Stop chasing invoices manually

Inbox Ledger finds, extracts, and syncs your invoices automatically, from any billing portal that emails you.

Start for Free

No credit card required. 10 free invoices.

How to get GitLab invoices

Step-by-step: download invoices from GitLab

Pick the right billing surface first

Open Billing in your GitLab profile (SaaS)

Download invoices from the Customers Portal

File the PDF where your finance team can find it

About GitLab billing

About GitLab