Home

>

Tools

>

Payload CMS

>

Releases

>

Release 1.4.2

Payload CMS Release: Release 1.4.2

Tag Name: v1.4.2

Release Date: 1/3/2023

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

Payload CMS v1.4.2 brings important bug fixes for array fields, relationship fields, date fields, and select fields, along with new features including Ukrainian language support and improved preview functionality for draft content. This maintenance release enhances stability and user experience while expanding internationalization support.

Highlight of the Release

    • Added complete Ukrainian language translation
    • Preview functionality now exposes the most recent draft data for more accurate content previews
    • Fixed critical bug with siblingData formatting for unnamed fields within array rows
    • Resolved issue with relationship fields incorrectly setting empty arrays as default values
    • Fixed errors when clearing date fields
    • Prevented crashes when select fields have missing value options

Migration Guide

No migration is required for this release. This is a maintenance release with bug fixes and minor feature additions that are backward compatible.

Upgrade Recommendations

This release contains important bug fixes for array fields, relationship fields, date fields, and select fields. If you're using any of these field types in your Payload CMS implementation, upgrading is recommended to ensure stable operation.

The upgrade process should be straightforward:

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

No configuration changes or migrations are required.

Bug Fixes

Array Field Formatting Fix

Fixed an issue where siblingData for unnamed fields within array rows was improperly formatted. This bug was causing unexpected behavior when working with complex array structures containing unnamed fields.

Relationship Field Default Values

Resolved a bug where relationship fields with hasMany: true were incorrectly setting empty arrays as default values. This fix ensures that relationship fields only contain values that are explicitly set.

Date Field Clearing

Fixed an error that occurred when attempting to clear date fields. Users can now successfully clear date fields without encountering errors.

Select Field Stability

Addressed a crash that happened when select fields had missing value options. This fix improves the stability of forms containing select fields with dynamic or potentially incomplete option sets.

New Features

Ukrainian Language Support

Payload CMS now includes a complete Ukrainian language translation, expanding the internationalization capabilities of the platform. This addition makes the CMS more accessible to Ukrainian-speaking users and developers.

Enhanced Preview Functionality

The preview functionality has been improved to expose the most recent draft data. This enhancement provides content editors with a more accurate representation of their draft content before publishing, making the content creation and editing workflow more efficient and reliable.

Security Updates

No security fixes were mentioned in this release.

Performance Improvements

No specific performance improvements were mentioned in this release.

Impact Summary

Payload CMS v1.4.2 is a maintenance release that focuses on bug fixes and quality-of-life improvements. The most significant impact comes from fixing several field-related bugs that could cause errors or crashes in production environments.

Content editors will benefit from more stable date and select fields, as well as improved preview functionality that shows the most up-to-date draft content. Ukrainian-speaking users now have access to a complete translation of the CMS interface.

Developers will appreciate the fixes to array field formatting and relationship field default values, which resolve potential sources of unexpected behavior in their applications. The documentation improvements around reserved field names also help prevent configuration issues.

Overall, this release enhances the stability and user experience of Payload CMS without introducing breaking changes, making it a recommended upgrade for all users.

Full Release Notes

1.4.2 (2023-01-03)

Bug Fixes

  • #1775 - siblingData for unnamed fields within array rows improperly formatted (d6fcd19)
  • #1786, relationship with hasMany no longer sets empty array as default value (ecfb363)
  • error clearing date field (883daf7)
  • select field crash on missing value option (ec9196e)

Features

  • add Ukrainian translation (#1767) (49fa5cb)
  • preview now exposes most recent draft data (54dadbe)

Statistics:

File Changed42
Line Additions565
Line Deletions157
Line Changes722
Total Commits17

User Affected:

  • Can now clear date fields without errors
  • No longer experience crashes when select fields have missing value options
  • Benefit from improved preview functionality that shows the most recent draft data
  • Ukrainian-speaking users can now use the CMS in their native language

Contributors:

jacobsfletchDanRibbensZlatexjmikrut