Strapi Release: 4.11.4

TL;DR

Strapi v4.11.4 is a maintenance release that addresses several critical bugs and introduces performance improvements. Key updates include fixes for Content-Type-Builder removing hidden fields, optimized data transfer operations, and improved handling of date objects in entity service filters. The release also includes TypeScript conversions for core utilities, documentation enhancements, and dependency updates.

Highlight of the Release

• Fixed Content-Type-Builder removing hidden fields on save
• Optimized data transfer operations for entities, configurations, links and assets
• Fixed permissions error on content manager page reload
• Improved date handling in entity service filters
• Fixed GraphQL pagination results

Migration Guide

No breaking changes were introduced in this release that require migration steps.

However, if you experience issues with assets not being visible at the root of the Media Library after upgrading, please check the migration guide from v4.7.0 to v4.11.4 for instructions on running an optional database migration script.

Upgrade Recommendations

This release contains important bug fixes and performance improvements, so upgrading is recommended for all Strapi users, especially if you're experiencing any of the issues addressed in this release.

To upgrade, run one of the following commands depending on your package manager:

npm install [email protected] @strapi/[email protected]

or

yarn upgrade [email protected] @strapi/[email protected]

After upgrading, restart your Strapi application. No database migrations are required for this update unless you're experiencing the Media Library asset visibility issue mentioned in the migration guide.

Bug Fixes

Core Admin

• Fixed issue where content manager shows 403 (permissions error) on page reload
• Fixed bug on Settings > Documentation & Advanced setting tab while saving
• Fixed bug when saving user details
• Improved lastUsedAt update frequency to once per hour instead of on every request

Content Management

• Fixed missing review workflows column in content manager
• Fixed Content-Type-Builder removing hidden fields on save
• Fixed image preview issues after replacement in Media Library

Data & API

• Fixed date parser for better handling of date objects
• Fixed entity-service filter $between operator to allow Date objects
• Fixed GraphQL pagination results
• Added transformParamsToQuery back to i18n plugin to fix errors
• Fixed review workflows webhooks payload structure and event handling

Performance

• Optimized pull transfer for entities, configurations, links and assets
• Refactored useRBAC hook to stop infinite loop
• Refactored useAsset query to use folderPath for better performance

New Features

This release doesn't introduce major new features but includes several enhancements:

• Added custom intervals in RelativeTime utility
• Added Spanish internationalization support
• TypeScript conversion of core utilities for better type safety and developer experience
• Contributor documentation for the data-transfer package
• Examples of async utilities in documentation

Security Updates

No specific security fixes were mentioned in this release.

Performance Improvements

Data Transfer Optimizations

• Optimized pull transfer operations for entities, configurations, links and assets, resulting in faster data transfer processes

Admin Panel Performance

• Improved performance by updating lastUsedAt timestamp only once per hour instead of on every request
• Refactored useRBAC hook to stop infinite loop, preventing unnecessary re-renders
• Refactored useAsset query to use folderPath for more efficient asset retrieval

Developer Experience

• TypeScript conversion of core utilities improves type safety and reduces runtime errors
• Removed react-select usage from RelationInput for better performance
• Updated Design System to version 1.8.1 for improved UI performance

Impact Summary

Strapi v4.11.4 is primarily a maintenance release that addresses several important bugs and introduces performance improvements. The most significant fixes include resolving issues with the Content-Type-Builder removing hidden fields, optimizing data transfer operations, and improving date handling in entity service filters.

For developers, this release brings better TypeScript support with the conversion of core utilities, fixes for GraphQL pagination, and improved webhook handling for review workflows. Content editors will benefit from fixes to the Media Library image preview functionality and resolution of permissions errors on page reload. Administrators will see improved performance with optimized data transfer operations and fixes for settings page bugs.

The performance improvements, particularly in data transfer operations and the refactoring of several hooks to prevent unnecessary re-renders, should result in a smoother experience for all users. The TypeScript conversion of core utilities also lays groundwork for better type safety and developer experience in future releases.

No breaking changes were introduced in this release, making it a safe upgrade for all Strapi users.

Full Release Notes