5.16.1

TL;DR

Strapi v5.16.1 is a maintenance release that addresses several UI and functionality bugs, including issues with the search field, menu items, permissions handling, GraphQL queries, and CSS imports. It also includes a design system update and introduces a guided tour feature for improved user onboarding.

Highlight of the Release

• Fixed search field closing issue for improved user experience
• Standardized menu items for better UI consistency
• Fixed GraphQL query issues with draft and publish documents
• Added guided tour feature for better user onboarding
• Improved media library with proper CSS loading for image cropping

Migration Guide

No migration steps are required for this release as it primarily contains bug fixes and enhancements that don't break existing functionality.

Upgrade Recommendations

This release contains important bug fixes for GraphQL functionality, UI components, and permissions handling. It's recommended that all users upgrade to v5.16.1, especially if you:

• Use GraphQL with draft and publish functionality
• Rely on the media library's image cropping features
• Have complex permission setups with creatable buttons
• Experience issues with the search field not closing properly

The upgrade should be straightforward with no breaking changes reported.

Bug Fixes

UI and Functionality Fixes

• Search Field: Fixed an issue where the search field wasn't closing properly (#22415)
• Menu Items: Standardized menu items for better UI consistency across the application (#23264)
• Permissions: Added proper disabled state to creatable buttons when users don't have the required permissions (#23630)
• GraphQL: Fixed an issue where draft and publish document queries weren't forwarding root query arguments correctly (#23737)
• Media Library: Fixed CSS import for cropperjs by using styled components, ensuring proper styling for the image cropping functionality (#23707)

New Features

Guided Tour Feature

This release introduces a new guided tour feature to help users navigate and understand the Strapi interface:

• Added guided tour provider and tour factory (#23770)
• Implemented guided tour tooltip and step composable components (#23776)

This feature will make it easier for new users to get familiar with Strapi's interface and functionality, improving the overall onboarding experience.

Security Updates

No security fixes were mentioned in this release.

Performance Improvements

No specific performance improvements were mentioned in this release.

Impact Summary

Strapi v5.16.1 is primarily a bug fix release that addresses several UI and functionality issues. The most significant fixes include resolving problems with GraphQL queries for draft and publish documents, fixing search field behavior, standardizing menu items, and improving the media library's image cropping functionality.

The release also introduces a new guided tour feature that will improve the onboarding experience for new users. This feature includes a tour provider, factory, tooltips, and step composable components.

Additionally, the release includes an update to the Strapi Design System to version 2.0.0-rc.27, which may bring improvements to the overall UI consistency and functionality.

These changes collectively enhance the user experience, fix critical functionality issues, and provide better guidance for new users without introducing any breaking changes.

Full Release Notes