Home

>

Tools

>

Payload CMS

>

Releases

>

Release 1.6.10

Payload CMS Release: Release 1.6.10

Tag Name: v1.6.10

Release Date: 2/14/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.6.10 brings several quality-of-life improvements including async plugins support, better relationship field controls, additional exported errors, and fixes for various bugs related to versions, globals, and translations. This release enhances developer experience while maintaining backward compatibility.

Highlight of the Release

    • Added support for async plugins, allowing for more flexible configuration
    • Improved relationship fields with ability to control 'Add New' button visibility
    • Fixed globals not saving drafts unless published first
    • Enhanced internationalization with improved Spanish and Croatian translations
    • Fixed DatePicker to use the user's AdminUI locale

Migration Guide

No migration is required for this release. All changes are backward compatible and should work with existing Payload projects without modification.

If you're using the version system and rely on the createdAt timestamps of versions, note that these will now correctly match the original document's timestamp, which might affect any custom code that expected the previous behavior.

Upgrade Recommendations

This release is recommended for all Payload users as it contains several bug fixes and quality-of-life improvements without introducing breaking changes.

Particularly important for:

  • Users working with global documents and drafts
  • Developers using relationship fields who want more control over the UI
  • Projects with international users, especially Spanish and Croatian speakers
  • Anyone experiencing issues with the DatePicker localization
  • Developers looking to implement async plugins

Update using your package manager:

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

Bug Fixes

Document Type Handling

Fixed an issue with document type handling in the collection update request handler, ensuring more consistent behavior when updating documents.

Versions CreatedAt Timestamp

Resolved a bug where version documents' createdAt timestamps weren't matching the original document's timestamp, ensuring better historical accuracy in the versioning system.

Globals Draft Saving

Fixed a critical issue where global documents couldn't save drafts unless they were published first, improving the content editing workflow for global content.

DatePicker Localization

The DatePicker component now correctly uses the user's AdminUI locale settings, providing a more consistent localized experience throughout the admin interface.

API Key UI with Disabled Local Strategy

Fixed issue #2077 where the API Key UI would be missing when the local authentication strategy was disabled, ensuring users can still manage API keys regardless of authentication configuration.

Translation Improvements

  • Added missing Spanish translations and fixed typos in existing translations
  • Fixed typos in Croatian translations

New Features

Async Plugins Support

Payload now supports async plugins, enabling more flexible configuration options and allowing plugins to perform asynchronous operations during initialization. This is particularly useful for plugins that need to fetch data or perform other async tasks before being fully configured.

Enhanced Relationship Field Controls

Developers can now control the visibility of the 'Add New' button in relationship fields, providing more customization options for the admin UI and potentially simplifying the interface for content editors when creating new related items isn't desired.

Additional Exported Errors

More error types are now exported from the core package, making it easier for developers to handle specific error cases in their custom code and providing better type safety when working with Payload's error system.

Security Updates

No security fixes were mentioned in this release.

Performance Improvements

No specific performance improvements were highlighted in this release. The changes were primarily focused on new features, bug fixes, and documentation improvements.

Impact Summary

Payload CMS v1.6.10 is a maintenance release that improves developer experience and fixes several bugs without introducing breaking changes. The addition of async plugins provides more flexibility in configuration, while the ability to control relationship field "Add New" buttons offers better UI customization.

Several important bugs were fixed, including issues with globals not saving drafts, incorrect version timestamps, and DatePicker localization. The release also improves internationalization with better Spanish and Croatian translations.

This update is particularly valuable for developers working with complex plugin architectures, teams using draft functionality with globals, and projects serving international users. The changes are backward compatible, making this a safe upgrade for all Payload projects.

Full Release Notes

1.6.10 (2023-02-14)

Bug Fixes

  • #2077 useAPIKey UI missing with disableLocalStrategy (#2084) (586b25a)
  • Add missing Spanish translations and fix typos (c4742e5)
  • document type in update request handler (d5cd970)
  • ensures versions createdAt matches the original doc (8c7e37c)
  • globals not saving drafts unless published first (#2082) (4999fba)
  • Use the user's AdminUI locale for the DatePicker (#2046) (#2057) (b4a7e91)
  • validate type (7bb0984)

Features

Statistics:

File Changed59
Line Additions575
Line Deletions316
Line Changes891
Total Commits28

User Affected:

  • Can now use async plugins for more flexible configuration
  • Have access to more exported errors for better error handling
  • Can control the visibility of 'Add New' buttons in relationship fields
  • Benefit from fixed document type handling in update requests

Contributors:

behilamcharkourChrisGV04denolfenikolicstjepanJarrodMFleschjacobsfletchjmikrutPatrikKozaklucaslcodeDanRibbens