Payload CMS Release: Release v2.0.6

TL;DR

PayloadCMS v2.0.6 brings important bug fixes for document management, UI improvements, and draft handling. This maintenance release addresses several issues with the admin interface, including sidebar overflow, field permissions, and draft duplication. It also includes updates to rich text editor packages and database adapters.

Highlight of the Release

• Fixed draft duplication functionality
• Resolved document sidebar vertical overflow issues
• Improved login form UI and field spacing
• Fixed sidebar field permissions
• Updated rich text editor packages with bug fixes
• Better separation of server/client exports

Migration Guide

No breaking changes were introduced in this release, so no migration is required. This is a maintenance release focused on bug fixes and improvements.

If you're using the rich text editor packages, note that peer dependencies have been added to these packages, which may affect your installation if you're not using compatible versions.

Upgrade Recommendations

This release contains important bug fixes for document management, UI improvements, and updates to rich text editor packages. It's recommended for all users to upgrade, especially if you're experiencing issues with draft duplication, sidebar overflow, or field permissions.

To upgrade:

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

Note that pnpm is no longer required in the engines field, giving you more flexibility in package manager choice.

Bug Fixes

UI and Document Management

• Fixed an issue that prevented drafts from being duplicated
• Resolved document sidebar vertical overflow problems for better usability
• Fixed login form clearing out unexpectedly and improved field spacing
• Corrected sidebar field permissions to properly respect access controls
• Fixed preview button conditions for more reliable content previewing

Rich Text Editor

• Fixed issues with nested blocks in the Lexical rich text editor where they had incorrect initial data (e.g., missing rows property)
• Fixed population functionality for deeply nested content in the Lexical editor
• Improved compatibility between rich text editors

New Features

This release primarily focuses on bug fixes and improvements rather than introducing new features. However, the rich text Lexical editor package did receive a new SlateToLexical migration feature, which helps users migrate from the Slate rich text editor to the newer Lexical editor.

Security Updates

No specific security fixes were mentioned in this release.

Performance Improvements

• Improved code organization with better separation of server and client exports, which can lead to more optimized builds
• Only imports drizzle-kit when it will be used, reducing unnecessary dependencies in memory
• De-duplicated array/block data from form state to reduce redundancy
• Cleaned up and optimized admin E2E tests for better development performance

Impact Summary

PayloadCMS v2.0.6 is a maintenance release that addresses several important usability issues in the admin interface. Content editors will benefit from fixes to draft duplication, sidebar overflow, and preview functionality. Developers will appreciate the improved code organization with better separation of server/client exports and updates to rich text editor packages.

The removal of the pnpm engine requirement provides more flexibility in package management. The updates to rich text editor packages (Lexical and Slate) and the PostgreSQL database adapter improve compatibility and reliability.

This release contains no breaking changes, making it a safe upgrade for all users. The bug fixes and improvements enhance the overall stability and user experience of PayloadCMS.

Full Release Notes