Payload CMS Release: Release 1.1.22

TL;DR

Payload CMS v1.1.22 is a maintenance release focused on bug fixes and documentation improvements. It addresses several UI issues, fixes problems with nested arrays and blocks, improves GraphQL query resolvers, and enhances relationship field functionality. This release also exports the useEditDepth hook for developers and updates documentation for better accuracy.

Highlight of the Release

• Fixed issue with nested arrays and blocks that prevented content from being saved
• Server errors now properly display in the UI for better error handling
• Exported useEditDepth hook for developers to use in custom components
• Fixed GraphQL Access query resolver to return correct data
• Improved search functionality with nested fields through listSearchableFields fix

Migration Guide

No migration steps are required for this release. This is a maintenance release with bug fixes and documentation improvements that should not break existing functionality.

Upgrade Recommendations

This release is recommended for all users, especially those experiencing issues with:

• Saving content with nested arrays and blocks
• Server errors not displaying in the UI
• Relationship field scrolling in certain browsers
• GraphQL Access query resolver returning incorrect data
• Custom global components within schema validation

Since this is a patch release (v1.1.21 → v1.1.22) with no breaking changes, upgrading should be straightforward and low-risk.

Bug Fixes

UI and Interaction Fixes

• Fixed an issue where errors returned from the server weren't properly displayed in the UI (#1353)
• Fixed a critical bug where nested arrays and blocks sometimes prevented content from being saved (#1357)
• Fixed relationship field onMenuScrollToBottom event not working in some browsers (#1360)
• Eliminated duplicative logout in the admin UI (#1309)

Functionality Fixes

• Fixed listSearchableFields to work correctly when the indicated fields are nested within other fields (#1358)
• Fixed GraphQL Access query resolver to return the correct data (#1339)
• Fixed an issue that prevented custom global components from working within schema validation (#1367)

New Features

The useEditDepth hook has been exported, allowing developers to access this functionality in their custom components. This hook helps track the nesting depth when editing complex data structures, which is particularly useful when building custom field components that need to be aware of their position in the document hierarchy.

Security Updates

No security fixes were explicitly mentioned in this release.

Performance Improvements

No specific performance improvements were mentioned in this release. The focus was primarily on bug fixes and documentation updates.

Impact Summary

Payload CMS v1.1.22 is a quality-of-life improvement release that addresses several important bugs affecting the admin UI and developer experience. The fixes for nested arrays/blocks and server error display are particularly impactful as they resolve issues that could prevent content from being saved properly. The export of the useEditDepth hook provides developers with more tools for custom component development. Documentation improvements, including field hook example configuration and corrections regarding local API overrideAccess, help ensure developers have accurate information. Overall, this release enhances stability and usability without introducing breaking changes.

Full Release Notes