TL;DR
Strapi v5.0.0-rc.23 brings important bug fixes and enhancements to the CMS platform, focusing on improving internationalization features, content releases functionality, and relation field handling. This release includes a new codemod for helper plugin migrations, fixes for custom fields backward compatibility, and improvements to the locale picker. Security has been enhanced with proper escaping of raw queries, while the marketplace integration now includes version parameters for better compatibility tracking. The update also addresses several UI issues and improves error handling in the admin interface.
Highlight of the Release
- New codemod for helper plugin migrations
- Fixed backward compatibility for CustomField inputs
- Enhanced security with proper escaping of raw queries
- Improved internationalization features including direct publishing of new locales
- Fixed handling of morphToMany relation ordering
- Better error handling in the admin interface
Migration Guide
Upgrading from v5.0.0-rc.22 to v5.0.0-rc.23
This release contains mostly bug fixes and enhancements without breaking changes. To upgrade:
-
Update your dependencies in package.json:
"dependencies": {
"@strapi/strapi": "5.0.0-rc.23",
"@strapi/plugin-users-permissions": "5.0.0-rc.23",
"@strapi/plugin-i18n": "5.0.0-rc.23"
}
-
If you're using custom fields, note that backward compatibility has been restored by passing the field parameter to CustomField inputs.
-
If you're working with morphToMany relations, this release improves handling of ordering in sanitize and validate functions.
-
For plugin developers using the content-type-builder, you can now access the auto loader provider which is exported for plugin use.
-
Run the update command:
npm install
# or
yarn install
Upgrade Recommendations
For projects currently using v5.0.0-rc.22, upgrading to v5.0.0-rc.23 is recommended as it contains important bug fixes and enhancements, particularly for internationalization features, content releases, and relation field handling.
The upgrade is straightforward with no breaking changes reported, making it a low-risk update that improves stability and functionality. Plugin developers will benefit from the new codemod for helper plugin migrations and the exported auto loader provider.
For production environments using v5.0.0-rc.22, this update addresses several important issues including security improvements for raw queries, which makes it a worthwhile upgrade.
Bug Fixes
Content Manager Fixes
- Fixed CustomField input to maintain backward compatibility by passing the field parameter
- Fixed locale option in the content manager
- Fixed i18n tests in the content manager
- Fixed single relation input that was incorrectly allowing multiple values
- Added proper error display on the EditView when the useDocument hook encounters errors
Content Releases Fixes
- Improved validation and implemented caching for releases
- Fixed retrieval of entryDocumentId when entry is a singleType
- Disabled add button when a document is being created
Internationalization Fixes
- Fixed status display on the locale picker
- Implemented ability to publish new locales directly
- Removed generation of localizations links table to improve performance
Other Fixes
- Fixed example data and media files uniqueness issues
- Fixed ColorPickerInput to properly use props
- Properly escaped raw queries to enhance security
- Fixed handling of morphToMany relation ordering in sanitize and validate functions
New Features
Adding codemod for helper plugin migrations
This release introduces a new codemod to assist developers in migrating helper plugins to be compatible with Strapi v5. This tool automates the process of updating code to match the new API structure and requirements, making the upgrade process smoother for plugin developers.
Export auto loader provider for plugin use
The content-type-builder now exports its auto loader provider, allowing plugin developers to utilize this functionality in their custom plugins. This enhancement improves the extensibility of Strapi and enables more sophisticated plugin development.
Security Updates
Raw Query Escaping
This release addresses a security concern by properly escaping raw queries, which helps prevent SQL injection attacks and improves the overall security posture of Strapi applications.
Performance Improvements
Improved Content Loading
The release includes optimizations for content loading, particularly by not generating localizations links tables, which can improve performance when working with multilingual content.
Enhanced Caching for Releases
Content releases now implement improved caching mechanisms, which should result in faster loading times when working with content releases in the admin panel.
Impact Summary
Strapi v5.0.0-rc.23 is primarily a bug fix and enhancement release that improves stability and user experience across the platform. The most significant impacts include:
-
Developer Experience: The new codemod for helper plugin migrations and the exported auto loader provider from content-type-builder enhance the developer experience when working with plugins and custom extensions.
-
Content Editing: Several improvements to internationalization features make working with multilingual content more intuitive, including fixed status display on the locale picker and the ability to publish new locales directly.
-
Security: The proper escaping of raw queries addresses a potential security vulnerability, improving the overall security of Strapi applications.
-
Relation Handling: Fixes for single relation inputs and morphToMany relation ordering ensure more reliable data management when working with complex content structures.
-
UI Improvements: Better error handling in the admin interface and fixes to various UI components like the ColorPickerInput enhance the overall user experience.
These changes collectively make Strapi more stable, secure, and user-friendly for both developers and content editors.
