Strapi Release: 5.5.0

TL;DR

Strapi 5.5.0 introduces enhanced video capabilities with Mux player integration, improved preview functionality, and diagnostic messaging from remote Strapi instances. This release focuses on improving the content management experience with better UI controls and fixes several bugs related to document actions, GraphQL queries, and preview functionality. The update also includes various dependency updates and internal code improvements that enhance the overall stability and performance of the CMS.

Highlight of the Release

• Integration of Mux player for enhanced video playback capabilities
• Improved preview functionality with disabled links when changes aren't saved
• Ability to send diagnostic messages from remote Strapi instances
• Fixed document actions being rendered multiple times
• Updated purchase page links and added Content History menu link

Migration Guide

No specific migration steps are required for this release. However, if you're using custom video players or have implemented custom preview functionality, you may want to review the changes related to Mux player integration and preview functionality improvements to ensure compatibility with your customizations.

If you're using the GraphQL API and specifically the me query, note that it now includes a documentId field which might affect your query results if you're using strict typing or validation.

Upgrade Recommendations

This release includes several important bug fixes and feature enhancements that improve the overall user experience and functionality of Strapi. The upgrade is recommended for all users, especially those who:

1. Work extensively with video content and would benefit from the Mux player integration
2. Use the preview functionality regularly
3. Rely on the GraphQL API, particularly the me query
4. Need better diagnostic capabilities for remote Strapi instances

The update appears to be primarily focused on improvements rather than breaking changes, making it a relatively safe upgrade for most users. As always, it's recommended to test the upgrade in a non-production environment before applying it to production systems.

Bug Fixes

Document Actions Rendering

Fixed an issue where document actions were being rendered multiple times, causing potential performance issues and UI inconsistencies in the admin interface.

GraphQL Query Enhancement

Added documentId to the me GraphQL query, ensuring that all necessary data is returned when querying user information through the GraphQL API.

Preview Functionality Improvements

Several fixes to the preview functionality:

• Added proper page title tags to get browser tooltips working correctly
• Ensured the header title matches the edit view for consistency
• Fixed disabled preview button behavior when changes aren't saved
• Resolved issues with broken hover states in e2e tests

i18n Settings

Turned on and updated i18n settings tests, fixing functionality issues with internationalization settings in the admin panel.

New Features

Mux Player Integration

Strapi now uses Mux player for video content, providing a more robust and feature-rich video playback experience within the admin panel. This integration enhances the media management capabilities of Strapi with better video controls and playback options.

Remote Diagnostic Messaging

A new feature has been added that allows sending diagnostic messages from remote Strapi instances. This functionality improves troubleshooting and monitoring capabilities, especially for distributed or multi-environment setups, making it easier to identify and resolve issues across different Strapi deployments.

Security Updates

No specific security fixes were mentioned in this release.

Performance Improvements

Dependency Management

Improved internal dependency management by using workspace:* notation for internal dependencies, which helps with package resolution and can lead to better build performance.

Build Tooling Updates

Upgraded vite-plugin-dts for better TypeScript declaration file generation, which can improve development experience and build times.

Package Cleanup

Removed support for assets without metadata, streamlining the codebase and potentially improving asset handling performance.

Dependency Updates

Updated several dependencies including @strapi/design-system (from 2.0.0-rc.13 to 2.0.0-rc.14) and @strapi/pack-up (to v5.0.2), bringing performance improvements and bug fixes from these packages.

Impact Summary

Strapi 5.5.0 brings notable improvements to the content management experience, particularly for users working with video content through the new Mux player integration. Content editors will benefit from enhanced preview functionality, including better disabled state handling when changes aren't saved and improved page titles.

Developers gain access to diagnostic messages from remote Strapi instances, which is valuable for troubleshooting and monitoring in multi-environment setups. The GraphQL API has been improved with the addition of the documentId field to the me query.

The release also includes several internal improvements to dependency management and build tooling that contribute to the overall stability and maintainability of the codebase. These changes, while less visible to end users, help ensure a more robust CMS platform.

For administrators, the updated purchase page links and addition of the Content History menu link improve navigation and access to important features. The fixes to i18n settings also ensure better functionality for multilingual content management.

Full Release Notes