Skip to content

changelog: billable usage and budget alerts now in product sidebars#31186

Draft
iglesiasbrandon wants to merge 3 commits into
productionfrom
changelog/billable-usage-product-sidebar
Draft

changelog: billable usage and budget alerts now in product sidebars#31186
iglesiasbrandon wants to merge 3 commits into
productionfrom
changelog/billable-usage-product-sidebar

Conversation

@iglesiasbrandon
Copy link
Copy Markdown
Collaborator

@iglesiasbrandon iglesiasbrandon commented Jun 2, 2026

Summary

Adds a changelog entry for the billable usage sidebar widget now shipping across 8 Developer Platform product pages (Workers & Pages, D1, R2, Workers KV, Queues, Vectorize, Durable Objects, and Containers). Pay-as-you-go customers can view current-period spend and create budget alerts without leaving the product they are working in.

Checklist

  • Confirm rollout date (currently 2026-06-04) with Ashley Peacock before publishing
  • Confirm screenshot account data is approved for public use

@github-actions github-actions Bot added product:durable-objects Durable Objects: https://developers.cloudflare.com/workers/learning/using-durable-objects/ product:changelog size/m labels Jun 2, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 2, 2026

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/assets/images/ @cloudflare/pm-changelogs, @cloudflare/product-owners
/src/content/changelog/ @cloudflare/pm-changelogs, @cloudflare/product-owners

@iglesiasbrandon iglesiasbrandon force-pushed the changelog/billable-usage-product-sidebar branch from 81bf047 to 2b1c09f Compare June 2, 2026 13:57
@ask-bonk ask-bonk Bot added changelog Adds or updates changelog entries/pages. documentation Documentation edits fundamentals labels Jun 2, 2026
Copy link
Copy Markdown
Contributor

@ask-bonk ask-bonk Bot left a comment

Choose a reason for hiding this comment

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

2 suggestions and 1 comment posted.

  • HIGH Scope creep — the Durable Objects jurisdiction changes (new changelog entry, id.mdx, and data-location.mdx) are unrelated to the billing sidebar widget described in the PR title. Move them to a separate PR, or update the title and description to cover both features.
  • MEDIUM id.mdx is missing a TypeScript tab in the jurisdiction examples.
  • LOW fundamentals changelog: "Usage based billing" should be hyphenated.

Comment thread src/content/changelog/fundamentals/2026-06-04-billable-usage-product-sidebar.mdx Outdated
@@ -0,0 +1,30 @@
---
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

This Durable Objects changelog entry and the related id.mdx / data-location.mdx changes are outside the scope of the billing sidebar widget described in the PR title. Move to a separate PR or update the title and description to cover both features.

Comment on lines +199 to +223
<Tabs>

<TabItem label="JavaScript" icon="seti:javascript">

```js
const plainId = env.MY_DURABLE_OBJECT.idFromName("foo");
const euId = env.MY_DURABLE_OBJECT.jurisdiction("eu").idFromName("foo");
console.assert(plainId.jurisdiction === undefined, "no jurisdiction set");
console.assert(euId.jurisdiction === "eu", "jurisdiction matches namespace");
```

</TabItem>

<TabItem label="Python" icon="seti:python">

```python
plain_id = env.MY_DURABLE_OBJECT.idFromName("foo")
eu_id = env.MY_DURABLE_OBJECT.jurisdiction("eu").idFromName("foo")
assert plain_id.jurisdiction is None, "no jurisdiction set"
assert eu_id.jurisdiction == "eu", "jurisdiction matches namespace"
```

</TabItem>

</Tabs>
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Add TypeScript tab for consistency with the name section above:

Suggested change
<Tabs>
<TabItem label="JavaScript" icon="seti:javascript">
```js
const plainId = env.MY_DURABLE_OBJECT.idFromName("foo");
const euId = env.MY_DURABLE_OBJECT.jurisdiction("eu").idFromName("foo");
console.assert(plainId.jurisdiction === undefined, "no jurisdiction set");
console.assert(euId.jurisdiction === "eu", "jurisdiction matches namespace");
```
</TabItem>
<TabItem label="Python" icon="seti:python">
```python
plain_id = env.MY_DURABLE_OBJECT.idFromName("foo")
eu_id = env.MY_DURABLE_OBJECT.jurisdiction("eu").idFromName("foo")
assert plain_id.jurisdiction is None, "no jurisdiction set"
assert eu_id.jurisdiction == "eu", "jurisdiction matches namespace"
```
</TabItem>
</Tabs>
<Tabs>
<TabItem label="JavaScript" icon="seti:javascript">
```js
const plainId = env.MY_DURABLE_OBJECT.idFromName("foo");
const euId = env.MY_DURABLE_OBJECT.jurisdiction("eu").idFromName("foo");
console.assert(plainId.jurisdiction === undefined, "no jurisdiction set");
console.assert(euId.jurisdiction === "eu", "jurisdiction matches namespace");
const plainId: DurableObjectId = env.MY_DURABLE_OBJECT.idFromName("foo");
const euId: DurableObjectId = env.MY_DURABLE_OBJECT.jurisdiction("eu").idFromName("foo");
console.assert(plainId.jurisdiction === undefined, "no jurisdiction set");
console.assert(euId.jurisdiction === "eu", "jurisdiction matches namespace");
plain_id = env.MY_DURABLE_OBJECT.idFromName("foo")
eu_id = env.MY_DURABLE_OBJECT.jurisdiction("eu").idFromName("foo")
assert plain_id.jurisdiction is None, "no jurisdiction set"
assert eu_id.jurisdiction == "eu", "jurisdiction matches namespace"
```

@ask-bonk
Copy link
Copy Markdown
Contributor

ask-bonk Bot commented Jun 2, 2026

Review posted on PR #31186.

Applied labels: changelog, documentation, product:durable-objects, fundamentals

Posted: 2 inline suggestions and 1 comment.

Issues flagged:

  • HIGH — Scope creep. The PR bundles unrelated Durable Objects jurisdiction documentation (a new changelog entry plus changes to id.mdx and data-location.mdx) with the billing sidebar changelog. These should move to a separate PR, or the PR title and description should be updated to cover both features.
  • MEDIUM — The jurisdiction examples in id.mdx only include JavaScript and Python tabs. The name section directly above includes TypeScript as well, so a suggestion was posted to add a matching TypeScript tab for consistency.
  • LOW — In the fundamentals changelog, "Usage based billing" should be hyphenated as "Usage-based billing" (compound modifier). Suggestion posted.

Pre-existing note: data-location.mdx line 119 has a typo ("find our more" → "find out more"), but it was unchanged in this PR so it was not flagged as a required fix.

github run

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 2, 2026

…roduct-sidebar.mdx

Co-authored-by: ask-bonk[bot] <249159057+ask-bonk[bot]@users.noreply.github.com>

Pay-as-you-go customers can now view billable usage and create [budget alerts](/changelog/post/2026-04-13-billable-usage-dashboard-and-budget-alerts/) directly from the product overview pages for [Workers & Pages](/workers/), [D1](/d1/), [R2](/r2/), [Workers KV](/kv/), [Queues](/queues/), [Vectorize](/vectorize/), [Durable Objects](/durable-objects/), and [Containers](/containers/). A new sidebar widget shows current-period spend and the billing cycle date range, alongside a button to create a budget alert.

The widget pulls from the same data as the [Billable Usage dashboard](/changelog/post/2026-04-13-billable-usage-dashboard-and-budget-alerts/) and aligns to your billing cycle (or the current day on Free plans), so the numbers match your invoice. Enterprise contract accounts are not supported.
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

I am pretty sure enterprise is planned, maybe this could say "not supported yet"?

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

updated!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

changelog Adds or updates changelog entries/pages. documentation Documentation edits fundamentals product:changelog product:durable-objects Durable Objects: https://developers.cloudflare.com/workers/learning/using-durable-objects/ size/m

Projects

None yet

Development

Successfully merging this pull request may close these issues.