Payload CMS Release: Release 0.17.2

TL;DR

PayloadCMS v0.17.2 is a maintenance release that addresses several critical bugs affecting GraphQL queries, version control functionality, and form validation. This release improves stability for developers working with relationships, draft functionality, and required select fields without introducing any breaking changes.

Highlight of the Release

• Fixed GraphQL queries with where conditions on hasMany relationships
• Improved error handling for draft settings in version control
• Fixed validation for required select fields
• Enhanced documentation for access control arguments

Migration Guide

No migration steps are required for this release. This is a patch release that fixes bugs without introducing breaking changes or requiring any modifications to existing code.

Upgrade Recommendations

This is a recommended upgrade for all PayloadCMS users, especially those who:

• Use GraphQL queries with hasMany relationships
• Have version control enabled with drafts functionality
• Use required select fields in their collections

The upgrade process is straightforward:

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

No configuration changes or migration steps are needed after upgrading.

Bug Fixes

• GraphQL hasMany Relationship Queries: Fixed issue #576 where GraphQL queries with where conditions on hasMany relationships were not working properly. This fix ensures that filtering on hasMany relationships now works as expected (PR #582).

• Version Control Safety: Added optional chaining to safely read drafts settings on versions, preventing potential errors when accessing draft configuration (PR #577).

• Select Field Validation: Fixed an issue where the required property was not being properly passed to select fields, causing validation issues for required select inputs (PR #579).

New Features

No new features were introduced in this release. This is primarily a bug fix release focused on improving stability and fixing existing functionality.

Security Updates

No security fixes were included in this release.

Performance Improvements

No specific performance improvements were included in this release. The focus was on bug fixes and documentation enhancements.

Impact Summary

This release addresses three important bugs that could affect day-to-day operations for both developers and content editors. The GraphQL relationship fix is particularly important for applications that rely on filtering relationship data through the API. The version control fix prevents potential errors when working with drafts, improving overall stability. The select field validation fix ensures that required fields are properly validated, maintaining data integrity. While these changes are relatively small in scope, they significantly improve the reliability of core PayloadCMS functionality.

Full Release Notes