Skip to main content
The Billing page contains an overview of your charges and the payment details on file for your CockroachDB Cloud organization.

​
View billing for an organization

Users with the or role can view billing details, invoices, and usage for the organization. To view the Billing page, log in and click Billing.

​
Set up billing for an organization

Users with the role can manage billing for the organization. You can pay for CockroachDB Cloud by using a credit card, or you can set up billing through AWS Marketplace or Google Cloud Marketplace.

​
Add a credit card

  1. On the Billing page, select the Payment details tab.
  2. Click Add a credit card in the Payment method field.
  3. In the Edit payment method dialog, enter the credit card details.
  4. Click Save card.
  5. Click Add a billing email in the Billing contact info section.
  6. In Edit billing email enter the email address at which you want to receive invoices for the organization.
  7. Click Submit.
  8. Click Add a billing address in the Billing contact info section.
  9. Enter the address associated with your payment method. This address appears on your monthly invoice and should be the legal address of your home or business.
  10. Click Submit.

​
Change the billing email address

  1. On the Billing page, select the Payment details tab.
  2. Click the pencil icon for the Email field under Billing contact info.
  3. Enter the new email address at which you want to receive invoices for the organization.
  4. Click Submit.

​
Change the payment method

  1. On the Billing page, select the Payment details tab.
  2. Click the pencil icon for the Payment method field.
  3. In the Edit payment method dialog, enter the credit card details.
  4. Click Save card.
  5. In the Billing contact info section, click the pencil icon for the Billing address field.
  6. Enter the address associated with your new payment method. This address appears on your monthly invoice and should be the legal address of your home or business.
  7. Click Submit.

​
Delete your credit card information

We keep a card on file after the associated organization is deleted so we can process pending charges. You can contact Support to remove your card once your charges are settled.

​
View Credits balance

If your organization has an annual contract with CockroachDB Cloud, the Overview tab of the Billing page displays the amount of available CockroachDB Cloud Credits you have remaining and the average number of Credits your organization consumes per day. At the end of each billing period, invoice payments are deducted from your organization’s Credits. Under the Credits section, you can see more information about each of your organization’s contracts. Contracts are listed in the order in which they will be used. The Current billing period section displays a table listing your organization’s clusters and the Credits they have accrued. The table also includes the cluster type and associated .

​
View invoices

You can review an in-progress invoice for the current billing period on the Overview tab of the Billing page. You can view all of your organization’s past invoices on the Invoices tab of the Billing page. Click any invoice to view the details of your charges for a billing period. If you’re using to organize your clusters, billing is grouped by folder. Click any folder to view invoices for individual clusters in the folder or its descendants. Within a folder, click any subfolder to view its details. You can also use the Cloud API to .

​
Export invoices

You can export invoice data in CSV or PDF format. From the Invoices tab, on the row of any billing period, click the … button under the Download column and select an export option:
  • Export Monthly CSV: Exports a CSV file with one row per line item for all clusters in your organization, matching what is displayed in invoices in the Console. Any adjustments (such as applied credits or fees) are appended as additional rows at the end of the file, with no cluster-specific details.
  • Export Daily CSV: Contains the same columns and structure as the Monthly CSV, but usage rows are broken down by individual day rather than aggregated across the full billing period. Two additional columns are included: Usage date (the date each usage row covers) and Locality (for multi-region charge breakdowns). Adjustments are appended in the same way as in the Monthly CSV.
Export Daily CSV is only available for invoices posted in 2026 or later.
  • Export Invoice PDF: Renders invoice information from the Console into a traditional invoice format. This format includes the high level information from the Console, a summary of total usage, the organization’s billing address, and a CockroachDB letterhead.
If you’re using to organize your clusters, the full path for each cluster is provided under the Cluster path column.

​
Non-payment

If a Cloud organization with billing configured lapses in payment, non-payment reminders are sent the Billing contact info designated in the Cloud Console under Billing > Settings. By default this billing contact is set to the original Organization Admin of the Cloud organization. After sending multiple payment failure reminders with no acknowledgement or change in billing, all clusters in the organization are deleted including data. Deleted clusters cannot be restored.