{
  "schemaVersion": "1.0",
  "item": {
    "slug": "gitlab",
    "name": "GitLab",
    "legalName": "GitLab Inc.",
    "category": "developer-tools",
    "description": "GitLab's Customers Portal is the self-service hub for subscriptions and billing, including invoice access and payment for direct customers.",
    "status": "import_only",
    "website": "https://about.gitlab.com",
    "billingPortalUrl": "https://customers.gitlab.com",
    "invoiceHelpUrl": "https://docs.gitlab.com/subscriptions/billing_account/",
    "accessMethods": [
      "vendor_portal",
      "connected_mailbox",
      "email_forward",
      "manual_upload"
    ],
    "authentication": {
      "oauth": false,
      "apiToken": false,
      "browserSession": true,
      "requiredRole": "Billing account manager with access to the GitLab Customers Portal"
    },
    "capabilities": {
      "accountDiscovery": {
        "supported": false,
        "notes": "No Billproof account-discovery capability is claimed for this vendor."
      },
      "billingHistory": {
        "supported": true,
        "notes": "Historical billing records are available in the vendor portal."
      },
      "invoiceMetadata": {
        "supported": true,
        "notes": "The vendor portal exposes invoice or statement summary data."
      },
      "invoicePdf": {
        "supported": "unknown",
        "notes": "GitLab documents invoice viewing and downloading without specifying one universal format."
      },
      "creditNotes": {
        "supported": "unknown"
      },
      "lineItems": {
        "supported": true,
        "notes": "Invoices and subscription records identify purchased products and renewal charges."
      },
      "usage": {
        "supported": "unknown"
      },
      "subscriptions": {
        "supported": true,
        "notes": "Customers Portal manages GitLab subscriptions throughout their lifecycle."
      },
      "paymentMethod": {
        "supported": true,
        "notes": "Customers Portal exposes billing details and payment methods."
      }
    },
    "billing": {
      "cadence": [
        "annual",
        "contract-specific",
        "event-driven for upgrades and true-ups"
      ],
      "invoiceLocation": "GitLab Customers Portal → Invoices",
      "emailedAutomatically": true,
      "documentTypes": [
        "invoice",
        "payment receipt",
        "renewal invoice"
      ]
    },
    "billproof": {
      "retrieval": false,
      "normalization": true,
      "transactionMatching": true,
      "connectionAvailable": false,
      "limitations": [
        "Billproof does not currently connect directly to GitLab.",
        "A user must provide the invoice or statement by upload or an enabled email workflow.",
        "Purchases made through an authorized reseller must be documented by that reseller rather than GitLab's portal."
      ]
    },
    "normalizedFields": [
      "vendor",
      "invoice_number",
      "invoice_date",
      "billing_period",
      "currency",
      "subtotal",
      "tax",
      "total",
      "line_items",
      "account_identifier",
      "subscription",
      "namespace",
      "seat_quantity",
      "term"
    ],
    "commonCardDescriptors": [],
    "researchedAt": "2026-08-28",
    "lastVerifiedAt": "2026-08-28",
    "sources": [
      {
        "title": "Manage billing account",
        "url": "https://docs.gitlab.com/subscriptions/billing_account/",
        "type": "official"
      },
      {
        "title": "Manage subscription",
        "url": "https://docs.gitlab.com/subscriptions/manage_subscription/",
        "type": "official"
      }
    ],
    "guide": {
      "quickAnswer": "Sign in to the GitLab Customers Portal, choose Invoices in the left sidebar, and open or download the invoice associated with the subscription or renewal.",
      "requiredRole": "Billing account manager for the relevant GitLab subscription",
      "steps": [
        "Sign in to the GitLab Customers Portal with the linked GitLab.com account or one-time sign-in link.",
        "Confirm that the correct customer and subscription are shown.",
        "Select Invoices in the left sidebar.",
        "Locate the invoice by number, subscription, and date.",
        "Open or download the invoice; retain the emailed payment receipt when it is needed as separate evidence."
      ],
      "historyLocation": "Customers Portal → Invoices",
      "missingInvoice": "Verify the Customers Portal profile linked to the purchase and ask the billing account manager for access. If a reseller sold the subscription, request the invoice from the reseller; otherwise contact GitLab Billing.",
      "formats": [
        "downloadable invoice",
        "payment receipt email"
      ],
      "commonProblems": [
        "The GitLab.com login is not linked to the legacy Customers Portal profile.",
        "The user can administer a namespace but is not the billing account manager.",
        "A reseller, rather than GitLab, is the seller of record."
      ],
      "matchingTips": [
        "Match the customer, subscription term, invoice number, currency, total, and payment receipt.",
        "Check seat changes or upgrades when a renewal-related amount differs from the base order."
      ]
    },
    "statusLabel": "Email or upload only",
    "cta": "Normalize a GitLab invoice",
    "manualGuide": "https://billproof.io/guides/find-gitlab-invoices",
    "urls": {
      "html": "https://billproof.io/integrations/gitlab",
      "json": "https://billproof.io/api/public/vendors/gitlab.json",
      "capabilities": "https://billproof.io/api/public/vendors/gitlab/capabilities.json"
    }
  }
}