v4.0.0-beta.0

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