Payload CMS Release: Release 1.0.35

TL;DR

Payload CMS v1.0.35 brings significant improvements to the rich text editor's link functionality, allowing users to link to internal documents and providing a better user experience. The update also fixes several bugs related to image handling, authentication, and rich text editing. This release enhances content management workflows by making it easier to create and manage internal links within your content.

Highlight of the Release

• Enhanced rich text editor with improved link functionality
• New ability to link to internal documents within rich text fields
• Fixed image handling to automatically add height/width when imageSizes not specified
• Improved UX for creating links when no text is selected
• Updated @faceless-ui/modal dependency to version 2.0.0-alpha.4

Migration Guide

Migration Notes

This release includes an update to @faceless-ui/modal to version 2.0.0-alpha.4, which may require attention if you've built custom components using this library.

If you have custom implementations that extend or modify the rich text editor's link functionality, you may need to update your code to accommodate the new internal document linking capabilities.

No database migrations or major breaking changes are included in this release, so upgrading should be straightforward for most users.

Upgrade Recommendations

This release is recommended for all Payload CMS users, especially those who make heavy use of the rich text editor and internal linking functionality.

To upgrade:

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

After upgrading, test your rich text fields to ensure that existing links continue to function as expected and to familiarize yourself with the new linking capabilities.

Bug Fixes

• Fixed issue #1059 related to the CMS functionality
• Added automatic height/width attributes to images when imageSizes is not specified, improving image rendering
• Corrected authentication strategy type definitions for better TypeScript support
• Fixed rich text link creation when no text is selected
• Resolved issues with link population logic to ensure accurate data
• Fixed various UX issues in the rich text editor

New Features

Enhanced Rich Text Link Functionality

The rich text editor now offers a significantly improved link experience:

• Internal Document Linking: You can now link directly to other documents within your Payload CMS instance, creating a more integrated content experience
• Improved Link UX: The link creation and editing interface has been redesigned for better usability
• No-Selection Link Handling: Fixed issues when trying to create links without text selection
• Better Data Seeding: Updated rich text data seeding to support new link functionality

These improvements make content creation more efficient and help create a more interconnected content structure within your Payload CMS projects.

Security Updates

No specific security fixes were mentioned in this release.

Performance Improvements

While not explicitly mentioned in the commit messages, the update to @faceless-ui/modal (now at v2.0.0-alpha.4) likely includes performance optimizations for modal rendering and interactions. The improved link handling in rich text fields should also result in a more responsive editing experience, particularly when working with content that contains many internal links.

Impact Summary

Payload CMS v1.0.35 focuses on enhancing the content editing experience, particularly through improvements to the rich text editor's link functionality. Content editors will benefit from a more intuitive linking interface and the ability to create internal links to other documents within the CMS.

The release also addresses several bugs, including issues with image handling, authentication type definitions, and link creation behavior. These fixes contribute to a more stable and reliable CMS experience.

The update to @faceless-ui/modal may impact custom implementations that rely on this library, so developers should review any custom code that extends modal functionality.

Overall, this is a quality-of-life improvement release that enhances content management workflows without introducing breaking changes, making it a recommended upgrade for all Payload CMS users.

Full Release Notes