TL;DR
Payload CMS v1.8.4 brings a new Bulgarian translation, fixes several UI issues including locale popup overflow and polymorphic list drawer search, and addresses critical bugs in global schemas, relationship fields, and mongoose connections. This maintenance release improves stability and user experience with minimal breaking changes.
Highlight of the Release
- Added Bulgarian language translation
- Fixed locale popup overflow issues for better UI experience
- Improved search functionality in polymorphic list drawers
- Added proper timestamps to global schemas
- Fixed mongoose connection issues
- Resolved payload dependency inception problem
Migration Guide
No migration steps are required for this release. Version 1.8.4 is a maintenance release with bug fixes and minor enhancements that should not break existing implementations.
If you're using custom code field configurations with editorOptions, these should now work correctly without requiring any changes to your code.
For developers using TypeScript with the sendMail function, the improved typing might highlight issues in your existing code that were previously undetected, but these would be beneficial to fix for type safety.
Upgrade Recommendations
We recommend all users upgrade to v1.8.4 as it contains important bug fixes and improvements with minimal risk of breaking changes.
To upgrade:
npm install [email protected]
# or
yarn add [email protected]
# or
pnpm add [email protected]
This release is particularly important for:
- Users experiencing issues with mongoose connections
- Developers working with global schemas who need proper timestamps
- Teams using polymorphic relationships with search functionality
- Anyone using the locale selector who has encountered overflow issues
- Bulgarian-speaking users who would benefit from the new translation
Bug Fixes
UI and Display Fixes
- Locale Popup Overflow: Fixed an issue where the locale selector popup would overflow its container, causing UI problems. The CSS for the locale selector has been refined for better display.
- Polymorphic List Drawers: Resolved an issue where searches in polymorphic list drawers were not using the correct
useAsTitle field (#2710).
- File Size Formatting: Improved the upload collection list view by formatting file sizes in KB for better readability.
Schema and Data Structure Fixes
- Global Schemas Timestamps: Added proper timestamps to global schemas (#2738), ensuring consistent tracking of creation and update times.
- Code Field Schema: Adjusted the code field Joi schema to properly allow editorOptions, giving developers more control over code editing experiences.
- Relationship Field Schema: Corrected issues with relationship field schema from PR #2696.
- Group Row Hoisting: Fixed issues related to group row hoisting (#2683).
- GraphQL Where Types: Resolved problems with GraphQL where types on rows and collapsibles (#2758).
Rich Text and Editor Fixes
- Rich Text Link Custom Fields: Fixed issues with custom fields in Rich Text links (#2756).
System and Infrastructure Fixes
- Mongoose Connection: Addressed issues with mongoose connections (#2754) for improved database reliability.
- Payload Dependency Inception: Removed recursive payload dependency issues (#2717).
- SendMail Function Typing: Fixed typing of the sendMail function for better TypeScript support.
- User Creation Error Messages: Corrected inconsistency between username and email in error messages when creating new users.
New Features
Added Bulgarian Translation
The Payload CMS now supports Bulgarian language, making the platform more accessible to Bulgarian-speaking users. This addition continues Payload's commitment to internationalization and expanding global reach.
Email Example Added
A new email example has been added to the codebase, providing developers with a reference implementation for email functionality within Payload CMS applications.
Security Updates
No specific security fixes were mentioned in this release. The release primarily focuses on bug fixes, UI improvements, and feature enhancements.
Performance Improvements
Database Connection Improvements
The fixes to mongoose connections (#2754) not only address reliability issues but also improve the performance of database operations by ensuring more stable connections.
UI Performance Enhancements
The refinements to the locale selector CSS and fixes to the locale popup overflow contribute to a smoother UI experience with less rendering issues, particularly for users working with multiple languages.
Impact Summary
Payload CMS v1.8.4 is a maintenance release that focuses on bug fixes and quality-of-life improvements. The addition of Bulgarian language support expands the CMS's accessibility to more users globally.
Several critical fixes address UI issues like locale popup overflow and search functionality in polymorphic list drawers. Backend improvements include proper timestamps for global schemas, fixed mongoose connections, and resolved dependency issues.
The impact is primarily positive for all user types, with no breaking changes reported. Developers benefit from improved TypeScript support and fixed schemas, while content editors get a more reliable and user-friendly interface. The fixes to mongoose connections improve overall system stability, which benefits all users.
This release demonstrates Payload's commitment to quality, internationalization, and responding to community feedback by addressing specific issues raised in GitHub.
Full Release Notes
1.8.4 (2023-06-02)
Features
Bug Fixes
