Payload CMS Release: 3.0.0-beta.95

TL;DR

PayloadCMS v3.0.0-beta.95 brings important bug fixes for localized fields in databases, rich text relationship features, navigation issues, and upload depth handling. This release focuses on improving stability and fixing critical issues in the beta version, particularly around database handling of complex field types and UI components.

Highlight of the Release

• Fixed database handling of localized blocks and arrays containing relationships, other arrays, or blocks
• Fixed enabledCollections and disabledCollections props in RelationshipFeature for rich text editor
• Resolved issue with active navigation items in child routes
• Fixed depth not being respected by upload hasMany relationships
• Improved HTML text escaping in rich text lexical converter

Migration Guide

No migration steps are required for this beta release. The changes are primarily bug fixes that should work automatically when upgrading from v3.0.0-beta.94 to v3.0.0-beta.95.

If you're using localized fields with complex structures (arrays, blocks, relationships) in Postgres or SQLite databases, you may notice improved behavior with localization after upgrading, but no manual migration steps are needed.

Upgrade Recommendations

This upgrade is recommended for all users of PayloadCMS v3.0.0-beta.94, especially if you:

• Use localized fields with complex structures (arrays, blocks, relationships)
• Use the rich text editor with relationship features
• Have applications with nested routes and navigation
• Work with upload fields and hasMany relationships

The release contains important bug fixes that improve stability and functionality without introducing breaking changes. Upgrade by updating your package.json and running:

npm install [email protected]
# or
yarn add [email protected]
# or
pnpm add [email protected]

Bug Fixes

Database Fixes

• Localized Fields in Postgres/SQLite: Fixed issues with localized blocks or arrays containing other arrays, blocks, or relationship fields not properly storing locales in the database. This addresses step 6 identified in issue #7805.

Rich Text Editor Fixes

• Relationship Feature Props: Fixed enabledCollections and disabledCollections properties in the RelationshipFeature not being sent to the client, which prevented them from working as expected. These properties are now correctly sent via the clientFeatureProps property. Fixes issue #7379.
• HTML Converter: Ensured text is properly escaped in the HTML converter for the Lexical rich text editor.

UI Fixes

• Navigation: Fixed active navigation item being set incorrectly in child routes, improving the user experience when navigating through the admin panel.
• Admin Dependencies: Fixed issue where admin.dependencies components were not being added to the client configuration.

Upload Fixes

• Depth Handling: Fixed issue where depth parameter was not being respected by upload hasMany relationships.

Package Management

• Moved ui and translations from peerDependencies to dependencies for several packages, eliminating the need for users to install these directly unless making customizations.
• Updated turborepo npm scripts to accommodate a breaking change from vercel/turborepo#8137.

New Features

No significant new features were added in this release as it primarily focuses on bug fixes and stability improvements.

Security Updates

No specific security fixes were included in this release.

Performance Improvements

This release doesn't include specific performance improvements, but the bug fixes for database handling of localized fields and relationship features should result in more reliable and consistent performance, especially for applications with complex data structures and multi-language content.

Impact Summary

This release focuses on bug fixes and stability improvements for PayloadCMS beta users. The most significant impact is on database handling of localized fields with complex structures, which now properly store locale information. This is particularly important for multi-language applications using Postgres or SQLite databases.

The fixes for relationship features in the rich text editor improve content editing capabilities, while navigation and UI fixes enhance the admin experience. The package management changes simplify dependency handling for users.

Overall, this release represents an important step toward stabilizing the v3.0.0 beta series, addressing several critical issues that affected database integrity, UI functionality, and content editing workflows.

Full Release Notes