Tag Name: v0.5.7
Release Date: 4/13/2021
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.
This release focuses on improving form handling, user experience, and fixing several bugs. Key improvements include remembering conditional field values, auto-verification of the first registered user, optimized document saving, and fixes for array field labeling. The update also addresses pagination issues and improves GraphQL configuration schema validation.
No migration steps are required for this release. The changes are backward compatible and should work seamlessly with existing Payload implementations.
This release contains several quality-of-life improvements and bug fixes without introducing breaking changes. We recommend all users upgrade to v0.5.7 to benefit from the improved form handling, optimized saving, and first-user auto-verification.
To upgrade:
npm install [email protected]
# or
yarn add [email protected]
After upgrading, restart your application to apply the changes.
Verification token handling: Fixed an issue where verification tokens weren't properly cleared when a user was verified.
GraphQL type definitions: Resolved issues with custom query and mutation type definitions.
Auth config email prefilling: Ensured email addresses are correctly prefilled in authentication configuration forms.
Conditional field error handling: Fixed path reporting for failed conditions in forms, improving error feedback.
Array field labeling: Improved handling of add/remove labels across all implementations of the Array field type.
Pagination calculation: Fixed calculation for displaying the current range in pagination controls.
GraphQL configuration schema: Updated the configuration schema validation for GraphQL mutations and queries.
Upload cell display: Fixed issues with mimetype display in upload cells.
Auto-verification of first user registration: The first user to register on a new Payload instance is now automatically verified, eliminating the need for manual verification during initial setup.
Conditional field value retention: Fields now remember their values when they're conditionally removed and then re-added to a form, providing a better user experience when working with complex conditional logic.
Optimized document saving: The Edit component now has optimized save functionality, reducing unnecessary operations when saving documents.
Prevented re-mounting on save: DraggableSections no longer re-mount when a document is saved, preserving their state and improving the editing experience.
Streamlined upload field display: Removed mimetype from upload cell type and made it inline for a cleaner interface.
No specific security fixes were included in this release.
Optimized document saving: The save functionality within the Edit component has been optimized to reduce unnecessary operations and improve performance.
Reduced component re-mounting: DraggableSections no longer re-mount when documents are saved, which improves performance by maintaining component state and avoiding unnecessary re-renders.
More efficient form handling: Conditional fields now handle their values more efficiently, preserving data when fields are conditionally shown or hidden.
This release focuses on improving the developer and content editor experience with Payload CMS. The changes primarily affect form handling, conditional fields, and user registration.
The most significant improvements include auto-verification of the first registered user, which streamlines the initial setup process, and the retention of conditional field values, which enhances the editing experience when working with complex forms.
Performance optimizations in document saving and reduced component re-mounting will result in a smoother editing experience, especially for complex documents with many fields or sections.
The bug fixes address several pain points related to array field labeling, pagination display, and GraphQL configuration, making the overall experience more reliable and consistent.
