Strapi Release: 5.9.0

TL;DR

Strapi 5.9.0 introduces several content management enhancements including improved bulk publishing, container queries for form fields, and new document API methods. This release also fixes critical issues with GraphQL component population, admin user updates, and proxy path configuration. The update focuses on improving developer experience and content management workflows with minimal breaking changes.

Highlight of the Release

• Enhanced bulk publishing with improved overview interface
• Added container queries to form fields for better responsive layouts
• New document API methods for plugin developers
• Fixed GraphQL component and association population strategy
• Updated plan labeling to include Growth plan

Migration Guide

No breaking changes requiring migration were introduced in this release. Users can upgrade from v5.8.1 to v5.9.0 without any specific migration steps.

If you're using custom plugins that extend the content manager's document functionality, note that the useDocument hook now includes additional methods (getTitle and getInitialFormValues). While this shouldn't break existing implementations, you may want to review any custom code that interacts with this hook to take advantage of these new methods.

Upgrade Recommendations

This release is recommended for all Strapi users, especially those who:

• Manage content with bulk operations
• Have custom UI extensions using the document API
• Use GraphQL for component and association queries
• Work with responsive layouts in the admin panel

The upgrade from v5.8.1 to v5.9.0 should be straightforward with no breaking changes. Follow these steps:

1. Update your dependencies in package.json:

   npm upgrade [email protected] --save
   

   or

   yarn upgrade [email protected]
   

2. Install the updated packages:

   npm install
   

   or

   yarn
   

3. Restart your Strapi application:

   npm run develop
   

   or

   yarn develop
   

As always, it's recommended to test the upgrade in a development environment before applying it to production.

Bug Fixes

Critical Fixes

• GraphQL Component Population: Fixed component and association population strategy in GraphQL, resolving issues with data retrieval and relationships (adacf2976c).

• Admin User Updates: Resolved an issue where admin users couldn't be updated without providing a last name, making the profile update process more flexible (#22360).

• Vite Middleware: Fixed virtual prefix proxy path to ensure Vite middleware works correctly, improving development experience (#22579).

Other Fixes

• Review Workflows: Fixed mock returned value to match useDocument return type, ensuring proper testing and functionality (#22719).

• Users Plugin: Removed redundant grant-koa dependency in favor of grant.koa, streamlining dependencies (#22622).

• Query Parameters: Updated resolvers to use transformed query parameters for database queries, ensuring proper data handling.

New Features

Content Management Enhancements

• Better Bulk Publishing Overview: The content manager now provides an improved interface for bulk publishing operations, making it easier to manage multiple content items at once (#22618).

• Container Queries for Form Fields: Form fields now use container queries to adapt their layout based on available space, improving the editing experience on different screen sizes (#22693).

• New Document API Methods: Added new getter methods to the useDocument hook:

  • getTitle: Retrieve the title of the current document
  • getInitialFormValues: Access the initial form values of the document

  These additions make it easier for developers to extend and customize the content manager (#22683).

Administrative Updates

• Updated Plan Labeling: The plan labeling has been updated to reflect the new Growth plan option, providing clearer information about available subscription tiers (#22655).

• Current Edition Translations: Added 'Current Edition' translations to languages where the key already exists, improving the localization experience.

Security Updates

No specific security fixes were mentioned in this release. Strapi continues to maintain its security standards with regular updates and dependency maintenance.

Performance Improvements

Development Performance

• Node-gyp Update: Updated node-gyp version to improve build performance and compatibility with newer Node.js versions (#22663).

• CI/Release Workflow: Improved CI and release workflow processes for more efficient development and deployment cycles.

• Container Queries: The implementation of container queries for form fields not only improves the UI but also optimizes rendering performance by adapting layouts based on available space rather than window size.

Impact Summary

Strapi 5.9.0 delivers meaningful improvements to content management workflows and developer experience. The enhanced bulk publishing interface streamlines content operations for editorial teams, while container queries for form fields create a more responsive editing experience across different screen sizes.

For developers, the addition of new document API methods (getTitle and getInitialFormValues) provides greater flexibility when extending the content manager. The fixes to GraphQL component and association population resolve important data retrieval issues that affected complex content structures.

Administrative users will benefit from the updated plan labeling that now includes the Growth plan option, and the fix allowing admin user updates without requiring a last name improves user profile management.

Overall, this release focuses on quality-of-life improvements and bug fixes that enhance the platform's usability without introducing breaking changes, making it a recommended upgrade for all Strapi users.

Full Release Notes