Payload CMS Release: Release 0.9.2

TL;DR

Payload CMS v0.9.2 brings important improvements to file uploads, including aspect ratio preservation during resizing, auto-sized uploads exposure, and the ability to completely disable local file storage. This release also includes UI improvements with group heading size reduction and fixes a bug with row admin type.

Highlight of the Release

• Added ability to maintain aspect ratio when resizing uploaded images
• Exposed auto-sized uploads on the payload request object
• Added option to completely disable local file storage
• Improved UI by reducing group heading size from h2 to h3
• Fixed bug with row admin type

Migration Guide

No migration is required for this release. All changes are backward compatible.

If you're using image resizing functionality and want to take advantage of the new aspect ratio preservation feature, you can update your image resize configurations to set either width or height to null where appropriate.

Upgrade Recommendations

This is a minor release with new features and bug fixes. It's recommended to upgrade to take advantage of the improved image handling capabilities and UI enhancements.

The upgrade should be straightforward with no breaking changes:

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

Bug Fixes

Admin UI Fixes

• Row Admin Type: Fixed an issue with the row admin type that was causing display problems in the admin interface.

New Features

Image Upload Enhancements

• Aspect Ratio Preservation: When resizing uploaded images, you can now maintain the original aspect ratio by setting either width or height to null. This ensures images aren't distorted during the resize process.

• Auto-sized Uploads Exposure: Auto-sized uploads are now exposed on the payload request object via req.payloadUploadSizes, making it easier to access different image sizes programmatically.

Storage Options

• Disable Local File Storage: You can now completely disable local file storage for uploads. This is particularly useful when implementing custom storage solutions like S3, Google Cloud Storage, or other providers.

UI Improvements

• Group Heading Size Reduction: Group headings have been reduced from h2 to h3, creating a more consistent and hierarchical UI experience.

Security Updates

No security fixes were mentioned in this release.

Performance Improvements

No specific performance improvements were mentioned in this release.

Impact Summary

This release focuses on improving the developer and content editor experience with enhanced file upload capabilities. The ability to maintain aspect ratio during image resizing is particularly valuable for maintaining visual consistency across your site or application.

The option to disable local file storage completely gives developers more flexibility in implementing custom storage solutions, which is essential for production deployments that rely on cloud storage providers.

The UI improvement with group heading size reduction creates a more consistent visual hierarchy in the admin interface, enhancing the overall user experience for content editors.

These changes, while not major in scope, provide meaningful quality-of-life improvements that make Payload CMS more flexible and user-friendly.

Full Release Notes