Strapi Release: 5.5.1

TL;DR

Strapi v5.5.1 is a maintenance release that brings several bug fixes, enhancements, and new features. Key improvements include reverse proxy support, keyboard shortcuts for saving entries, new language support (Wolof and Xhosa), and the introduction of Mux Player for video. This release also fixes issues with polymorphic relations, preview functionality, and permission settings.

Highlight of the Release

• Improved reverse proxy support for better deployment flexibility
• New keyboard shortcuts (Cmd+Enter/Ctrl+Enter) to save entries
• Added support for Wolof and Xhosa languages
• Introduced Mux Player for video content
• Fixed polymorphic relation encoding and index mapping issues
• Improved preview functionality with fixed back button behavior

Migration Guide

This is a patch release (5.5.0 → 5.5.1) with no breaking changes, so upgrading should be straightforward:

1. Update your Strapi dependencies in your package.json file:

   npm upgrade [email protected] --save
   # or
   yarn upgrade [email protected]
   

2. If you're using reverse proxy configurations, this release includes fixes that might affect your setup. Review your proxy settings to ensure they work correctly with the updated implementation.

3. If you're using polymorphic relations, be aware that this release includes fixes to encoding and index mapping that might affect how your data is handled. No migration is required, but testing your specific implementation is recommended.

Upgrade Recommendations

This release contains important bug fixes and enhancements that improve the stability and usability of Strapi. It's recommended to upgrade to v5.5.1, especially if you:

• Use reverse proxy configurations
• Work with polymorphic relations
• Use the preview functionality
• Need keyboard shortcuts for saving content
• Require support for Wolof or Xhosa languages

The upgrade process should be straightforward as this is a patch release with no breaking changes. As always, it's recommended to test the upgrade in a development environment before applying it to production.

Bug Fixes

• Reverse Proxy Support: Fixed issues with reverse proxy configuration to improve deployment flexibility (#21914)
• Polymorphic Relations: Adjusted polymorphic relation encoding and index mapping to resolve data handling issues (#22380)
• Preview Functionality:
  • Fixed back button behavior in preview mode (#22334)
  • Disabled preview link when changes are not saved to prevent inconsistent previews (#22275)
• UI Improvements:
  • Fixed cursor pointer issue in permission checkbox settings icon (#22328)
  • Improved file preview fallbacks in the upload plugin (#22351)
• Documentation Plugin: Fixed issue where the documentation plugin was making git changes in production environments (#21950)
• GraphQL: Fixed access to GraphQL playground when the users-permissions plugin is not installed (#22354)
• Document Actions: Fixed issue where document actions were being rendered multiple times (#22283)
• GraphQL Query: Added documentId to me GraphQL query (#22321)

New Features

• Mux Player for Video: Integrated Mux Player for improved video handling capabilities (#20897)
• Diagnostic Messages: Added functionality to send diagnostic messages from remote Strapi instances (#22214)
• Content History Menu Link: Added a direct link to Content History in the menu for easier access (#21531)

Security Updates

No significant security fixes were mentioned in this release.

Performance Improvements

• Dependency Management:
  • Removed duplicate dependencies to reduce bundle size (#22394)
  • Used "workspace:*" for internal dependencies for better package management (#22303)
• Build Process:
  • Upgraded vite-plugin-dts for improved TypeScript declaration file generation (#22297)
  • Set up NX releases for better build management (#22264)
• Cleanup: Removed support for assets without metadata to streamline asset handling (#22215)

Impact Summary

Strapi v5.5.1 is primarily a maintenance release that focuses on bug fixes and quality-of-life improvements. The most significant impacts are:

1. Improved Developer Experience: Better support for reverse proxying and fixed polymorphic relation handling make Strapi more reliable in various deployment scenarios.

2. Enhanced Content Editing: New keyboard shortcuts for saving entries (Cmd+Enter/Ctrl+Enter) and improved preview functionality streamline the content creation workflow.

3. Better Internationalization: Support for Wolof and Xhosa languages, plus French translations for blocks, makes Strapi more accessible to a global audience.

4. Media Improvements: The introduction of Mux Player for video content and cleaner fallbacks for file previews enhance media handling capabilities.

Overall, this release addresses several pain points reported by the community while adding small but meaningful enhancements to improve the day-to-day usage of Strapi.

Full Release Notes