Strapi Release: 3.6.1

TL;DR

Strapi v3.6.1 is a maintenance release that includes several bug fixes, enhancements, and translation updates. Key improvements include fixes for GraphQL queries, content-type builder relations, RBAC attribute visibility, and i18n plugin functionality. This release also addresses CLI termination issues on Windows and improves documentation with additional examples and typo corrections.

Highlight of the Release

• Fixed GraphQL queries to properly handle falsy values returned by controllers
• Fixed broken localizations query in GraphQL when using MongoDB
• Fixed issue with relations losing extra options in content-type builder
• Improved RBAC by ignoring only non-visible attributes instead of non-configurable ones
• Fixed CLI termination issues on Windows when using quickstart and no-run flags
• Added DKIM configuration example to documentation

Migration Guide

No specific migration steps are required for this release. This is a patch release (v3.6.0 to v3.6.1) that includes bug fixes and minor enhancements.

For general migration information, refer to the official Strapi migration guides.

Upgrade Recommendations

This is a recommended upgrade for all Strapi v3.6.0 users, especially those who:

1. Use GraphQL with MongoDB or rely on falsy values in GraphQL queries
2. Work with content-type relations and have experienced issues with extra options being lost
3. Use the i18n plugin with superAdmin roles
4. Deploy on Windows and use CLI with quickstart and no-run flags
5. Use RBAC with custom attribute configurations

The upgrade should be straightforward with minimal risk as this is a patch release focused on bug fixes.

Bug Fixes

GraphQL Improvements

• Fixed issue #10125 where GraphQL queries and mutations were not accepting falsy values returned by controllers
• Fixed broken localizations query in GraphQL when using MongoDB by adding _id to populate option

Content Type Builder

• Fixed issue where relations were losing extra options when updating content types in the content-type builder (Fixes #3409)

Core Framework

• Fixed RBAC attribute handling by ignoring only non-visible attributes instead of non-configurable ones
• Fixed CLI termination issues on Windows when using quickstart and no-run flags
• Fixed issue #10172 related to framework functionality

Plugins

• Fixed i18n plugin superAdminRole permissions by confirming superAdminRole exists when syncing permissions
• Fixed upload plugin CORS policy by removing cache key to ensure valid URLs

New Features

No significant new features were added in this release. This is primarily a maintenance release focused on bug fixes, enhancements to existing functionality, and translation updates.

Security Updates

No specific security fixes were mentioned in this release.

Performance Improvements

This release includes minor performance improvements:

• Improved CORS policy handling in the upload plugin by removing cache keys, ensuring URLs are valid for CORS policies
• Enhanced RBAC attribute handling by only ignoring non-visible attributes instead of non-configurable ones, which provides more accurate permission control

Impact Summary

Strapi v3.6.1 is a maintenance release that addresses several important bugs and provides quality-of-life improvements for developers. The most significant fixes include:

1. GraphQL improvements for handling falsy values and fixing MongoDB localizations queries
2. Content-type builder fixes for preserving relation options during updates
3. RBAC attribute visibility handling improvements
4. CLI termination fixes for Windows users
5. Upload plugin CORS policy improvements

The release also includes documentation enhancements with the addition of DKIM configuration examples and translation updates for Russian and French languages.

Overall, this release improves stability and fixes several pain points reported by the community without introducing breaking changes or requiring migration steps.

Full Release Notes