Strapi Release: 4.0.2

TL;DR

Strapi v4.0.2 is a maintenance release that addresses several critical bugs affecting the CLI, admin panel, content manager, and media library. This release improves stability and usability by fixing issues with policy generation, installation scripts, content manager navigation, and media file deletion.

Highlight of the Release

• Fixed policy generator template in the CLI
• Removed redundant build step from admin installation script
• Fixed navigation issues in Content Manager when search parameters are present
• Fixed critical bug preventing image deletion from the media library

Migration Guide

No specific migration steps are required for this release as it contains only bug fixes. Users can upgrade directly from v4.0.1 to v4.0.2 without any additional configuration changes.

For general migration guides and information about upgrading between major versions, please refer to the official Strapi migration documentation.

Upgrade Recommendations

This release contains important bug fixes that improve stability and usability. It is recommended that all users upgrade to v4.0.2, especially if you:

• Use the CLI to generate policies
• Have recently installed Strapi and experienced issues with the admin panel
• Work with the Content Manager and have encountered navigation problems
• Use the Media Library and have had trouble deleting images

To upgrade, run:

npm install [email protected] --save

or

yarn upgrade [email protected]

After upgrading, restart your Strapi application.

Bug Fixes

• CLI: Fixed the policy generator template (#11967) - The template for generating policies via the CLI was incorrect, causing issues when developers tried to create new policies. This has been corrected to ensure proper policy generation.

• Admin Panel: Removed redundant build step from the installation script (#11986) - Previously, the installation process was running an unnecessary build step, which has now been removed to streamline the installation process.

• Content Manager: Fixed menu link navigation when search parameters are present (#11994) - The content manager menu links were not working correctly when search parameters were in the URL, making navigation difficult. This issue has been resolved.

• Media Library: Fixed critical bug preventing image deletion (#11981) - Users were unable to delete images from the media library due to a bug in the deletion process. This has been fixed, allowing proper media management.

New Features

No new features were introduced in this release. This is a bug fix release focused on improving stability and fixing critical issues.

Security Updates

No security fixes were mentioned in this release. The changes were focused on functional bug fixes rather than security vulnerabilities.

Performance Improvements

No specific performance improvements were highlighted in this release. The changes were primarily focused on bug fixes rather than performance enhancements.

Impact Summary

This release focuses on fixing critical bugs that affect day-to-day operations in Strapi. The fixes address issues in core functionality including policy generation in the CLI, installation process optimization, content manager navigation, and media library management.

The most impactful fix is likely the resolution of the media deletion bug, which prevented users from properly managing their media assets - a critical function for content management. Additionally, the fix for content manager navigation ensures that users can properly navigate between content types even when search parameters are present in the URL.

For developers, the correction to the policy generator template ensures that custom policies can be properly created using the CLI tools, while the removal of the redundant build step from the installation script streamlines the setup process.

Overall, while this is a minor release with no new features, the bug fixes significantly improve the stability and usability of Strapi v4.0.x.

Full Release Notes