Payload CMS Release: 2.32.3

TL;DR

Payload CMS v2.32.3 brings important bug fixes to the filtering system and upload functionality. The update resolves issues with filter state persistence when removing conditions and prevents browser crashes when handling large non-image file uploads.

Highlight of the Release

• Fixed filter state persistence when removing conditions in the WhereBuilder component
• Improved upload handling to prevent browser crashes with large non-image files
• Enhanced UI stability for filtering operations

Migration Guide

No migration steps are required for this update. Simply upgrade to version 2.32.3 to benefit from the bug fixes.

Upgrade Recommendations

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

1. Use filtering extensively in the admin UI
2. Work with file uploads, particularly non-image files
3. Have experienced browser performance issues when uploading large files

The update contains no breaking changes and provides important stability improvements.

Bug Fixes

WhereBuilder Filter State Persistence

Fixed an issue in the WhereBuilder component where removing a previous filter condition would cause remaining conditions to reset their operator and value. The problem was that the Condition components were keyed only by their index, causing React to incorrectly reuse component instances when the condition list changed. The fix updates the key for each Condition to be based on a combination of field name, operator, and indexes, ensuring components are correctly recreated when necessary.

Upload Preview Handling

Resolved an issue where the browser would attempt to read and preview all file types as images, causing crashes when uploading large non-image files. The fix ensures that only actual image files are processed for preview, significantly improving performance and stability when working with various file types.

New Features

This release doesn't introduce new features but focuses on fixing critical bugs in existing functionality.

Security Updates

No specific security fixes were included in this release.

Performance Improvements

The fix for upload handling provides a significant performance improvement by preventing the browser from attempting to read and render large non-image files as previews. This change helps avoid browser crashes and memory issues when users upload large documents, videos, or other non-image file types.

Impact Summary

Payload CMS v2.32.3 delivers important quality-of-life improvements for both content editors and developers. The fixes address two significant pain points: filter state persistence when building complex queries and browser performance when handling file uploads.

For content editors, the filtering experience is now more reliable, with conditions maintaining their state properly when modifying filters. This makes building and refining complex queries much more intuitive and less frustrating.

For developers and system administrators, the upload handling improvements prevent potential browser crashes and performance issues when users upload large non-image files, leading to a more stable application overall.

These changes, while focused on specific areas, contribute to a more robust and user-friendly CMS experience without introducing any breaking changes or requiring migration steps.

Full Release Notes