Strapi Release: 5.4.0

TL;DR

Strapi v5.4.0 introduces reordering for polymorphic relations in the Content API, fixes several bugs including media population in document service, and continues the TypeScript migration of the media library. This release enhances developer experience with improved stability and new capabilities for managing complex content relationships.

Key improvements include fixing the issue where stage changes incorrectly updated modified status in review workflows, resolving query ambiguity during v5 database migrations, and ensuring Strapi loads properly before watch mode activates. The release also adds support for Uzbek language in the admin panel.

Highlight of the Release

• Added support for reordering polymorphic relations in the Content API
• Fixed media population in document service for more reliable content delivery
• Resolved issue where stage changes incorrectly updated modified status in review workflows
• Fixed query ambiguity during Strapi v5 database migrations
• Continued TypeScript migration of media library components and pages

Migration Guide

No specific migration steps are required for upgrading from v5.3.0 to v5.4.0. This is a minor release with new features and bug fixes that should not break existing functionality.

For general update guidance, refer to the official Strapi update guide.

If you're migrating from an earlier version of Strapi to v5, please consult the migration guides for detailed instructions.

Upgrade Recommendations

This release is recommended for all Strapi v5.3.x users as it includes important bug fixes and new features without introducing breaking changes.

Priority: Medium

• For production environments: This update is recommended but not urgent unless you're experiencing specific issues addressed in this release, such as problems with polymorphic relations, review workflow stage changes, or media population.

• For development environments: Upgrading is recommended to take advantage of the new features and TypeScript improvements.

To upgrade, run:

npm install [email protected]

or

yarn upgrade [email protected]

Bug Fixes

Core Fixes

• Loading Order Fix: Resolved an issue where Strapi wasn't properly loaded before watch mode was activated, which could cause startup problems.

• Media Population in Document Service: Fixed an issue with media population in the document service, ensuring that media assets are correctly included when retrieving content.

• Database Migration Query Ambiguity: Addressed a potential query ambiguity during Strapi v5 database migrations that could occur when a content type used internationalization and one of its fields was named after the content type with "Id" appended.

Review Workflows Improvements

• Stage Change Behavior: Fixed an issue where changing stages in review workflows incorrectly updated the modified status of content.

UI Fixes

• Tooltip Text Fix: Resolved an issue where "Line 1, line 2, line 3" was incorrectly displayed in the tooltip of the edit button in Bulk Publish, replacing it with the correct "Edit" text.

• Last Draft Display: Fixed an issue where the last draft was displaying "NaN" instead of the proper date/time.

New Features

Reordering for Polymorphic Relations in Content API

The most significant new feature in this release is the addition of reordering capabilities for polymorphic relations in the Content API. This enhancement allows developers to better manage and organize content with complex relationship structures, providing more flexibility in how related content is arranged and displayed.

Uzbek Language Support

This release adds support for the Uzbek language (O'zbekcha) in the admin panel, expanding Strapi's internationalization capabilities and making the platform more accessible to Uzbek-speaking users.

Security Updates

No specific security fixes were mentioned in this release.

Performance Improvements

E2E Testing Performance

Updated Playwright timeouts to improve the reliability and performance of end-to-end tests, reducing flaky test results and providing more consistent testing outcomes.

Startup Performance

The fix for loading Strapi before watch mode improves startup reliability and potentially reduces startup time by ensuring proper initialization sequence.

Impact Summary

Strapi v5.4.0 delivers meaningful improvements for both developers and content editors. The addition of reordering for polymorphic relations in the Content API gives developers more control over complex content relationships, while fixes to review workflows ensure content editors have a more reliable experience when managing content through different stages.

The continued TypeScript migration of the media library components and pages represents Strapi's ongoing commitment to improving code quality and developer experience. This migration will ultimately lead to better type safety, improved IDE support, and fewer runtime errors.

Database-related fixes address potential issues during migrations and ensure more reliable operation, particularly for projects using internationalization features. The fix for loading Strapi before watch mode improves the development experience by ensuring proper initialization.

Overall, this release focuses on stability, developer experience, and expanding content management capabilities, making it a worthwhile upgrade for most Strapi users.

Full Release Notes