Payload CMS Release: Release v1.2.1

TL;DR

PayloadCMS v1.2.1 brings important bug fixes and improvements to the internationalization (i18n) system, draft functionality, and UI components. This maintenance release addresses several critical issues with drafts, versions, and select fields while enhancing the i18n capabilities throughout the admin panel. The update improves the developer experience with better TypeScript exports and fixes UI interaction problems.

Highlight of the Release

• Fixed critical issues with draft operations ensuring they save properly as drafts
• Improved internationalization (i18n) throughout the admin panel, especially in version comparison views
• Enhanced TypeScript support with proper field type exports
• Fixed UI issues with textarea components and select fields
• Resolved problems with global drafts and patching functionality

Migration Guide

No migration steps are required for this release. This is a maintenance release that focuses on bug fixes and minor enhancements, so upgrading from v1.2.0 to v1.2.1 should be straightforward without any breaking changes.

Upgrade Recommendations

This is a recommended upgrade for all users of PayloadCMS v1.2.0, especially for those who:

• Use the draft functionality
• Work with internationalized (i18n) content
• Use select fields with the isClearable option
• Rely on version comparison features

The release contains important fixes for draft operations, i18n functionality, and UI components that improve the overall stability and user experience of the CMS. There are no breaking changes, making this a safe upgrade.

Bug Fixes

Draft and Version Fixes

• Fixed issue where draft operations weren't saving as drafts (#1415)
• Resolved problem with patching global drafts (#1415)
• Fixed flattening of locales before versioning published documents (#1415)
• Fixed broken version count functionality in i18n context (#1465)
• Improved version tests for better reliability

UI and Interaction Improvements

• Increased textarea click area for better usability
• Fixed styles to allow error backgrounds to properly fill textarea components
• Dynamically set stepnav from default edit view
• Fixed sanitization of select values on the server, allowing isClearable selects to be cleared without error
• Resolved issue with rendering localized select values

Other Fixes

• Fixed invalid query string in user account requests (#1478)
• Removed incorrectly implemented import/export option type (#1441)

New Features

Enhanced Internationalization Support

• Added i18n support to option labels in version comparison views
• Improved translation of version comparison field labels
• Better handling of localized select values

Improved TypeScript Support

• Properly exported field types for better TypeScript integration
• Fixed incorrect import/export option types

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 feature enhancements related to internationalization, drafts, and UI components.

Impact Summary

PayloadCMS v1.2.1 is a maintenance release that addresses several important issues and adds minor enhancements to improve the overall stability and user experience of the CMS.

The most significant impact is on the draft functionality, which now correctly saves as drafts and properly handles global drafts. This fixes critical issues that could have led to unexpected behavior when working with draft content.

Internationalization (i18n) support has been enhanced throughout the admin panel, particularly in version comparison views, making the CMS more accessible for multilingual projects.

UI improvements include better textarea click areas, fixed select field clearing, and proper error styling, all of which contribute to a more polished and intuitive user experience.

For developers, the TypeScript support has been improved with proper field type exports, making it easier to work with PayloadCMS in TypeScript projects.

Overall, this release brings important stability improvements without introducing breaking changes, making it a recommended upgrade for all users.

Full Release Notes