Payload CMS Release: Release 1.1.23

TL;DR

Payload CMS v1.1.23 brings performance improvements to field rendering and fixes an authentication issue with static assets. This release focuses on enhancing the developer experience with better field performance and ensuring proper authentication depth for collections when retrieving static assets.

Highlight of the Release

• Fixed authentication depth issues when retrieving static assets
• Optimized field performance in the admin UI by improving the useField hook
• Better overall admin panel responsiveness due to field rendering optimizations

Migration Guide

No migration steps are required for this release. The improvements to field performance and authentication depth handling are implemented in a way that maintains backward compatibility with existing Payload applications.

Users can simply update their Payload dependency to v1.1.23 to benefit from these improvements.

Upgrade Recommendations

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

1. Use authentication with depth controls on collections
2. Serve static assets through Payload
3. Have forms with many fields or complex field configurations in the admin UI

The upgrade process should be straightforward with no breaking changes:

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

Bug Fixes

Authentication Depth Fix for Static Assets

Fixed an issue (#1361) where collection authentication depth was not properly applied when retrieving static assets. This ensures that access control rules are consistently enforced across all types of content, including static assets.

Previously, there were scenarios where the authentication depth configuration for collections wasn't being properly respected during static asset retrieval, potentially leading to inconsistent authorization behavior.

New Features

Field Performance Optimization

The useField hook has been optimized to store internal values more efficiently, resulting in improved field rendering performance throughout the admin UI. This change reduces unnecessary re-renders and improves the overall responsiveness of forms in the admin panel.

This optimization is particularly beneficial for forms with many fields or complex field configurations, as it reduces the computational overhead associated with field state management.

Security Updates

No specific security fixes were included in this release. However, the fix for collection authentication depth when retrieving static assets (#1361) does improve the consistency of access control enforcement, which indirectly enhances the security posture of Payload installations.

Performance Improvements

Improved Field Rendering

The optimization of the useField hook provides a notable performance improvement for field rendering in the admin UI. By storing internal values more efficiently within the hook, the system reduces unnecessary re-renders and state updates.

This change improves the responsiveness of forms, especially in cases with:

• Forms containing many fields
• Complex nested field structures
• Conditional fields that depend on other field values
• Real-time validation scenarios

Impact Summary

Payload CMS v1.1.23 delivers targeted improvements to field performance and authentication handling. The field rendering optimization through the enhanced useField hook provides a smoother admin experience, particularly noticeable in complex forms. Meanwhile, the fix for collection authentication depth ensures consistent access control when retrieving static assets.

These changes, while focused in scope, address important aspects of the developer and content editor experience. The performance improvements contribute to a more responsive admin interface, while the authentication fix ensures that access control rules are properly enforced across all content types.

No breaking changes are introduced in this release, making it a safe and recommended upgrade for all Payload users.

Full Release Notes