What's new?
We've relaunched the Paddle developer docs as an AI-native experience, built for both the humans reading the docs in a browser and the AI agents working alongside them in editors, chat clients, and the terminal.
The new docs score 100/100 on the afdocs spec and 75/100 on Cloudflare's isitagentready.com website, independent benchmarks for how well documentation works with AI tooling.
How it works
AI agents are fast becoming the main way people build software, and increasingly how we interact with documentation. We've built the new docs to be a first-class experience for agents and humans alike, with a focus on clarity, accuracy, and ease of use.
New docs features
- Markdown routes
Every page in the docs is now available as Markdown. Append.mdto any doc URL to fetch the raw source, or click Copy for LLM on a page to copy the Markdown directly. - Automatic Markdown negotiation
When AI agents browse the docs, we serve them the Markdown version automatically to preserve tokens. A plain-text index of every page lives at/llms.txtas before. - Quick options to open in AI tools
Every page has an Open in… action that takes the current page straight into ChatGPT, Claude, or another AI assistant, with the Markdown source prefilled as context. - AI-generated summaries
Most pages now include a collapsible AI summary at the top, giving you a quick orientation before you dive in. If you're not interested in the summary, you can collapse it and your browser remembers your preference across pages. - Quick question prompts
We've extended our Kapa.ai-powered docs assistant with quick question prompts throughout the docs. - Copy-as-prompt cards
For a number of guides, we've added one-click prompts that let you copy the page context and a shaped prompt that you can paste directly into your AI assistant.
Token efficiency
Behind the scenes, we moved from Next.js to Astro and spent a significant amount of time optimizing the core docs experience for speed and token efficiency. Across guides we tested, we saw a ~66% reduction in tokens consumed for the same content.
Also included
Our docs are still written by humans, with human readers in mind. Alongside the AI features, there are a bunch of improvements for human readers of our docs, too:
- Dark mode
Toggle between light and dark mode from the docs header. - Improved search
A massively improved, more accurate search experience across the docs. - Improved mobile experience
Navigation, code blocks, and tables all work better on small screens. - New content
A new getting started section, with a focus on the most common tasks and workflows, and an expanded SDKs and tools section, with links to the official SDKs, sandbox, AI and MCP servers, specs, starter kits, and community libraries. - New API reference
An entirely rebuilt API reference section, with validation, min/max limits, default values, and more surfaced in a clean layout. - Enhanced components across the docs
Quickly copy install commands, sort data in tables, and compare features side-by-side with new components.
Every layout and component has been rebuilt to be more consistent and more readable, and make browsing our docs better.
Next steps
The new docs are available now at developer.paddle.com (you're here!). There's nothing you need to do to start using them.
There's no change to the Paddle docs MCP server, which is trained on our developer docs.
There are no changes to the Paddle API or Paddle.js as a result of this update. It's a non-breaking change and doesn't impact existing integrations.