Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
15 commits
Select commit Hold shift + click to select a range
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 6 additions & 1 deletion config/_default/menus/main.en.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -9189,11 +9189,16 @@ menu:
parent: account_management
identifier: safety_center
weight: 12
- name: Plan and Usage
- name: Plan & Usage
url: account_management/plan_and_usage/
parent: account_management
identifier: account_management_plan_and_usage
weight: 13
- name: Bill Overview
identifier: account_management_bill_overview
url: account_management/plan_and_usage/bill_overview/
parent: account_management_plan_and_usage
weight: 1300
- name: Cost Details
identifier: account_management_cost_details
url: account_management/plan_and_usage/cost_details/
Expand Down
11 changes: 8 additions & 3 deletions content/en/account_management/plan_and_usage/_index.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,14 @@
---
title: Plan and Usage Settings
title: Plan & Usage
description: Access usage reports, plan settings, and billing history for your Datadog account, including multi-organization usage tracking and cost analysis.
---

[Administrators][1] can access the [organization settings][2] by clicking Plan & Usage from the Account menu in the bottom of the left side navigation or by selecting Plan & Usage from the header dropdown at the top of the Personal Settings page.

{{< callout url="" btn_hidden="true" header="New: Bill Overview" >}}
A new **Bill Overview** experience is now in Limited Availability and will start rolling out automatically to all organizations starting March 2026. [Learn more](/account_management/plan_and_usage/bill_overview/).
{{< /callout >}}

## Usage reports

View hourly usage of your account across all billable parameters as well as the top 5000 custom metrics submitted. If your organization is the parent-organization in a [multi-org account][3], you can also view the usage of child-organization accounts by toggling between "Overall" and "Individual Organizations" at the top of the page. Individual child-organization accounts are isolated. They are only able to view their own usage and custom metrics.
Expand Down Expand Up @@ -41,6 +45,7 @@ Usage data for trial products appears in the **Usage & Cost** tab. You are not b
{{< img src="account_management/plan_and_usage/trial-management-usage.png" width="70%" alt="Usage & Cost section showing a trial product metric with an indicator icon and tooltip explaining the estimated cost" >}}

[1]: /account_management/users/default_roles/
[2]: https://app.datadoghq.com/account/billing
[2]: https://app.datadoghq.com/organization-settings/
[3]: /account_management/multi_organization/
[4]: mailto://success@datadoghq.com
[4]: mailto:success@datadoghq.com
[5]: /account_management/plan_and_usage/bill_overview/
144 changes: 144 additions & 0 deletions content/en/account_management/plan_and_usage/bill_overview.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,144 @@
---
title: Bill Overview
description: View Datadog costs, usage trends, and projected end-of-month costs in a single page, with daily breakdowns, product-level detail, and multi-organization filtering.
further_reading:
- link: "account_management/plan_and_usage/cost_details/"
tag: "Documentation"
text: "Cost Details"
- link: "account_management/plan_and_usage/usage_details/"
tag: "Documentation"
text: "Usage Details"
- link: "account_management/billing/usage_attribution/"
tag: "Documentation"
text: "Usage Attribution"
- link: "cloud_cost_management/datadog_costs/"
tag: "Documentation"
text: "Datadog Costs"
---

View Datadog costs, usage trends, and projected end-of-month costs in a single page, with daily breakdowns, product-level detail, and multi-organization filtering.

The [**Bill Overview** page][1] gives administrators a single view of Datadog costs and usage. It is automatically enabled during the phased rollout starting March 2026.

## Global filters

The following filters apply to the **Bill Overview** page:```

the original isn't bad or wrong, just making this fit with the docs tone a little more

- **Product Category**: Filter all views by broader product family, such as Infrastructure, APM, Logs, Security, or AI/ML.
- **Billing Dimension**: Filter to a specific billing dimension.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

can we define Billing Dimension in a sentence here? looking in-app, it seems like this refers to individual products inside product areas?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think the best definition is: A billing dimension is a specifically metered and billed Datadog product or feature (for example, Infra Hosts, Indexed Logs, or Synthetics Browser Tests)

- **Sub-Org**: Filter to a specific child organization.
- **Group by Sub-Org**: Toggle to group costs by sub-organization.
- **Time range**: Select a billing period. Use the backward and forward arrows to navigate from month to month.

## Cost summary

At the top of the page, the cost summary shows:

- **Estimated cost to date**: Total estimated cost for the days elapsed in the current billing period (for example, "Estimated Mar 1–Mar 18 Cost").
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- **Estimated cost to date**: Total estimated cost for the days elapsed in the current billing period (for example, "Estimated Mar 1–Mar 18 Cost").
- **Estimated cost to date**: Total estimated cost for the days elapsed in the current billing period

cutting this bit just because it's in the screenshot below so i think it doesn't add more info here

- **Projected total**: Estimated total cost if current usage patterns continue through end of month, with month-over-month percentage change.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- **Projected total**: Estimated total cost if current usage patterns continue through end of month, with month-over-month percentage change.
- **Projected total**: Estimated total cost if current usage patterns continue through end of month, with month-over-month percentage change

cutting the periods in both list items because they're fragments instead of sentences


## Daily Cost Breakdown

Below the cost summary, the **Daily Cost Breakdown** stacked bar chart shows costs broken down by billing dimension for each day of the selected period. Each color in the chart represents a different billing dimension. Click the expand icon to view the chart full screen.

{{< img src="account_management/plan_and_usage/bill-overview-main-light.png" alt="Bill Overview page showing the cost summary header, Daily Cost Breakdown stacked bar chart, and Trends tab" >}}

## Trends tab

The **Trends** tab surfaces products worth investigating based on four sort options:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The **Trends** tab surfaces products worth investigating based on four sort options:
The **Trends** tab displays products worth investigating based on four sort options:

(please lmk if this isn't a precise enough word)


- **Highest % Cost Change**
- **Highest Cost Change ($)**
- **Highest Total Cost**
- **Highest % Usage Change**

Select a sort option to update the cards displayed. Each product card shows:

- **Total Cost** for the period
- **Projected EOM** cost
- **Month-over-month change** (percentage badge)
- **Daily Cost** bar chart spanning the previous and current month
- **Usage** (total units consumed, in natural units — for example, PB of scanned data, custom metrics) (on Total Cost and Usage-related cards)
Comment on lines +59 to +63
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- **Total Cost** for the period
- **Projected EOM** cost
- **Month-over-month change** (percentage badge)
- **Daily Cost** bar chart spanning the previous and current month
- **Usage** (total units consumed, in natural unitsfor example, PB of scanned data, custom metrics) (on Total Cost and Usage-related cards)
- **Total Cost** for the period
- **Projected EOM** cost
- **Month-over-month change**, displayed as a percentage badge
- **Daily Cost** bar chart spanning the previous and current month
- **Usage**, displayed as total units consumed, in natural units; for example, PB (petabytes) of scanned data, Custom Metrics; displayed only on Total Cost and Usage-related cards


Click **View Details** on any card to open the [product detail page][2].

{{< img src="account_management/plan_and_usage/bill-overview-trends-light.png" alt="Trends tab showing product cards sorted by Highest Total Cost" >}}

## Product List tab

The **Product List** tab shows all billing dimensions in a table with cost and usage side by side.

#### Additional filter (Product List only)

- **Cost Type**: Filter to show **Committed** costs, **On-Demand** costs, or **All** costs.
Comment on lines +73 to +75
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i'm thinking we can replace this text with a note callout instead, since it's only one new filter (so i don't think we have to use a list). here's what i wrote but lmk if you think it should be different!

When you select the Product List tab, an additional filter for Cost Type appears at the top of the page. You can filter by Committed costs, On-Demand costs, or All costs.


Click anywhere on a product row to open the [product detail page][2]. Hover over the end of a row to quickly create a cost monitor for that billing dimension.

#### Table columns

| Column | Description |
|---|---|
| Billing Dimension | Name of the product or billing dimension |
| Cost — Total | Cost billed to date for the period |
| Cost — Proj. EOM | Projected end-of-month total cost |
| Cost — Change | Dollar and percentage change vs. the prior period |
| Usage — Total | Total usage in natural units |
| Usage — Change | Usage change vs. the comparison period |

Toggle between **Monthly** and **Daily** views using the controls above the table. Download the full table as a CSV using the **Download as CSV** button. The table is paginated (10 rows per page by default).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Toggle between **Monthly** and **Daily** views using the controls above the table. Download the full table as a CSV using the **Download as CSV** button. The table is paginated (10 rows per page by default).
Toggle between **Monthly** and **Daily** views using the controls above the table. Download the full table as a `.csv` file using the **Download as CSV** button. The table is paginated, displaying 10 rows per page by default.


{{< img src="account_management/plan_and_usage/bill-overview-product-list-light.png" alt="Product List tab showing the billing dimensions table with Cost and Usage columns" >}}

## Product detail page

Click **View Details** on a Trends card, or click any row in the Product List table, to open the product detail page for a single billing dimension.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Click **View Details** on a Trends card, or click any row in the Product List table, to open the product detail page for a single billing dimension.
Click **View Details** on a Trends card or click any row in the **Product List** table to open the product detail page for a single billing dimension.


{{< img src="account_management/plan_and_usage/bill-overview-detail-light.png" alt="Product detail page showing Cost Overview and Usage Overview sections with daily bar charts" >}}

### Cost Overview

- **Total Cost**: Total cost billed to date for the selected period.
- **Projected Cost Change**: The projected dollar and percentage change vs. the prior period.
- **Projected EOM**: Estimated total cost at end of month.
- **Daily Cost** bar chart: Day-by-day cost for the previous and current month, with the current month highlighted. Hover over any bar to see the cost for that day. Toggle **Show Usage Charges Only** to isolate on-demand charges.
- **Drilldown in Cloud Cost**: Dig deeper into your costs with Cloud Cost Management, pre-filtered to the selected billing dimension.
Comment on lines +102 to +106
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- **Total Cost**: Total cost billed to date for the selected period.
- **Projected Cost Change**: The projected dollar and percentage change vs. the prior period.
- **Projected EOM**: Estimated total cost at end of month.
- **Daily Cost** bar chart: Day-by-day cost for the previous and current month, with the current month highlighted. Hover over any bar to see the cost for that day. Toggle **Show Usage Charges Only** to isolate on-demand charges.
- **Drilldown in Cloud Cost**: Dig deeper into your costs with Cloud Cost Management, pre-filtered to the selected billing dimension.
- **Total Cost**: Total cost billed to date for the selected period
- **Projected Cost Change**: The projected dollar and percentage change vs. the prior period
- **Projected EOM**: Estimated total cost at end of month
- **Daily Cost** bar chart: Day-by-day cost for the previous and current month, with the current month highlighted. Hover over any bar to see the cost for that day. Toggle **Show Usage Charges Only** to isolate on-demand charges.
- **Drilldown in Cloud Cost**: Click to open Cloud Cost Management, pre-filtered to the selected billing dimension.

we can definitely reword that last point if what i wrote is wrong. i was trying to make it clear that it's clickable instead of just a measurement to look at


### Usage Overview

- **Total Usage**: Total units consumed for the selected period.
- **Usage Change**: Change in usage vs. the prior period (amount and percentage).
- **Usage breakdown by sub-dimension**: Individual usage totals for each sub-dimension (for example, Sensitive Data Scanner lists Scanned Events, Scanned Logs, Scanned RUM Sessions, and Scanned Spans separately).
- **Usage Types** bar chart: Day-by-day usage stacked by sub-dimension.
- **Allotment Usage**: Progress bar showing consumed vs. contracted allotment. Displays ">100%" when usage exceeds the allotment.
- **Drilldown in Usage Attribution**: Opens Usage Attribution pre-filtered to this billing dimension.
Comment on lines +110 to +115
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- **Total Usage**: Total units consumed for the selected period.
- **Usage Change**: Change in usage vs. the prior period (amount and percentage).
- **Usage breakdown by sub-dimension**: Individual usage totals for each sub-dimension (for example, Sensitive Data Scanner lists Scanned Events, Scanned Logs, Scanned RUM Sessions, and Scanned Spans separately).
- **Usage Types** bar chart: Day-by-day usage stacked by sub-dimension.
- **Allotment Usage**: Progress bar showing consumed vs. contracted allotment. Displays ">100%" when usage exceeds the allotment.
- **Drilldown in Usage Attribution**: Opens Usage Attribution pre-filtered to this billing dimension.
- **Total Usage**: Total units consumed for the selected period
- **Usage Change**: Change in usage vs. the prior period (amount and percentage)
- **Usage breakdown by sub-dimension**: Individual usage totals for each sub-dimension. For example, Sensitive Data Scanner lists Scanned Events, Scanned Logs, Scanned RUM Sessions, and Scanned Spans separately.
- **Usage Types** bar chart: Day-by-day usage stacked by sub-dimension
- **Allotment Usage**: Progress bar showing consumed vs. contracted allotment; displays ">100%" when usage exceeds the allotment
- **Drilldown in Usage Attribution**: Click to open **Usage Attribution**, pre-filtered to the selected billing dimension.


## Toggle back to the previous layout
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

what if we changed this heading to "Revert to previous layout"? might be easier to read at a glance?


If your organization is on the new Bill Overview and you prefer the previous layout, click **Disable Preview** in the page header. This toggle is available to all organizations and persists for your session.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
If your organization is on the new Bill Overview and you prefer the previous layout, click **Disable Preview** in the page header. This toggle is available to all organizations and persists for your session.
If your organization is on the new **Bill Overview** and you prefer the previous layout, click **Disable Preview** in the page header. This toggle is available to all organizations and persists for your session.


{{< img src="account_management/plan_and_usage/toggle-back-header.png" alt="Bill Overview page header showing the Disable Preview button" >}}

To return to Bill Overview, click **Enable Preview** in the header.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
To return to Bill Overview, click **Enable Preview** in the header.
To return to **Bill Overview**, click **Enable Preview** in the header.


## Permissions

| Section | Required permission |
Comment on lines +125 to +127
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

do you think we need an intro sentence here? something about how you need these permissions to view the Bill Overview page?

|---|---|
| Bill Overview (cost data) | `BILLING_READ` |
| Usage Tab | `USAGE_READ` |
| Plan Details | `BILLING_READ` |
| Billing History | `BILLING_READ` |
| Usage Attribution | `USAGE_READ` + Enterprise or Pro plan |
| Sub-org cost trends | Parent org must have `suborg_cost_trends` enabled |

For information on managing permissions, see [Role Based Access Control][3].

## Further reading

{{< partial name="whats-next/whats-next.html" >}}

[1]: https://app.datadoghq.com/billing/bill-overview
[2]: /account_management/plan_and_usage/bill_overview/#product-detail-page
[3]: /account_management/rbac/
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,10 @@ further_reading:
text: "Managing multiple-organization accounts"
---

{{< callout url="" btn_hidden="true" header="New: Bill Overview" >}}
A new Bill Overview experience is now in Limited Availability and will start rolling out automatically to all organizations starting March 2026. [Learn more](/account_management/plan_and_usage/bill_overview/).
{{< /callout >}}

## Overview

Cost Summary and Cost Chargebacks help you understand your estimated month-to-date, projected end-of-month, and historical Datadog costs. Cost data is available for the past 15 months.
Expand Down Expand Up @@ -162,3 +166,4 @@ Products billed by the sum of usage throughout the month include indexed logs an
[6]: /api/latest/usage-metering/#get-projected-cost-across-your-account
[7]: /cloud_cost_management/cost_changes/monitors/?tab=costmetricbased
[8]: /cloud_cost_management/datadog_costs/
[9]: /account_management/plan_and_usage/bill_overview/
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,10 @@ aliases:
- /account_management/billing/usage_details/
---

{{< callout url="" btn_hidden="true" header="New: Bill Overview" >}}
A new Bill Overview experience is now in Limited Availability and will start rolling out automatically to all organizations starting March 2026. [Learn more](/account_management/plan_and_usage/bill_overview/).
{{< /callout >}}

## Overview

Administrators can access the [Usage][1] page by hovering over their username at the bottom left, then navigate to:
Expand Down Expand Up @@ -170,3 +174,4 @@ For billing questions, contact your [Customer Success][10] Manager.
[8]: https://docs.datadoghq.com/logs/archives/rehydrating/?tab=awss3#overview
[9]: /help/
[10]: mailto:success@datadoghq.com
[11]: /account_management/plan_and_usage/bill_overview/
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.