Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
31 commits
Select commit Hold shift + click to select a range
0f239d4
Add Bill Overview docs for Plan & Usage LA launch (March 24)
rebeccagadzuk Mar 21, 2026
9cfbdc9
Add Bill Overview screenshots (light mode + partial dark mode)
rebeccagadzuk Mar 21, 2026
e8eb0f9
Remove dark mode screenshots (pending, to be added later)
rebeccagadzuk Mar 21, 2026
6a5f981
Fix toggle button labels and callout link rendering
rebeccagadzuk Mar 21, 2026
b763156
Update bill_overview intro: add description, remove estimates note
rebeccagadzuk Mar 21, 2026
4b464c0
Remove estimated_cost from sub-org cost trends permission row
rebeccagadzuk Mar 21, 2026
def6da7
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk Mar 23, 2026
f87d7bc
Update config/_default/menus/main.en.yaml
rebeccagadzuk Mar 23, 2026
199c145
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk Mar 23, 2026
2693d73
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk Mar 23, 2026
446dca4
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk Mar 23, 2026
e7a5aa5
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk Mar 23, 2026
a14429d
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk Mar 23, 2026
70d10a8
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk Mar 24, 2026
a6b58ec
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk Mar 24, 2026
8741e3f
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk Mar 24, 2026
729ab49
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk Mar 24, 2026
ee9c4e8
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk Mar 24, 2026
1d760d6
Add intro sentence to Permissions section
rebeccagadzuk Mar 24, 2026
e286c99
Update section title to 'Revert to the previous layout'
rebeccagadzuk Mar 24, 2026
634e9bc
Remove accidental inline comment from Global filters section
rebeccagadzuk Mar 24, 2026
4db053b
Clarify Billing Dimension filter description with examples
rebeccagadzuk Mar 24, 2026
b164d89
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk Mar 25, 2026
8fb5f51
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk Mar 25, 2026
274319e
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk Mar 25, 2026
b0d161d
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk Mar 25, 2026
b49d370
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk Mar 25, 2026
7bc7227
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk Mar 25, 2026
5b5799c
Update content/en/account_management/plan_and_usage/bill_overview.md
rebeccagadzuk Mar 25, 2026
f349d53
Remove Cost Type filter from Product List section
rebeccagadzuk Mar 25, 2026
2f09186
Merge branch 'master' into rebecca.gadzuk/bill-overview-la-docs
rebeccagadzuk Mar 25, 2026
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 @@ -9215,11 +9215,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/
140 changes: 140 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,140 @@
---
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:

- **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 or metering dimension (for example, Infra Hosts, Indexed Logs, or Synthetic 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
- **Projected total**: Estimated total cost if current usage patterns continue through end of month, with month-over-month percentage change

## 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 displays products worth investigating based on four sort options:

- **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**, 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.

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` 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.

{{< 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**: Click to open Cloud Cost Management, pre-filtered to the selected billing dimension.

### 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**: Click to open **Usage Attribution**, pre-filtered to the selected billing dimension.

## Revert to the previous layout

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.

## Permissions

The following permissions are required to access each section of Bill Overview:

| Section | Required permission |
Comment thread
rebeccagadzuk marked this conversation as resolved.
|---|---|
| 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.
Loading