Payload CMS Release: 2.24.0

Tag Name: v2.24.0

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

Payload CMS v2.24.0 brings enhanced file management and database configuration

This release introduces the ability to upload files from remote URLs, allowing content managers to easily import external images. It also adds support for configuring Mongoose schema options, giving developers more control over MongoDB operations. Additionally, a critical bug fix ensures proper handling of localized access queries, improving multilingual content management.

Highlight of the Release

    • New 'Paste URL' button for uploading files from remote URLs
    • Support for configuring Mongoose schema options
    • Fixed access queries to properly handle locale parameters

Migration Guide

No migration is required for this release as all changes are non-breaking additions or bug fixes.

Upgrade Recommendations

This is a recommended upgrade for all users, especially for:

  • Content teams who would benefit from the ability to upload files from remote URLs
  • Developers who need more control over Mongoose schema configurations
  • Projects using localization features that may have been affected by the access query bug

The release contains no breaking changes, making it a safe upgrade from v2.23.1.

Bug Fixes

Fixed Locale-Aware Access Queries

This release fixes an issue where access queries weren't properly running with locale parameters when present. This ensures that access control properly respects localization settings, improving the reliability of multilingual content management. The fix addresses the issue reported in #6915.

New Features

Remote URL File Uploads

Content managers can now upload files directly from remote URLs without having to download and re-upload them. This feature adds a new "Paste URL" button to the upload interface, which opens a modal where users can input a remote URL of an image or file. This streamlines the workflow for importing external media assets into Payload.

Configurable Mongoose Schema Options

Developers now have the ability to configure Mongoose's schemaOptions, providing more control over how Mongoose operates internally. This enhancement allows for customizations such as disabling strict mode in Mongoose to preserve data in MongoDB that is not reflected in Payload schemas. This feature gives developers more flexibility in how they work with their database.

Security Updates

No security fixes were mentioned in this release.

Performance Improvements

No specific performance improvements were highlighted in this release.

Impact Summary

Payload CMS v2.24.0 enhances both developer and content manager experiences with meaningful additions to file handling and database configuration options.

For content managers, the new remote URL upload feature significantly streamlines workflows when working with external media assets. Instead of the traditional download-then-upload process, users can now directly import files from URLs with a simple paste operation.

For developers, the addition of configurable Mongoose schema options opens up new possibilities for database management, particularly for applications with complex data requirements or those migrating from other systems. The ability to disable strict mode can be especially valuable when working with existing MongoDB collections that contain fields not defined in Payload schemas.

The bug fix for locale-aware access queries ensures more reliable operation for multilingual sites, preventing potential issues where access controls might not properly respect the current locale context.

Overall, this release delivers quality-of-life improvements that enhance Payload's flexibility while maintaining backward compatibility.

Full Release Notes

2.24.0 (2024-07-16)

Features

  • adds ability to upload files from a remote url (#7087) (84d214f)
  • db-mongodb: allows mongoose schemaOptions to be configured (#7099) (51474fa)

Bug Fixes

  • ensures access query runs with locale when present (#6981) (a5492af)

Statistics:

File Changed84
Line Additions1,175
Line Deletions426
Line Changes1,601
Total Commits10

User Affected:

  • Can now upload files directly from remote URLs without needing to download and re-upload them
  • Benefit from improved workflow efficiency when importing external media assets

Contributors:

JarrodMFleschAdarsh-Raj-JaiswalfedericodilucathecodeinfluencerPatrikKozakKonsequanzhengjessrynkarjmikrutdenolfe