Strapi Release: 4.10.6

TL;DR

Strapi v4.10.6 is a maintenance release that focuses on bug fixes, enhancements, and dependency updates. Key improvements include fixes for media library folder management, collection name validation, and Cloudinary upload handling. The release also enhances the admin interface with better error displays and refactors the webhooks list view for improved performance.

Highlight of the Release

• Fixed critical issue where media library folders and files could get unintentionally deleted
• Improved collection name validation to ensure uniqueness of collection names and IDs
• Enhanced Cloudinary provider to use chunked uploads for better handling of large files
• Refactored webhooks list view for improved performance and user experience
• Fixed issue with description and min/max characters not being visible during validation errors

Migration Guide

No specific migration steps are required for this release. This is a maintenance release that focuses on bug fixes and enhancements.

If you're using Cloudinary as a provider and working with large files (>100MB), you'll automatically benefit from the improved chunked upload implementation without any configuration changes.

Upgrade Recommendations

This release contains important bug fixes, especially for media library management and collection name validation. It's recommended for all users to upgrade, particularly if you:

1. Work extensively with the media library and folder organization
2. Are developing content types with similar singular/plural names
3. Use Cloudinary for media storage and work with large files
4. Rely on webhooks for integrations

The upgrade process should be straightforward with minimal risk, as this is primarily a maintenance release with no breaking changes.

Bug Fixes

Media Library Folder Management

• Fixed a critical issue where media library folders and files could get unintentionally deleted
• Resolved a problem where some folders couldn't be moved inside others
• Improved path matching logic for folder operations

Content Management

• Fixed issue where description and min/max characters were not visible during validation error screens
• Fixed collection names check for plural names in edit mode
• Added validation to prevent singular name conflicts with collection names

Data Transfer

• Fixed an issue in transfer pull operations where the code was waiting for websocket connections multiple times, causing potential performance issues

Admin User Management

• Fixed a bug where the system would try to use undefined admin user email, causing errors

Cloudinary Provider

• Fixed file upload limitations by using upload_chunked_stream instead of upload_stream, allowing for uploads larger than 100MB

New Features

Collection Names and IDs Uniqueness

The content-type builder now enforces uniqueness for collection names and IDs, preventing potential conflicts in your content structure. This validation ensures that singular and plural names don't clash with existing collection names, improving the robustness of your content model.

Webhooks List View Refactoring

The webhooks management interface has been completely refactored to use modern React patterns and React Query for state management. This results in a more responsive and maintainable UI with improved data fetching, mutation handling, and better error management.

Environment Property in Tracking System

The environment property has been reintroduced in the tracking system, allowing for better analytics and monitoring of your Strapi instance across different environments.

Security Updates

No significant security fixes were included in this release.

Performance Improvements

Webhooks Management

The webhooks list view has been completely refactored to use React Query for data fetching and state management, resulting in more efficient rendering and better performance when managing webhooks.

API Calls Optimization

Replaced numerous axios calls with helper-plugin utilities, standardizing the way API calls are made throughout the admin panel and improving overall responsiveness.

Build Tooling

• Aligned SWC usage for unit tests and fixed SWC/helpers hazards
• Removed unnecessary dependencies like react-fast-compare and react-test-renderer
• Updated Design System to version 1.7.7 for better performance

Impact Summary

Strapi v4.10.6 is a maintenance release that addresses several important bugs and introduces quality-of-life improvements for both developers and content managers.

The most significant fixes target the media library, preventing unintentional deletion of folders and files and resolving issues with folder movement operations. These improvements enhance data safety and provide a more reliable media management experience.

For developers, the collection name validation enhancements ensure more robust content modeling by preventing naming conflicts. The Cloudinary provider improvements allow for handling larger files through chunked uploads, removing the previous 100MB limitation.

The webhooks list view refactoring demonstrates Strapi's ongoing modernization efforts, moving toward React Query for state management and improving the overall developer experience when working with the admin panel.

While this release doesn't introduce major new features, the cumulative effect of these fixes and enhancements results in a more stable, performant, and user-friendly Strapi experience.

Full Release Notes