Skip to content

[D1] Update docs to reflect current limitations (SPM-3384)#30007

Open
krys-cf wants to merge 1 commit intocloudflare:productionfrom
krys-cf:spm-3384-d1-update-limitations
Open

[D1] Update docs to reflect current limitations (SPM-3384)#30007
krys-cf wants to merge 1 commit intocloudflare:productionfrom
krys-cf:spm-3384-d1-update-limitations

Conversation

@krys-cf
Copy link
Copy Markdown
Contributor

@krys-cf krys-cf commented Apr 16, 2026

Summary

  • Removes misleading claims that D1 is "designed for horizontal scale out across multiple databases" and that users can "build applications with thousands of databases at no extra cost"
  • Replaces with accurate language about D1 capabilities and pricing
  • Adds an admonition on the D1 landing page guiding users to the right database product for their use case (D1, Durable Objects with SQLite, or Hyperdrive)

Changes

src/content/docs/d1/index.mdx (D1 landing page)

  • Replaced the scale-out paragraph with a factual description of D1's storage and pricing
  • Added a :::note[Choosing the right database product] admonition with guidance on D1 vs Durable Objects with SQLite vs Hyperdrive

src/content/partials/d1/faq-limits.mdx (Limits FAQ)

  • Replaced "horizontal scale out" and "thousands of databases at no extra cost" language with factual description of multi-database support and pricing

Context

  • Originated from community feedback on Discord regarding inaccurate D1 positioning

@github-actions github-actions bot added product:d1 D1: https://developers.cloudflare.com/d1/ size/s labels Apr 16, 2026
Remove misleading claims about D1 being designed for horizontal scale out
across multiple databases and building applications with thousands of
databases at no extra cost. Replace with accurate language about D1
capabilities and an admonition guiding users to the right database product
(D1, Durable Objects with SQLite, or Hyperdrive) for their use case.
@krys-cf krys-cf force-pushed the spm-3384-d1-update-limitations branch from cd0d3ca to b378e48 Compare April 16, 2026 20:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:d1 D1: https://developers.cloudflare.com/d1/ size/s

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants