Payload CMS v4.0.0-beta.4 Is Here
Payload CMS released v4.0.0-beta.4 on October 22, 2026, continuing the rapid march toward a stable 4.0 release. This beta brings a comprehensive accessibility audit pass, a significant TanStack Start performance win, important bug fixes across MongoDB and Drizzle adapters, and a breaking Node.js version bump that developers need to be aware of before upgrading.
New Features
- Accessibility contrast improvements: A full pass on contrast ratios across the admin UI ensures the interface meets modern accessibility standards.
- Smarter Activity Widget: The dashboard widget now automatically opens to recently viewed items when nothing is pinned, improving day-to-day navigation for content editors.
Performance
- TanStack Start – up to 3x faster initial loads in dev: Four targeted optimizations dramatically cut initial API and admin load times during development when using the TanStack Start adapter. Note: this is a breaking change for TanStack Start users.
- Lexical rich text: Field sub-fields are now located without scanning the entire client field schema map, reducing overhead in rich text-heavy projects.
Bug Fixes
- Security: Bumped undici to 7.30.1 to address upstream vulnerabilities.
- Node.js minimum bumped to 24.22.1 – a breaking change; ensure your environment is updated before upgrading.
- File transformer streams: Unused streams are now properly cancelled, preventing memory leaks in upload-heavy workflows.
- Global version restoration now aligns with collection behavior for consistency.
- Field access: Document ID is now correctly passed to field access control functions.
- MongoDB adapter: Fixed limit 0 support in joins across multiple collections.
- Drizzle adapter: Localized filters in polymorphic joins now work correctly.
- Lexical rich text: Link drawer form state is now preserved correctly.
- UI – Draft restoration: Published content is now preserved when restoring drafts.
- UI – Column toggles: Fixed visible flickering when toggling columns in the TanStack dev server.
- UI – Activity widget: Tab focus outline clipping resolved; dashboard widget is now server-rendered.
Breaking Changes Summary
- Node.js minimum is now 24.22.1 – Node.js 22 and earlier are no longer supported.
- Global version restoration behavior changed to align with collections.
- TanStack Start dev server refactor – speeds up initial loads but requires adapter updates.
How to Upgrade
npm install payload@4.0.0-beta.4
Review the official v3 to v4 migration guide before upgrading, especially if you are using TanStack Start or rely on global versioning.
Key Takeaway: Beta.4 is a polish-and-stability release focused on accessibility, performance, and correctness. The Node.js 24.22.1 minimum is the most impactful breaking change for teams running older infrastructure.
Hashtags: #PayloadCMS #NextJS #WebDevelopment #CMS #OpenSource #TypeScript #TanStack #Accessibility
Resources: