TL;DR
Strapi v5.2.0 introduces a dedicated preview page with enhanced UI features, improves relation handling, fixes filter attribute naming, and adds database connection flexibility. This release focuses on UI enhancements, bug fixes, and developer experience improvements, with notable additions including preview functionality, better TypeScript support, and fixes for content management issues.
Highlight of the Release
- New dedicated preview page with enhanced UI features
- Database connection can now be defined as a function for more flexibility
- Improved handling of relations when loading more than 10 items
- Fixed filter attribute naming for better API request handling
- Better TypeScript support with declared modules in @strapi/strapi
Migration Guide
No breaking changes were introduced in this release that would require a specific migration guide. The upgrade from v5.1.1 to v5.2.0 should be straightforward.
If you're using TypeScript and have custom code that interacts with the modules in @strapi/strapi, you may benefit from the improved module declarations. Review your TypeScript code to ensure it takes advantage of these improvements.
For developers using the database connection configuration, note that you can now use a function for more dynamic connection setup if needed.
Upgrade Recommendations
This release contains valuable UI improvements, bug fixes, and developer experience enhancements without introducing breaking changes. It's recommended for all users to upgrade to benefit from these improvements.
The upgrade process should be straightforward:
npm upgrade [email protected] --save
# or
yarn upgrade [email protected]
After upgrading, restart your Strapi application and verify that all functionality works as expected.
Bug Fixes
Relations Loading
Fixed an issue where loading more than 10 relations wasn't working correctly, ensuring proper ordering and display of related content.
List View Pagination
Fixed broken list view pagination to ensure consistent navigation through content lists.
Single Type Names
Fixed an issue where single type names were not properly applied in the content manager, ensuring consistent naming throughout the interface.
Filter Attribute Names
Fixed filter attribute naming in API requests, improving the reliability of filtering operations.
Search by Numeric Values in Relations
Fixed the ability to search by numeric values in relations, enhancing search functionality.
User Role Updates
Fixed an issue where user IDs weren't being sent when connecting relations, which was necessary to update user roles properly.
New Features
New Preview Page
A dedicated preview page has been added to improve the content preview experience. This includes a new preview header with document status information and a copy preview URL button, making it easier to share and test content before publishing.
Database Connection as Function
Database connections can now be defined as a function, providing more flexibility in how connections are established and managed. This is particularly useful for dynamic connection configurations.
OpenAPI Documentation Improvements
Added mapping property support for the documentation plugin's OpenAPI generated docs. Dynamic zones are now reflected in the OpenAPI docs as an anyOf with discriminator and mapping to improve documentation clarity.
Security Updates
No significant security fixes were included in this release.
Performance Improvements
Data Transfer Engine Improvements
Enhanced the Data Transfer Engine (DTE) to assert that the count of items sent and received is equal, providing better validation during data transfers and migrations.
Test Workflow Optimization
Added test workflow filters for each test type, improving the efficiency of the testing process and reducing unnecessary test runs.
Impact Summary
Strapi v5.2.0 focuses on enhancing the content editing experience with a new dedicated preview page and improved UI elements. Content editors will benefit from better relation handling, clearer empty component wording, and convenient preview URL copying functionality.
Developers gain more flexibility with database connections that can be defined as functions, improved TypeScript support, and better OpenAPI documentation for dynamic zones. The fixes to filter attribute naming and relation handling improve API reliability.
Administrators will appreciate fixes to single type naming, list view pagination, and user role updates when connecting relations. The Data Transfer Engine improvements ensure more reliable data transfers by validating that sent and received item counts match.
Overall, this release enhances both the user interface and developer experience without introducing breaking changes, making it a recommended upgrade for all Strapi users.
Full Release Notes
What's Changed
New Contributors
Full Changelog: v5.1.1...v5.2.0
