Payload CMS Release: 2.19.2

Tag Name: v2.19.2

Release Date: 6/6/2024

Payload CMS LogoPayload CMS

Payload CMS is a modern, self-hosted headless content management system built with TypeScript, Node.js, and MongoDB. It's designed specifically for developers who want full control over their content management system while maintaining a powerful admin interface for content editors.

TL;DR

PayloadCMS v2.19.2 delivers important bug fixes for image handling, UI column selection, and GraphQL draft functionality. This maintenance release addresses issues with animated image resizing, column selection persistence, and GraphQL global queries, improving overall stability and user experience.

Highlight of the Release

    • Fixed issues with resizing animated images (GIFs)
    • Resolved a bug where disabled list columns would reappear after toggling other columns
    • Fixed GraphQL draft argument cascading when querying globals
    • Added troubleshooting documentation for Content Security Policy with live preview

Migration Guide

No migration steps are required for this release. This is a patch release that can be safely upgraded to without breaking changes.

Upgrade Recommendations

This is a recommended upgrade for all PayloadCMS users, especially those who:

  1. Work with animated images (GIFs)
  2. Use column customization in the admin interface
  3. Query globals with GraphQL while using draft functionality
  4. Use the live preview feature and have encountered CSP-related issues

The release contains only bug fixes and documentation improvements with no breaking changes, making it a safe upgrade for all production environments.

Bug Fixes

Image Handling

  • Fixed issues with resizing animated images (GIFs and other animated formats), resolving longstanding issues #2181 and #6146

Admin UI

  • Fixed a bug where fields with admin.disableListColumn set to true would incorrectly reappear in the column selector after toggling other fields
  • Ensured that disabled list columns remain consistently hidden under all circumstances

GraphQL

  • Fixed an issue where the draft argument wasn't properly cascading when querying globals with GraphQL, ensuring consistent behavior when working with draft content

New Features

No new features were introduced in this release. This is a maintenance release focused on bug fixes and documentation improvements.

Security Updates

No security fixes were included in this release.

Performance Improvements

No specific performance improvements were highlighted in this release. The focus was on bug fixes and documentation enhancements.

Impact Summary

PayloadCMS v2.19.2 is a maintenance release that addresses several important bugs affecting image handling, admin UI behavior, and GraphQL functionality.

The fix for animated image resizing resolves longstanding issues that affected users working with GIFs and other animated formats. The admin UI improvements ensure more consistent behavior when configuring list columns, preventing disabled columns from unexpectedly reappearing. For developers using GraphQL, the fix for draft argument cascading in global queries ensures more reliable data fetching.

Additionally, the documentation improvements around Content Security Policy troubleshooting will help developers implement live preview functionality more effectively.

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

Full Release Notes

Statistics:

File Changed17
Line Additions216
Line Deletions29
Line Changes245
Total Commits6

User Affected:

  • Can now properly resize animated images without issues
  • Will experience more reliable GraphQL queries when working with draft globals
  • Will find documentation on troubleshooting Content Security Policy (CSP) issues with live preview

Contributors:

denolfePatrikKozakJarrodMFleschjacobsfletch