Payload CMS Release: Release 1.6.16

TL;DR

PayloadCMS v1.6.16 Release

This release focuses on bug fixes and quality-of-life improvements for PayloadCMS. Key highlights include deep query support, drag-and-drop columns, Hungarian translations, and fixes for image handling, form state management, and global drafts. The update addresses several critical issues that improve stability and user experience without introducing breaking changes.

Highlight of the Release

• Deep query support allowing queries on N number of levels deep
• Drag-and-drop columns for improved content organization
• Hungarian language translations added
• Fixed animated image resizing
• Improved globals publishing with drafts support
• Better form state management with async default values

Migration Guide

This release does not require any specific migration steps. It's a drop-in replacement that fixes bugs and adds new features without breaking existing functionality.

To upgrade:

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

After upgrading, test your application to ensure all functionality works as expected, particularly if you're using:

• Deep nested queries
• Animated images
• Global drafts
• Relationship fields with clearing functionality

Upgrade Recommendations

We recommend all users upgrade to v1.6.16 as it contains important bug fixes and quality-of-life improvements without introducing breaking changes. This release is particularly valuable for:

• Users working with complex data structures and deep queries
• Content editors who would benefit from drag-and-drop column functionality
• Teams working with animated images
• Hungarian-speaking users
• Anyone experiencing issues with globals publishing after drafts

The upgrade process is straightforward and should not disrupt existing implementations.

Bug Fixes

Query and Data Management

• Fixed issue #2150 allowing queries on N number of levels deep
• Fixed issue #2179 where async default values were incorrectly resetting form state
• Fixed issue with empty objects not being retained in the database
• Fixed relationship field clearing functionality #2188
• Ensured sorting on drafts works consistently in all cases

Admin UI and User Experience

• Fixed rich text editor upload drawer rendering issue #2178
• Fixed version comparison view errors on old select values #2163
• Improved field validation by skipping validation on submit when skipValidation is set to true

Media Handling

• Fixed issue #2181 with animated image resizing

Authentication and API

• Fixed req.payload setting on forgotPassword in local API #2194
• Fixed globals publishing after draft creation #2193

New Features

Drag-and-Drop Columns

• Added support for drag-and-drop columns, allowing users to easily reorganize content in the admin UI
• Improves content management workflow and provides more flexibility in organizing complex data structures

Hungarian Translations

• Added complete Hungarian language support to the admin interface
• Expands accessibility for Hungarian-speaking users
• Continues PayloadCMS's commitment to internationalization

Security Updates

No specific security fixes were included in this release.

Performance Improvements

• Split getLatestEntityVersion function to separate globals and collections for more efficient processing
• Improved form state management to prevent unnecessary re-renders with async default values
• Enhanced query processing for deep nested queries, providing better performance for complex data structures

Impact Summary

PayloadCMS v1.6.16 is a maintenance release that focuses on bug fixes and quality-of-life improvements. The most significant impact comes from the new drag-and-drop columns feature, which enhances content organization capabilities for editors.

The fixes for deep querying (allowing N-level deep queries) and animated image handling resolve important limitations that affected some users. Hungarian language support expands the CMS's accessibility to new users.

Form state management improvements, particularly with async default values and relationship fields, create a more stable editing experience. The fixes for globals publishing with drafts ensure content workflows function as expected.

Overall, this release improves stability and user experience without introducing breaking changes, making it a recommended upgrade for all PayloadCMS users.

Full Release Notes