Tag Name: v0.19.0
Release Date: 7/8/2022
Payload CMSPayload 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.
Payload CMS v0.19.0 brings several important enhancements to GraphQL capabilities, relationship field handling, and file operations. Key improvements include the ability to generate GraphQL schema, better relationship field access control, and the option to clear DatePicker values. This release also fixes critical issues with array data persistence and authentication relationships in GraphQL queries.
No breaking changes were identified that would require migration steps. This release should be compatible with applications running on v0.18.5.
If you're using relationship fields with custom access control, you may notice improved behavior where IDs can now be read from relationships regardless of access permissions on the related document.
For developers using GraphQL, the new schema generation feature can be used by running:
payload generate:graphQLSchema
This will output your GraphQL schema for documentation or integration purposes.
This release is recommended for all Payload CMS users, especially those who:
The upgrade should be straightforward with no breaking changes reported. Update your dependency version to v0.19.0 in your package.json and run your package manager's install command.
Fixed an issue where relationship fields were incorrectly affected by access control in related collections. The fix ensures that IDs can be read from relationships regardless of access permissions on the related document.
Resolved a bug where old data from arrays was being incorrectly persisted when updating documents, leading to unexpected data in array fields.
Fixed the copyfiles functionality to work properly across different operating systems, improving cross-platform development experience.
Fixed an issue where relationships in the auth/me GraphQL endpoint couldn't be properly queried, ensuring that authenticated users can access their related data.
Fixed support for passing the autoIndex option in mongoose connectionOptions, giving developers more control over database indexing behavior.
Payload now includes a new feature to generate GraphQL schema files. This allows developers to output the schema for documentation or integration purposes. The script commands are case insensitive for better developer experience.
You can now pass File arguments directly in create and update operations, making it easier to handle file uploads programmatically without needing separate steps.
The DatePicker component now allows clearing selected values. Previously, once a date was selected, users couldn't remove it without selecting another date.
No specific security fixes were mentioned in this release.
The fix for autoIndex mongoose connectionOptions can lead to performance improvements in database operations, especially for large collections, by giving developers more control over when and how indexes are built.
The improvements to relationship handling in GraphQL queries, particularly for the auth/me endpoint, should result in more efficient queries with fewer potential errors.
Payload CMS v0.19.0 delivers significant improvements to GraphQL capabilities, relationship field handling, and file operations. The new GraphQL schema generation feature will be particularly valuable for API documentation and integration workflows.
The fixes for relationship field access control and array data persistence address important pain points that could cause unexpected behavior in previous versions. Content editors will appreciate the ability to clear DatePicker values, while developers will benefit from improved cross-platform compatibility and more flexible file handling options.
Overall, this release enhances both developer experience and end-user functionality without introducing breaking changes, making it a recommended upgrade for all Payload CMS users.
