Payload CMS Release: 3.19.0

TL;DR

Payload CMS v3.19.0 introduces significant UI enhancements and bug fixes. Key features include bulk editing for uploads and improved selection capabilities for rich text blocks. The release also addresses numerous issues with MongoDB queries, multi-tenant plugin functionality, and REST API behavior. Documentation has been reorganized for better discoverability, and several template improvements have been made.

Highlight of the Release

• Bulk editing capabilities for uploads allow editing multiple files simultaneously
• Rich text blocks and decorator nodes are now selectable with centralized selection and deletion logic
• Fixed issues with MongoDB queries for polymorphic relationships and localized arrays
• Improved multi-tenant plugin with better error handling and navigation
• Reorganized documentation for better discoverability of field, collection, and global configurations

Migration Guide

Deprecations to Note

1. The description property on tabs configuration is now deprecated in favor of admin.description, though both are still supported for backward compatibility.

2. The public export of headersWithCors has been deprecated as CORS response headers are now applied automatically without requiring explicit use of this function.

For Multi-tenant Plugin Users

If you're using the multi-tenant plugin, this release includes several important fixes. When upgrading, be aware that tenant selection behavior has been improved when navigating between documents. The page will now refresh the cookie when navigating out of a document to ensure the tenant is set correctly.

Upgrade Recommendations

This release contains significant improvements to the UI, rich text editor, and fixes for several critical bugs. It's recommended for all users to upgrade to v3.19.0, especially if you:

1. Work with uploads and would benefit from bulk editing capabilities
2. Use the rich text editor extensively
3. Have experienced issues with MongoDB queries, particularly with polymorphic relationships or localized arrays
4. Use the multi-tenant plugin
5. Have custom upload components in Next.js admin panels

The upgrade should be straightforward with no breaking changes reported. As always, test thoroughly in a development environment before deploying to production.

Bug Fixes

MongoDB and Query Fixes

• Fixed handling of nullable minDistance and maxDistance parameters in near queries
• Resolved issues with joining relationship fields inside localized arrays
• Fixed REST API behavior when using ?locale=* to properly return full localized data
• Corrected querying of polymorphic relationships with the all operator
• Fixed v2-v3 migration versioning for collections and globals without relationship fields

UI and Component Fixes

• Fixed incorrect table action menu placement in the rich text editor
• Resolved issues with the thumbnail component crashing when images don't exist
• Fixed admin descriptions not being respected on tabs and padding issues with tab descriptions
• Improved URL regex matchers for more reliable autolinking in the rich text editor
• Fixed browser validation errors when visiting the account page

Plugin Fixes

• Multi-tenant Plugin: Fixed issues with tenant selection when navigating out of documents, corrected user type handling, and prevented errors when no user exists
• Nested Docs Plugin: Fixed limitation that prevented updating more than 10 child documents
• Next.js: Fixed admin panel UI not rendering custom upload components and ensured Next.js rewrites are respected for REST API

New Features

Bulk Editing for Uploads

Content editors can now select and edit multiple uploads simultaneously with the new "Edit Many" option. This feature allows selecting specific fields to update across all selected uploads in a single operation, significantly improving workflow efficiency when managing multiple files.

Rich Text Selection Improvements

The Lexical rich text editor now supports selecting blocks (previously only inline blocks were selectable) and any decorator nodes. The selection and deletion logic has been centralized, making the code more maintainable and performant by using event delegation instead of individual listeners for each decorator node. This implementation includes intelligent heuristics to exclude scenarios where node selection would be undesirable.

Security Updates

No significant security fixes were included in this release.

Performance Improvements

Rich Text Editor Performance

The rich text editor now uses event delegation for handling selection and deletion of decorator nodes, resulting in more performant code. Instead of attaching individual listeners to each decorator node, there is now a single listener that handles all nodes, reducing the overhead of event handling.

MongoDB Query Optimizations

Several fixes to MongoDB queries improve the performance and reliability of database operations, particularly for complex queries involving polymorphic relationships and localized arrays.

Impact Summary

Payload CMS v3.19.0 delivers substantial improvements to content editing workflows with the introduction of bulk editing for uploads and enhanced rich text selection capabilities. These features significantly streamline content management tasks, especially when working with multiple files or complex rich text content.

The release also addresses numerous bugs across the platform, particularly in MongoDB query handling, multi-tenant plugin functionality, and Next.js integration. These fixes improve the overall stability and reliability of the CMS.

Documentation has been reorganized to improve discoverability, with field customization, collection, and global configuration docs moved to more intuitive locations. New examples for typed custom field components have been added to help developers implement custom UI elements more easily.

Overall, this release enhances both the developer and content editor experience with thoughtful improvements to workflows, better documentation, and increased system stability.

Full Release Notes