v4.0.0-beta.0 (2026-10-09)
More details to come next week
To try this out: npx create-payload-app@beta
🚀 Features
- Admin UI redesign
- TanStack support
- Content branching
- Dashboard components
- Accessibility
- Hierarchies
- Tags
- Grid View
- Improved File Uploads UI
- File upload versions
- Rewritten MCP
- Upgrade scripts (codemods)
- Foundational improvements
📚 Documentation
- Beta version documentation can be found at https://payloadcms.com/docs/beta/getting-started/what-is-payload
⚠️ BREAKING CHANGES
For a full list of breaking changes from v3 to v4 visit https://payloadcms.com/docs/beta/migration-guide/v4
To run the codemod that will perform these updates on a v3 app for you:
# Agent-assisted
npx @payloadcms/codemod@beta upgrade
# Pure codemod updates
npx @payloadcms/codemod@beta