Payload CMS Release: Release 1.8.6

TL;DR

Payload CMS v1.8.6 brings important bug fixes for relationship fields, bulk operations, global collections, and field typing. This maintenance release addresses several critical issues affecting data operations, UI interactions, and TypeScript typing, improving overall stability and developer experience without introducing breaking changes.

Highlight of the Release

• Fixed relationship field querying to properly handle all collections
• Resolved bulk operations issues with localized content
• Improved handling of relationships in global collection updates
• Fixed TypeScript typing for optional arrays with required fields
• Enhanced drag-and-drop functionality with better activation constraints

Migration Guide

No migration is required for this release. This is a patch release that fixes bugs and improves existing functionality without introducing breaking changes.

To upgrade, simply update your Payload CMS dependency:

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

Upgrade Recommendations

This release is recommended for all users, especially those who:

• Use relationship fields across multiple collections
• Work with localized content and bulk operations
• Use global collections with relationship fields
• Have complex nested field structures with rows and collapsible fields
• Rely on TypeScript typing for optional arrays with required fields

Since this is a patch release with no breaking changes, upgrading should be straightforward and low-risk.

Bug Fixes

Relationship Field Improvements

• Fixed relationship fields not properly querying all collections (#2771, #2774)
• Resolved issue with flattening relationships in update operations for globals (#2766, #2776)

Bulk Operations and Localization

• Fixed bulk operations missing locales in admin requests (#2767, #2778)
• Improved handling of localized content in administrative operations

Field Handling and UI

• Fixed recursiveNestedPaths not properly merging existing fields when hoisting row/collapsible fields (#2769)
• Corrected read-only behavior for Auth fields (#2781)
• Adjusted activation constraint of draggable nodes for better UI interaction (#2773)

TypeScript and Schema Improvements

• Fixed improper typing of optional arrays with required fields
• Added test for entityToJSONSchema handling of optional arrays with required fields
• Indexed sortable fields in global versions fields (#2711, #2775)

New Features

No new features were introduced in this release. This is primarily a bug fix and maintenance release focused on improving stability and fixing existing functionality.

Security Updates

No specific security fixes were included in this release.

Performance Improvements

Indexing Improvements

• Added indexing for sortable fields in global versions fields (#2711), which should improve query performance for sorted global collections

UI Performance

• Improved drag-and-drop functionality with better activation constraints, resulting in smoother user interactions when reordering items

Impact Summary

Payload CMS v1.8.6 is a maintenance release that addresses several important bugs affecting relationship fields, bulk operations, global collections, and TypeScript typing. The fixes improve data handling for relationships across collections, properly manage localized content in bulk operations, and correct field behavior in nested structures.

For developers, the TypeScript typing improvements ensure more accurate type checking for optional arrays with required fields. Content editors will benefit from fixed bulk operations with localized content and improved drag-and-drop functionality. System administrators will see better performance from improved indexing for sortable fields in global versions.

This release contains no breaking changes and is recommended for all users to ensure proper functionality of relationship fields, bulk operations, and global collection updates.

Full Release Notes