View and download the cost details of your invoice or statement
TheCost table report, available in the Google Cloud console,is a cost management tool that you can use to understand the coststhat reconcile to your invoice. The report gives you a detailed tabular view ofyour costs for a given invoice or statement (byInvoice month). If you'reviewing the report usingfilters in their default state,theCost table report totals match your invoice or statement totals, and thereport generally includes all costs incurred during a given calendar month.
TheCost table report includes project-level cost details from your invoicesand statements, including yourtax costs broken out by project.The report also includes other details likeservice IDs,SKU IDs,andproject numbers.
The report view is customizable and downloadable to CSV.
Beginning with yourJanuary 2021 invoice or statement (available inFebruary 2021), all cost details, including product-level costs and costs bysubaccounts (for Resellers), were removed from the invoices and statements thatyou receive (both PDF and CSV format). The invoices and statements containcompany information (such as billing address, Cloud Billingaccount ID, and payment terms), your cost totals, taxes, and remittanceinstructions. Instead of the cost details, your invoice provides alink to theCost table report for the Cloud Billing account.
In theCost table report,Invoice month refers to thetime period that an invoice or statement covers. The detailed usage costsincluded for an invoice month might differ slightly from the detailed usagecosts for a calendar month. For more information, seeHow costs are calculated for an invoice month.
Permissions required to access the Cost table report
To view theCost table report for your Cloud Billing account,you need a role that includes the followingpermission on your Cloud Billing account:
billing.accounts.getSpendingInformationto view costs and usage for a billing account.
To gain this permission, ask your administrator to grant you one of thefollowingCloud Billing IAM roles on your Cloud Billing account:
- Billing Account Viewer
- Billing Account Costs Manager
- Billing Account Administrator
For more information about billing permissions, see:
- Overview of Cloud Billing access control
- Create custom roles for Cloud Billing
- Understanding predefined IAM roles for Cloud Billing
Access the report
To view theCost table report for your Cloud Billing account:
In the Google Cloud console, go to your Cloud Billing account.
At the prompt,choose the Cloud Billing accountfor which you want to view reports. TheBilling Overview page opens forthe selected billing account.
In theCost management section of theBilling navigation menu,selectCost table.
By default, when you first access the report, you see the data for the mostrecent complete month, grouped byProject > Service > SKU > Consumption model,without any filtering of the data, and including all the applicablecolumns of data.
How to read the cost table
TheCost table shows you a detailed breakdown of all your costs and creditsfor the selected invoice or statement and provides tools for cost analysis.
The previous screenshot highlights the different sections of theCost table page. The following information provides an overview of eachsection (the numbers below match the number in the screenshot for each section).
Header information for the invoice orstatement. Starting with theSeptember 2020 invoice month, theCost table report includes invoice or statement header information. Theheader includes your billing account ID, the invoice number and date, theinvoice total, the currency of your Cloud Billing account, and thecurrency exchange rate (available starting April 2021, for accounts billedin a non-USD currency).
Starting with theNovember 2024invoice month, the header includes aPublisher type field, to indicate thepublisher associated with the transactions and to supportsplit invoices,separating transactions made directly with Google (first party) fromtransactions made with a partner (third party). The possiblePublisher typevalues are:
- Google: First-party, unregulated transaction by Google Cloud.
- Partner: A third-party, regulated or unregulated transaction by a partner.
If you're aReseller, the invoice header information displays only on theparent Cloud Billing account, and isn't displayed when viewing thereport for one of your Cloud Billing subaccounts.
Table view of your detailed costs. You cancustomize the table view using thereport settings.Two different types of table views are available:nested table (default) andflat table.You can alsocontrol which columns are displayed in the table, and you can usefilters to refine the report data to analyze your costs.
To gain more flexibility when analyzing your data in theCost table,you can enable a floatingsummary bar when you select specific rows to analyze. The summary bar works in bothnested and flat table views.
Table footer that displays the totals of thecosts in the table view.
When you view the report using filters in their default state, the reportdata in the table returns all costs for the selected invoice month, andthetotal in the footer matches the total in the report header (1) and matches theinvoice or statement total for the selected document.
If you use thefilters to adjust the data in the table (such as filtering on selected projects orservices), the footer totals will change to reflect the results of the reportfilters. You canreset the filters to return the filters to their default state.
The totals in the footer includetaxes (for each tax type),invoice corrections and billing modifications,androunding errors (if applicable to your Cloud Billing account), as well as thetotal of the costs in the table, based on the selected filters.
Table settings and report tools toadjust the display of the table and todownload the report data to CSV.
Report filters torefine the cost data returned in theCost table.
Understand the Cost table views
The detailed cost information for the selectedInvoice month and filters isdisplayed in the table view of theCost table report.Two different types of table views are available:nested table andflat table.When analyzing your data in theCost table, you can enable a floatingsummary bar when you select specific rows to analyze. The summary bar works in bothnested and flat table views.
You can customize the display of the table view using the table settings.You can also control which columns are displayed in the table, and you canuse filters to refine the usage and cost data returned to the table. For moreinformation, seeconfigure your report views and settings.
Nested table view
A nested table view is a hierarchical, tree-structured view of your cost data,grouped by various dimensions that you specify. Use nested views tosee your invoice costs summarized by the grouping dimensions (such asProject > Service > SKU > Consumption model). You can drill down on the cost details for eachgrouping dimension to see theCost breakdown of each grouped row.
environment:test label row expanded to view the charges by SKUs tagged with that label key.
In the nested table view:
The first column in the table groups the cost details by theselected option.For example, theProject > Service > SKU > Consumption modelGroup byoption generates a single column called
Note: Some usage costs are owned by the Cloud Billing account andaren't included in a project (for example, Support costs). For these charges,theProject > Service > SKU > Consumption model.If you configure aCustom groupingGroup by option, the first columnof the table is titledCustom grouping hierarchy.project namedisplays[Charges not specific to a project], and theproject IDandProject numberfields are empty.You can expand or collapse the hierarchical cost data in each of the groupedrows to analyze theCost breakdown of the grouped total.
Each row in the nested table displays hierarchical cost data representing thecosts by the grouping level (for example, total costs for a project, or fora service).
Starting with your September 2020 invoice month, your tax costs are separatedby each project. To view your tax costs by project in the nested tableview, you must use or configure aGroup by option with
Projectas thefirst grouping dimension. For example, group byProject > Service > SKU > Consumption model.Prior to January 2022, if any of your projects have beendeleted or moved to a different Cloud Billing account,the project associated with the costs is identified only by the
Project number.Starting January 2022,historical project metadata is available with the addition ofproject hierarchy data.The values in the project hierarchy column are displayed in the nestedtable view when you'regrouped byProject > Service > SKU > Consumption model.Project hierarchy values are also displayed in theflat table view of theCost table.
Flat table view
A flat table view is an itemized list of each of the costs and credits incurredfor theInvoice month selected. The data displayed in the flat table viewdepends on the filters that you set. If you're usingfilters in their default state,the flat table view includes rows forall costs and credits incurred for theselected invoice month, and theCost table report totals match your invoice orstatement totals.
To view your cost data in a non-nested flat table, set theTable configurationGroup by setting toNo grouping.
In the flat table view:
Each column contains one type of data (for example, Project name, Servicedescription, or SKU description).
Each row with aUsage
Cost typerepresents the total usage costs for aSKU, for a project.If you selected acost label key,each row represents the total usage costs for a
Note: Some usage costs are owned by the Cloud Billing account andaren't included in a project (for example, Support costs). For these charges,thelabel_key:label_valuepairfor a SKU, for a project(orproject hierarchy).project namedisplays[Charges not specific to a project], and theproject IDfield is empty.If applicable to your Cloud Billing account, theCost table alsoincludes rows for earned discounts, taxes, rounding errors, and any invoiceadjustments.
Starting with your September 2020 invoice month, your tax costs are brokenout by each project. In the flat table view, if you've incurred tax costs,each row with aTax
Cost typerepresents the total tax costs for aSKU description(specific tax type and percentage), for aProject ID.Prior to January 2022, if any of your projects have beendeleted or moved to a different Cloud Billing account,the project associated with the costs is identified only by the
Project number.Starting January 2022,historical project metadata is available with the addition ofproject hierarchy data.The values in the project hierarchy column are displayed onlywhen you're viewing a flat table view or a nested table viewgrouped byProject > Service > SKU > Consumption model.
Report views with summary bar
Thesummary bar helps you to perform quick cost analyses of the data returnedin the table view. In theCost table, select the rows you want to analyze;thesummary bar displays the sum of the costs and credits, the percentageof savings earned, and the subtotal (net cost) of the selected rows. Thesummary bar works in both nested and flat table views.
To open thesummary bar, take one of the following actions:
- Click thesummary bar icon in the toolbar to open or close the summary bar.
- Select individual rows in the table by clicking therow selector checkboxes.
When open, the blue, floatingsummary bar appears on the bottom of theCost table page.
Information in summary bar
- n selections: Indicates the number of rows selected.
- Cost: The total, gross cost of all selected rows. Click theCosthelp icon() to opena cost detail panel. In the panel, costs are grouped by projects, sorted byproject name in ascending order.
- Credits: The sum of all credits for the selected rows. Click theCredits help icon()to open a credits detail panel. In the panel, credits are grouped by projects,sorted by project name in ascending order.
Savings: The percentage of savings comparing costs to credits for theselected rows.
Subtotal: The net cost of the selected rows.
Click theSubtotal help icon()to open a subtotal detail panel. In the panel, subtotals are grouped byprojects, sorted by project name in ascending order.
To close the summary bar, take one of the following actions:
- Click thesummary bar icon in the toolbar to open or close the summary bar.
- In the summary bar, clickclose().
Configure your report views and settings
You can select the costs you want to analyze and configure the display of yourCost table report using the following features:
As you configure the report filters, your page URL updates to include yourselections. UseShare to copy the URL to share the report.
By default, when you first access the report, you see a nestedtable displaying the data for the most recent complete month, grouped byProject > Service > SKU > Consumption model, without any filtering of thedata, and including all the applicablecolumns of data.
Invoice month
In theFilters panel, use theInvoice month selector to choose theinvoice or statement you want to view.
Cost table reports are available for complete months (back to May 2019).Starting with your September 2020 invoice or statement, the invoiceor statement number is appended to the month and year. For example,September 2020 - Invoice 1234567890.
Invoice month returns usage and cost details on the invoice or statementissued for the month selected.
Forinvoiced accounts,it's possible to receive more than one invoice in a calendar month.
- You can select to view only one invoice at a time. You can differentiatebetween invoices based on the invoice number appended to the invoice month(for example, two different invoices that were issued in April 2021 mightlook like this:April 2021 - Invoice 1002003011 andApril 2021 -Invoice 1002003022).
- To supportsplit invoices,starting with the November 2024 invoice month, thepublisher type (either Google or Partner) is displayed below the invoice month and number.
Forself-serve, online accounts,only one statement is issued each month.
Filters
TheCost table report can show all costs and credits for the selected invoiceor statement, or can be filtered to focus on a specific set of resources. By default,when you first access the report, the filters are configured to include allvalues, and the report totalmatches the total of your invoice or statement.As you set filters, the data displayed in theCost table reportadjusts to represent the costs and credits based on the filters selected.
Subaccounts: If you're viewing a primary billing account withsubaccounts,you can select all subaccounts (default) or select a subset of subaccountsby clicking them in the list.
Folders & Organizations: Folders and organizations are components of aproject hierarchy,the resource hierarchy mapping of a project. If theInvoice month isconfigured tostart on or after January 2022, you can select allfolders and organizations (default) that are associated with theprojects that are linked to the Cloud Billing account,or select a subset of folders/organizations.
The values in the selector are listed in alphabetical order by resourcename. To determine if a value is an organization or a folder, look at theID number displayed below each name.ID numbers are prefaced withfolders/ ororganizations/ to indicate thetype of resource.
For the Cloud Billing account you're viewing, if none of thelinked projects are associated with any folders or organizations, then this filter optionisn't displayed.
To view the folders and organizations in theCost table report, look atthe values displayed in theproject hierarchy column.
To learn more about organizations, folders, and projecthierarchy, seeBilling reports: Analyzing your costs by project hierarchy.
Projects: You can select all Google Cloud projects under theCloud Billing account (default) or select a subset of projectsby clicking them in the list.
Services: You can select all services (default) or select a subset ofservices by clicking them in the list.
SKUs: You can select all SKUs (default) or select a subset of SKUs byclicking them in the list. To learn more about SKUs, see thepricing table report.
Applications: You can select allApp Hub applications (default) or select a subset of applications by clickingthem in the list.
App Hub applications might incur usage and costs in more than one billing account and associated projects. Cost data filtered by application might be based on partial data, limited to projects and costs for the Cloud Billing account you are actively viewing.
To filter on costs that are not part of an App Hub application, select[Charges not specific to an application].
Locations: By default, all locations are enabled. By clicking thelocation tiles, you can filter on a subset of locations bygeography(such as Europe),multi-region (such as Global), orregion (such asus-east1). Specifically, the report is filtered by theregions andmulti-regions selected.
Use the tiles ingeography to quickly select(or deselect) all regions and multi-regions in that geography. Multi-regionstiles are marked with an asterisk (for example,
us*).Learn more aboutgeography and regions.
Labels: Labels are key/value pairs youattach to resource usage (for example, Compute Engine orCloud Storage). To filter usage by label:
- Expand theLabels section.
- Select the labelKey.
- Select theValue under that key you want to filter on (the defaultis all values under the selected key).
To add another label with a different key, click+ Add Label, and then select thekey andvalue(s) for the label filter.
To remove a label filter, click (delete) for eachlabel key/value pair you want to remove.
If you want to view costs for Google Kubernetes Engine, you can filter yourresources using the following label keys:
goog-fleet-project: Filter cluster resources byfleet hostproject,if the cluster is registered to a fleet.goog-k8s-cluster-location: Filter GKE resources bylocation.goog-k8s-cluster-name: Filter GKE resourcesby cluster.goog-k8s-node-pool-name: Filter cluster resources by node pool.
To filter GKE resources using the following label keys, youmustenable cost allocation for your GKEclusters:
k8s-namespace: Filter GKE resourcesby namespace.k8s-namespace-labels: Filter GKE resources byfleetnamespacelabel.
When filtering by label keys, you can't select labels appliedto a project. You can select otheruser-created labels that you set up andapplied to Google Cloud services. For more information about labels,seecommon uses of labels andcreating and managing resource labels.
Savings Programs: You can select all applicable savings options (default) to beincluded in the cost calculations, or you can clear some or all of thesavings options to exclude credits and discounts from the cost calculations.
TheSavings Programs filter displays only the specific discount and credit types thatyou incurred in your Google Cloud costs. If a particular type of Savingsoption doesn't apply to your Cloud Billing account, you won't see thatdiscount or credit option in the list.
In theCost table, information about your Savings options is shown intheCredit type,Credit name, andCredit ID columns. A SKU'sConsumption model is also factored into some types of credits and discounts.
See Cloud Billing Reports tolearn more about Savings.
Invoice level charges: You can select all invoice-level charges(default) to be included in theCost table report, or you can clearsome or all of the invoice-level options. Invoice-level charges displayin theCost table and in the footer below the table.
- Reset button: In theCost table report,when filters are in their default state, the costs displayed in the reportreconcile to the costs on your invoice or statement.If you set any filters during your report analysis, you can return thereport filters to their default state by clicking theReset button.
Table settings and report tools
The table settings and report tools are located above the table, and includeoptions to set the table configuration(),control the columns displayed in the table(),toggle the visibility of the summary bar(),and download the report data to CSV().
Table configuration
The cost label key setting controls which costlabel values are displayedin theLabel column, and enables labels as a grouping dimension optionwhen you are configuring a customGroup by option.
To select or change the cost label values that display in theLabel column,open theTable configuration dialog, select aLabel key, and then clickSubmit.
- You can select one label key at a time.
- When a label key is selected, a
label_key:label_valuepair is displayedin theLabels column for the resources tagged by the selected costlabel key. - You can use the selected label key as acustomGroup by grouping dimension.
You can alsofilter on labels even if you don't set a cost label key. However, theLabel column doesn'tdisplay any values until you set a cost label key in the table configurationdialog.
Learn more aboutcreating and managing resource labels.
TheGroup by setting controls your table view, letting you switch betweena flat table view and various nested table views. This setting alsocontrols which rows download to CSV. Each row in the CSV file shows the costssummarized by lowest-level cost breakdown of the grouping dimension youspecify (such asProject > Service > SKU > Consumption model).
Open theTable configuration dialog and choose one of theGroup by settings tosee a flat or a nested, hierarchical view of the cost data, grouped by theoption selected. You can choose a pre-definedGroup by option, or definea custom grouping. A nested table summarizes costs into expandable rows,letting you drill down to view the cost details of the rows.
TheGroup by options available are:
No grouping: Shows aflatCost table.
Project > Service > SKU > Consumption model: Shows anestedCost table and groups costs first by project, then service, then SKU, then Consumptionmodel. Click the arrows(or)next to a row to expand and collapse the details of the row.
Note: When viewing a primary billing accountwith subaccounts(reseller account), your costs are grouped by subaccountfirst, and then grouped by project, then service, then SKU, thenConsumption model.Service > SKU > Consumption model: Shows anestedCost table and groups costs first by service, then SKU, then Consumption model. Clickthe arrows( or)next to a row to expand and collapse the details of the row.
Note: When viewing a primary billing accountwith subaccounts(reseller account), your costs are grouped by subaccountfirst, and then grouped by service, then SKU, then Consumption model.Custom grouping: Shows anestedCost table and groups costs by up to three grouping dimensions that you choose, nestedhierarchically in the order that you set for the selected dimensions. Clickthe arrows( or)next to a row to expand and collapse the details of the row.
Available custom grouping dimensions include the following:
- Project ID,Service ID, andSKU ID options are alwaysavailable.
- Consumption model ID is the Consumption model description(such asDefault) of the consumption model that applies to theprice of usage of a SKU.
- ALabels dimension is available if you firstset a Label key.If you group your costs by labels, you will see rows for resourcecosts grouped by the selected cost label key, and a row forChargesnot tagged by the label key.
- ABilling account ID dimension is available for primary billingaccountswith subaccounts (reseller accounts). If you'reviewing a primary account, theBilling account ID dimension letsyou group your costs by theCloud Billing subaccount.
Column display options
Select the columns to display: You canselect or deselect the columns to show in the table using theColumn display options selector. This setting also controls which columnsdownload to CSV; that is, only thecolumns you specify aredownloaded.
Depending on your screen width and the number of columns that you'redisplaying, you might need to scroll horizontally to view all of the columns.
Change the sort order of the data: Click a column header to sort thedata in the table by that column. You can toggle the sort between descending() andascending() order.
New columns and filters in the Cost table report
In the Cost table report, new columns and filters show you how the consumptionmodel affects your costs and let you filter the savings data for moreflexibility:
Summary bar visibility
Click thesummary bar icon in the toolbar to open or close thesummary bar.
Using thesummary bar, you can quickly analyze a subset of data in the costtable. Thesummary bar works in bothnested table views andflat table views.For more information, seereport views with summary bar.
Download report data to CSV
Click theDownload to CSV icon in the toolbar to download the report data to CSV.For more details on the CSV download, seedownload report to CSV.
Share or bookmark the URL of a customized report
You can bookmark or share the URL of aCost table report you havecustomized. As you configure yourCost table report by setting theInvoice month,cost grouping options,and reportfilters,your page URL updates to include your selections.
Note thatcolumn display settings () arenotincluded in the URL, due to potential URL length limitations. Your sharedURL will open the report with the default columns enabled to display.
- You can share the report by copying the URL. ClickShare tocopy the URL to your clipboard.
Optionally, in your browser, you can bookmark the URL to save the URLwith your report settings.
Note: As you configure your report by setting filters, your pageURL updates to include your selections. It's possible that the URL lengthlimit might be reached if you select many settings (for example, selecting 374SKUs out of 375). In these instances, theShare buttonis disabled and you see a notification on the reports page:The URLmay no longer reflect your selected filters, due to length limitations.
Download the Cost table report to CSV
You can download theCost table data to a comma-separated values (CSV) fileusing theDownload CSV selector in the toolbar above the table. The CSV report is aflat file, without any formatting or nested data options. The data thatdownloads is limited by anyfilters that you set,includes only thecolumns that you selected to view,and includes only the rows that match the table configuration()Group by setting.Starting with your September 2020 invoice orstatement, the CSV file also includes the invoice or statement headerinformation.
CSV file name
For theCost table report, the file name follows this pattern:
[Billing Account name]_Cost table, [YYYY-MM-DD] — [YYYY-MM-DD].csv
For example, a CSV file of the cost table data downloaded for aCloud Billing account namedMy Billing Account, for an invoice monthofMarch 2023, is named:
My Billing Account_Cost table, 2023-03-01 — 2023-03-31.csv
Notes about the data downloaded to CSV
- Thefilters you set customize both your online report view (affecting the rows that aredisplayed in the table), and the data that's downloaded to CSV. If you wantto download all of the cost data on your invoice,reset the filters to their default state.
Thecost grouping option ()you select is used to create anested view in theonline analysis. When you download the data to CSV, aflat file is downloaded, including all of the rows in theCost table report, with datain individual (not nested) columns. The number of rows of data downloaded islimited by theGroup by option you select.
To view and download an itemized list of each of the costs and creditsincurred for the selected invoice, choose theNo grouping option.
Thecolumn selector () letsyou customize both your online report view and which fields aredownloaded. When you download to CSV, only thecolumns you specify aredownloaded.
Starting with your September 2020 invoice or statement, theCost tablereport includes header information pulled from the generated document,including the billing account ID, total amount of the invoice or statement,and currency of the invoice or statement amount. This header informationis downloaded to CSV.
Errors when attempting to download CSV
If the CSV file fails to download, you might see one of the following errors:
This file is too large to download: The CSV file size is limited to 150 MB.If you attempt to download a file that exceeds 150 MB, you'll see an errormessage similar toThis file is too large to download. If your file is toolarge to download to a CSV file, here are a few options you can try:
- To reduce file size, use additionalreport filters to limit the data that's returned to theCost table, then download thefiltered report.
- Deselect (hide) columns of data that you don't need in your CSV file. Selecting fewer columns todisplay in theCost table reduces the amount of data returned and reduces theCSV file size.
- Set customGroup by options to limit the number of rows in the report data.
- Enable billing data export to BigQuery.From your BigQuery tables, you can choose toexport your BigQuery data as CSV (or other formats) to aCloud Storage bucket.
- If you're a Google Cloud reseller or distributor, considerexporting your Channel Services billing data to BigQuery,for detailed billing data that includes all of your customers.Learn more aboutChannel Services andrebilling your Google Cloud customers.
The download request took too long to respond: The CSV query can take upto 90 seconds to gather data before building the report. A timeout conditioncan occur when downloading large data sets or if latency issues are encountered.If your CSV download times out, here are a few options you can try:
- Use additionalreport filters to limit report results and reduce file size and response time.
- Deselect (hide) columns of data that you don't need in your CSV file.
- Don't run concurrent queries. If you started a CSV download, wait untilthe download process finishes before starting another CSV download. Largefiles might take about three minutes to process and download.
Columns in the Cost table
The following data is available in theCost table report (if applicable toyour Cloud Billing account).
When you first load the online view of theCost table report,by default, some columns arenot selected to display. You canchoose which columns to view in the report by setting thecolumn display options.Also, when you download the report to CSV, only the columns that you'veselected to view are downloaded.
| Cost Table Field | Corresponding Invoice Field | Description |
|---|---|---|
| Billing account name | Account Name | The name of the Cloud Billing account that the usage is associated with. If you have access to a primary billing account with subaccounts (a reseller account), this might be the Cloud Billing Subaccount. |
| Billing account ID | Account ID | The Cloud Billing account ID that the usage is associated with. If you have access to a primary billing account with subaccounts (a reseller account), this might be the Cloud Billing Subaccount |
| Project name | Source* * N/A, starting with your November 2019 invoice | The name of the project that generated the Cloud Billing data. When viewing the report for an invoice monthprior to January 2022, if a project was deleted or moved to a different Cloud Billing account, this value is blank, and the project is identified by the Starting with the January 2022 invoice month, Source field was removed from the invoice CSV. TheCost table report provides project-level cost details that are downloadable to CSV. |
| Project ID | N/A | The ID of the project that generated the Cloud Billing data. When viewing the report for an invoice monthprior to January 2022, if a project was deleted or moved to a different Cloud Billing account, this value is blank, and the project is identified by the Starting with the January 2022 invoice month, |
| Project number | N/A | An internally-generated, anonymized, unique identifier for the project. In your support cases and other customer communication, to protect your privacy, Google will refer to your projects by this project number. When viewing the report for an invoice monthprior to January 2022, if you delete a project or move the project to a different Cloud Billing account, the Starting with the January 2022 invoice month, Note: When you first load theCost table report, by default, the |
| Project hierarchy | N/A | Project hierarchy data is availablestarting on January 1, 2022. Projects form the basis for creating, enabling, and using all Google Cloud services.Project hierarchy is the ancestry of a project, the resource hierarchy mapping of the project (Organization > Folder > Project). Projects can stand alone (not be associated with any folders or organizations) or be the child of anOrganization orFolder. Project hierarchy tracks the current and historical project ancestry. For example, changing a project's name, or moving a project to a different folder or organization, affects the historical project ancestry. Starting with theJanuary 2022 invoice month, theCost table report returns a row for each distinct combination ofOrganization >Folder >Project, and the table includes columns forProject name,Project ID,Project number, andProject hierarchy. The values listed in theProject hierarchy column showOrganization name >Folder name.
To analyze your costs by project hierarchy, set the Table configurationGroup by setting toNo grouping, and sort theCost table data on different columns:
To learn more about organizations, folders, and project hierarchy, see Billing reports: Analyzing your costs by project hierarchy. |
| Service description | Product | The invoice description of the Google Cloud service or Google Maps Platform API that reported the Cloud Billing data. For example,Compute Engine. |
| Service ID | N/A | The ID of the Google Cloud service or Google Maps Platform API that reported the Cloud Billing data. For example,6F81-5844-456A. |
| SKU description | Resource Type | The invoice description of the resource SKU used by the service. For example,N1 Predefined Instance Core running in Americas. SKU description also includes different tax types. For example,State sales tax (4.71%) orPST/QST/RST (9.975%). |
| SKU ID | SKU ID | The ID of the resource SKU used by the service. For example,2E27-4F75-95CD. For the full list of SKUs, see Google Cloud SKUs. |
| Consumption model description | N/A | A consumption model represents the price you pay for a certain amount of SKU usage within a certain context. A SKU can have several consumption models, but only one applies to any given amount of usage at a particular time. Each SKU has at least one consumption model, whose description is Consumption models often represent various kinds ofdiscounted prices for SKU usage, such as SKUs covered by committed use discounts (CUDs). For example, if a one-year Flex CUD covers a particular VM usage, then the consumption model that applies to that SKU usage has the description For more information, see Spend-based CUDs program improvements. Note: The first invoice month with |
| Consumption model ID | N/A | The ID of the consumption model that applies to the price of usage for a SKU. For example,7754-699E-0EBF. For a list of Consumption model IDs that apply to the newSpend-based CUDs discounts, see Offers and consumption model IDs. Note: The first invoice month with When you first load theCost table report, by default, the |
| Credit type | N/A | This field describes the purpose or origin of theCredit ID. Credit types include:
If the Note: The first invoice month with |
| Credit name | N/A | The name of the credit associated with the product SKU. This is a human-readable description of analphanumericCredit ID. Examples includeFree trial credit orSpend-based CUD.
Note: The first invoice month with When you first load theCost table report, by default, the |
| Credit ID | N/A | If present, indicates that a credit is associated with the product SKU.Credit ID values are either an alphanumeric unique identifier (for example,12-b34-c56-d78), or a description of the credit type (such asCommitted Usage Discount: CPU).If the credit ID field is empty, then the product SKU isn't associated with a credit. Note: The first invoice month with When you first load theCost table report, by default, the |
| Label | N/A | Thelabel_key:label_value pair. For example,environment:production. Thelabel_key (for example,environment) is selected using the Label key selector accessible in theTable configuration dialog. Thelabel_value (for example,production) is one of the values corresponding to the selected label key.Learn more about creating and managing resource labels. |
| Cost type | Description | A description of the type of cost for the line item.
|
| Usage start date | Start Date | The date of the first occurrence of usage for this invoice month (see previous note on the possibility of late-arriving usage). |
| Usage end date | End Date | The date of the last occurrence of usage for this invoice month (see previous note on the possibility of late-arriving usage). |
| Usage amount | Quantity | The quantity of usage units used. |
| Usage unit | Unit | The billing unit of the usage (such as hour or gibibyte month). |
| Seller name | N/A | The legal name of the seller. Note: The first full month of data with this column isDecember 2024.When you first load theCost table report, by default,the |
| Transaction type | N/A | The transaction type of the seller. The transaction type might be one of the following:
When you first load theCost table report, by default,the |
| Cost in micros | N/A | The calculated cost of the usage in micro units (µ).Micro is a unit prefix in the metric system denoting a factor of 10−6 (one millionth). When we calculate your usage costs, we convert all costs to micro units to provide the level of accuracy needed to calculate any rounding errors. Examples:
When you first load theCost table report, by default, the |
| List cost | N/A | The List cost column is available starting with yourMay 2021 invoice, and only for Cloud Billing accountsassociated with a custom pricing contract.When you first load theCost table report, by default, the |
| Unrounded cost | N/A | The calculated cost of the usage, in the currency the Cloud Billing account is configured to use, to a precision of up to six decimal places.Unrounded cost is calculated using the SKU prices associated with your Cloud Billing account and can be helpful when analyzing your cost details and understanding the source of any discrepancies due to rounding.If you're using theCSV version of this report for analysis, we recommend using the Unrounded cost column for your calculations.Note: If you have custom contract pricing, theUnrounded cost amounts are calculated using your contract prices; otherwiseUnrounded cost amounts are calculated using list prices. |
| Cost | Amount | The calculated cost of the usage, in the currency the Cloud Billing account is configured to use, rounded to two decimal places.Cost is calculated using the SKU prices associated with your Cloud Billing account and represents the amount charged for usage.Note: If you have custom contract pricing, theCost amounts are calculated using your contract prices; otherwiseCost amounts are calculated using list prices. |
Notes about the Cost table report
Matching your invoice
When viewing the report using thedefault filter settings,theCost table report matches your existing invoice as closely as possible.On theCost table report, the display of credits and usage-based discounts(for example, promotional credits or sustained use discounts) are listed asseparate line items.Online Cloud Billing reports andCloud Billing Export to BigQuery don't separate credits and discounts into separate line items.
TheTotal amount listed in your invoice is the sum of allUnrounded costline items, rounded to two decimal places. If you're using theCSV version of this report to reconcile to your invoice total, we recommend doing the following:
- Before you download to CSV,reset your filters to their default state.
- Use the
Unrounded costamounts for your calculations.
How costs are calculated for an invoice month
Invoice month refers to the time period that an invoice orstatement covers.
- The type of document you receive depends on thetype of Cloud Billing account you are viewing.
- Invoiced (offline) accounts receive invoices.
- Self-serve (online) accounts receive statements.
- Google Cloud products report usage and cost data to Cloud Billingprocesses at varying intervals. As a result, you might see a delay between youruse of Google Cloud services, and the usage and costs being available toview in Cloud Billing. Typically, your costs are available within aday, but can sometimes take more than 24 hours.
- Late-reported usage costs at the end of an invoice month might not beincluded on that invoice month's statement or invoice and are reported onthe next month's invoice or statement.
- TheCost table report is meant to match the charges on your invoice orstatement. The possible result of late-reported usage is that yourCosttable report might include costs from more than one calendar month. Forexample, your October invoice or statement might include costs incurred atthe end of September combined with the October costs.
- To view your usage costs by actual usage date (calendar date or date range),see theonline reports or analyze yourexported billing data.
- Invoice-level charges, including taxes, adjustments, and rounding errors,are included in theCost table footer. For guidance on understanding andanalyzing any adjustments, seeUnderstand memos and adjustments.
If you have a custom pricing contract, you might receivepromotionalcredits to use on Google Cloud as part of the contract. For example,you might receive $1,000 to use on Compute Engine resources.Promotional credits are typically considered a form of payment. Whenavailable, promotional credits are automatically applied to reduce yourtotal bill.
The terms of your contract specify whether the promotional credits apply toyour costs calculated at thelist price of a SKU, or thenet price(after discounts). View the
List costcolumn to see your usage costscalculated using list prices.If your promotional credits apply to costs that are calculated at thelistprice, in theCost table report, there's a service called
Invoice,with a SKU calledContract billing adjustment. This SKU adjusts yourcredits so that they apply to the costs at list price. To see the usage thatthe adjustment is for,use the Cloud Billing data export to BigQuery.
SKU Prices
Invoice usage details don't include a column for the SKU price. If yourCloud Billing account is associated with a custom pricing contract,theUnrounded cost andCost amounts are calculated using the contractprices. TheList cost amounts are calculated using thepublicly available list prices. You can compareList cost toCost todetermine how much you're saving with your custom contract prices.
To view your prices per SKU, see thePricing table report orexport your Cloud Billing prices to BigQuery.If you have questions regarding pricing per SKU, contact your AccountRepresentative for more details.
Historical project data
Prior to January 1, 2022:
When viewing reports for invoice monthsprior to January 2022, historicalproject metadata isnot supported in theCost table report.If you delete a project or move the project to a differentCloud Billing account, the following values areno longer displayedin theCost table for the project: Project Name, Project ID, Billing account ID,and Billing account name. TheProject number value persists after a project is deleted. If you enabled theexport of Cloud Billing data to BigQuery,you can find your historical project information in your BigQuerytables.
Starting on January 1, 2022:
When viewing reports for an invoice monthon or after January 2022, with theaddition ofproject hierarchy data,historical project metadata is supported in theCost table. StartingJanuary 1, 2022, when you delete a project or move a project to a differentCloud Billing account,if that project incurred usage during thetime period selected, the following values are listed in theCost table forthe project: Billing account name, Billing account ID, Project Name, ProjectID, Project number, andProject hierarchy.If you enabled theexport of Cloud Billing data to BigQuery,theCost table's project metadata information should match the historicalproject information in your BigQuery tables.
Taxes by project and by invoice
Starting September 1, 2020, your cost details in theCost tableshow your tax costs for each of your projects, instead of as an invoice-levelcost. Invoice-level tax totals continue to be displayed in the footer of theCost table report. You can identify and filter on your tax details using theCost type column and theSKU description column.
For example, for costs recordedbefore September 1, 2020, your costdetail data looked similar to the following example, which shows a total taxcost of $10.
Billing account ID | Project ID | SKU description | Cost type | Cost |
|---|---|---|---|---|
| 123456-ABCDEF-123456 | example-project | N1 Predefined Instance Core | Usage | $60 |
| 123456-ABCDEF-123456 | test-project | N1 Predefined Instance Core | Usage | $40 |
| 123456-ABCDEF-123456 | 0 | State sales tax (10.0%) | Tax | $10 |
For costs recordedafter September 1, 2020, the $10 tax total is brokenout to attribute $6 forexample-project, and $4 fortest-project:
Billing account ID | Project ID | SKU description | Cost type | Cost |
|---|---|---|---|---|
| 123456-ABCDEF-123456 | example-project | N1 Predefined Instance Core | Usage | $60 |
| 123456-ABCDEF-123456 | example-project | State sales tax (10.0%) | Tax | $6 |
| 123456-ABCDEF-123456 | test-project | N1 Predefined Instance Core | Usage | $40 |
| 123456-ABCDEF-123456 | test-project | State sales tax (10.0%) | Tax | $4 |
Viewing project-level taxes in the nested table view
To view your tax costs by project in thenested table view,you must use or configure aGroup by option withProject as the first grouping dimension. For example, group byProject -> Service -> SKU.
Viewing project-level taxes in the flat table view
In theflat table view, if you have incurred tax costs,project-level taxes are displayed in rows near the end of the table. Eachrow with aTaxCost type represents the total tax costs for aSKU description (specific tax type and percentage), attributed to aproject.
Project ID column displays0. For example, Support costs are owned by the Cloud Billing account,and not by a specific project. For taxes on these costs, theProject IDcolumn displays0.About split invoices
You might receive multiple invoices for a set of transactions, also known assplit invoices,if your product purchases meet all of the following criteria:
- You use the Cloud Marketplace to purchase first-party Google productsand third-party products from a Google partner reseller.
- Your transactions occur through theagency transaction model.
Split invoices separate the Google services you buy through a Google partnerreseller (third-party transactions) from services you buy directly from Google(first-party transactions).
Starting with theNovember 2024 invoice month, invoices include aPublisher type to indicate the publisher associated with the transactions. ThePublisher typeis displayed in theCost table header,and in theInvoice month filter.The possiblePublisher type values are:
- Google: First-party, unregulated transaction by Google Cloud.
- Partner: A third-party, regulated or unregulated transaction by a partner.
TheCost table also provides additionalcolumns you can view to see purchase information about your transactions:
Seller name:The legal name of the seller.Transaction type:The transaction type of the seller, indicating services sold by Google, or third-party services either resold by Google or sold by a partner.
These columns are not visible by default. To view theSeller name orTransaction type columns in your Cost table, select them in thecolumn display options.
For more information about split invoices, seeSplit invoicing for agency model transactions.
About totals in the invoice header and the Cost table footer
When yourCost table report is configured to view all costs and credits foran invoice month, typically, the total in the invoice header and theCost tablefooter are the same. Rarely, you might notice the header total doesn't matchthe footer total.
Starting with theSeptember 2020 invoice or statement, theCost tablereport includes header information for the document providing details such asthe invoice number, the billing account ID, and the invoice or statement totals.
- The invoicetotal amount due or statementtotal new activity listed in theheader is determined based on the timing of when the invoice or statementdocument was generated. The total in the report header isn't affected byany filters you might set in theCost table report.
- TheTotal listed in theCost table footer is generated by summing all the
Unrounded costline items in theCost table report, then rounding to twoplaces. If you set filters to refine the costs returned in theCost table,the footer total is calculated on the filtered costs.
In some cases, when viewing an unfiltered report, the two totals might notmatch. This might occur if your Cloud Billing account is issued morethan one invoice or statement in a month, or if a credit or debit memo isissued for your billing account. For example:
- If you close your Cloud Billing account, you might be issued morethan one invoice or statement in the same month. There is a delay in usagereporting, so you might get an additional invoice to cover the cost of usagethat was reported after you closed your Cloud Billing account.
- If you're issued a credit memo, those credits or charges might beapplied to your invoice, but not be reflected in the cost line items on theCost table report. For guidance on understanding and analyzingany adjustments, seeUnderstand memos and adjustments.
If you notice the totals in yourCost table report's header and footer don'tmatch, and you need help reconciling your invoice or statement,contact Cloud Billing Support for assistance.
Related topics
- Get an invoice, statement, or receipt
- Understand your monthly invoice
- View your Cloud Billing reports and cost trends
- Export Cloud Billing data to BigQuery
- View your cost and payment history
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-02-19 UTC.