Payload CMS Release: Release 1.5.7

TL;DR

Payload CMS v1.5.7 fixes critical issues with the draft functionality, ensuring that queries with draft=true now properly include all draft content without excluding draft IDs or causing problems with published/non-published posts. This release focuses exclusively on fixing draft-related query bugs that were affecting content management workflows.

Highlight of the Release

• Fixed critical issue where queries with draft=true were incorrectly excluding some draft IDs
• Resolved inconsistencies in draft queries between published and non-published posts
• Improved draft query handling to exclude outdated versions

Migration Guide

No migration is required for this release. The fixes are backward compatible and will automatically improve the behavior of draft queries without requiring any code changes or configuration updates.

Upgrade Recommendations

This upgrade is recommended for all users who utilize Payload's draft functionality in their applications. The fixes address important issues with draft queries that could affect content management workflows.

To upgrade:

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

No configuration changes or migration steps are required after upgrading.

Bug Fixes

Draft Query Improvements

• Fixed draft ID exclusion issue: Resolved a bug where using draft=true in queries would incorrectly exclude some draft IDs, leading to incomplete results when searching for draft content.

• Fixed inconsistent draft behavior: Corrected an issue where querying with drafts worked differently between published and non-published posts, creating inconsistent user experiences depending on content status.

• Improved version handling: Enhanced the draft query system to properly exclude outdated versions when querying with draft=true, ensuring only the most current content versions are returned.

New Features

No new features were added in this release. This is a bug fix release focused on improving the existing draft functionality.

Security Updates

No security fixes were included in this release.

Performance Improvements

No specific performance improvements were included in this release. The changes were focused on fixing functional issues with draft queries rather than performance optimization.

Impact Summary

This release focuses on fixing issues with Payload's draft functionality, specifically addressing how queries with draft=true handle content. The fixes ensure that draft IDs are properly included in query results and that the behavior is consistent across both published and non-published posts.

These changes are particularly important for content management workflows where editors need to reliably access and work with draft content. Prior to this fix, some draft content might have been improperly excluded from query results, potentially causing confusion or workflow disruptions.

The impact is primarily positive for content editors and developers working with draft content, as they will now experience more predictable and complete query results without having to implement workarounds.

Full Release Notes