Home

>

Tools

>

Payload CMS

>

Releases

>

Release 1.6.23

Payload CMS Release: Release 1.6.23

Tag Name: v1.6.23

Release Date: 3/22/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

PayloadCMS v1.6.23 brings important bug fixes and new features that enhance the developer and admin experience. This release addresses issues with file handling, relationship fields, localization, and UI components while adding new capabilities for thumbnail display and collection sorting. These improvements make PayloadCMS more reliable and customizable for content management needs.

Highlight of the Release

    • Fixed file deletion when overwriteExistingFiles is set to true
    • Added support for base64 thumbnails
    • Exposed defaultSort property for collection list views
    • Fixed relationship field useAsTitle functionality
    • Improved version tabs and select field comparisons
    • Added title attribute to ThumbnailCard for better accessibility
    • Fixed localization issues with non-localized fields

Migration Guide

No migration is required for this release. All changes are backward compatible and should work with existing PayloadCMS implementations.

Upgrade Recommendations

This release contains important bug fixes and quality-of-life improvements. It is recommended for all PayloadCMS users to upgrade to v1.6.23, especially if you're experiencing any of the specific issues addressed in this release such as file deletion problems, relationship field display issues, or localization concerns.

To upgrade:

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

Bug Fixes

  • File Deletion with Overwrite: Fixed issue #2315 where files weren't being properly deleted when overwriteExistingFiles was set to true.

  • Relationship Field Display: Resolved issue #2333 with relationship fields not correctly using the useAsTitle property for display.

  • Base64 Thumbnails Support: Added support for base64 thumbnails, fixing rendering issues when thumbnails are stored in this format.

  • DateField Admin Type: Fixed issues with the DateField admin type to ensure proper handling and display of date values.

  • Localization Fallback: Fixed issue where the fallback to default locale was incorrectly showing on non-localized fields.

  • Spanish Translations: Added missing Spanish translations to improve the experience for Spanish-speaking users.

  • Version Tabs and Select Fields: Fixed issue #2363 related to version tabs and select field comparisons, ensuring proper display and functionality when comparing document versions.

  • ThumbnailCard Formatting: Retrofitted formatUseAsTitle into ThumbnailCard for consistent title formatting.

New Features

  • Title Attribute for ThumbnailCard: Added a title attribute to the ThumbnailCard component, improving accessibility and providing additional context when hovering over thumbnails.

  • Default Sort for Collection Lists: Exposed the defaultSort property for collection list views, allowing developers to specify the default sorting behavior for collections in the admin UI.

  • Exported AccessArgs Type: The AccessArgs type is now exported from payload/types, enabling more granular typing when imported in custom code, improving TypeScript development experience.

Security Updates

No specific security fixes were included in this release.

Performance Improvements

  • Monaco Editor Loading: Ensured the Monaco editor loader maintains the same height as its parent, providing a more consistent loading experience.

  • Code Editor Height: Improved code editor and loading shimmer to properly use height from props, ensuring consistent UI rendering.

Impact Summary

PayloadCMS v1.6.23 is a maintenance release that focuses on bug fixes and minor feature enhancements. The most significant improvements address file handling, relationship field display, localization issues, and UI components.

For developers, the release provides better TypeScript support with exported types and new configuration options like defaultSort for collection lists. Content editors will benefit from fixes to relationship fields, version comparisons, and improved localization handling. The UI experience is enhanced with better thumbnail support and more consistent component behavior.

While this is not a major release, the bug fixes address several pain points reported by the community, making it a worthwhile upgrade for most PayloadCMS users.

Full Release Notes

1.6.23 (2023-03-22)

Bug Fixes

Features

  • adds title attribute to ThumbnailCard (#2368) (a8766d0)
  • exposes defaultSort property for collection list view (#2382) (1f480c4)

Statistics:

File Changed53
Line Additions662
Line Deletions130
Line Changes792
Total Commits20

User Affected:

  • Access to new `defaultSort` property for collection list views
  • Better TypeScript support with exported `AccessArgs` type
  • Fixed file deletion behavior when `overwriteExistingFiles` is true
  • Improved middleware documentation

Contributors:

jmikrutJarrodMFleschjacobsfletchChrisGV04PatrikKozakDanRibbensfionuesjessrynkar