Strapi Release: 3.0.6

TL;DR

Strapi v3.0.6 brings numerous enhancements and bug fixes across the platform. Key improvements include Ukrainian translations, filtering capabilities for search routes, Apollo Federation support for GraphQL, and fixes for the Media Library. This release also addresses documentation issues, improves error handling, and enhances plugin functionality. The update focuses on improving developer experience and fixing various UI and functionality issues.

Highlight of the Release

• Added Ukrainian translations across the entire platform
• Enhanced search routes with filtering capabilities
• Added Apollo Federation support for GraphQL plugin
• Fixed Media Library upload issues and file handling
• Improved environment variable support with early dotenv loading
• Fixed MongoDB queries for dynamic zones

Migration Guide

No breaking changes were introduced in this release, so migration from v3.0.5 to v3.0.6 should be straightforward.

To upgrade:

1. Update your Strapi version in your package.json:

   "dependencies": {
     "strapi": "3.0.6",
     "strapi-admin": "3.0.6",
     "strapi-connector-bookshelf": "3.0.6",
     "strapi-plugin-content-manager": "3.0.6",
     "strapi-plugin-content-type-builder": "3.0.6",
     "strapi-plugin-email": "3.0.6",
     "strapi-plugin-graphql": "3.0.6",
     "strapi-plugin-upload": "3.0.6",
     "strapi-plugin-users-permissions": "3.0.6",
     "strapi-utils": "3.0.6"
   }
   

2. Run the installation command for your package manager:

   • For npm: npm install
   • For yarn: yarn install

3. Restart your Strapi application.

If you're using the GraphQL plugin with Apollo Federation, you may want to review the updated documentation to take advantage of the new federation capabilities.

Upgrade Recommendations

This release contains numerous bug fixes and enhancements that improve the overall stability and functionality of Strapi. It's recommended for all users to upgrade to v3.0.6, especially if you:

• Use the Media Library extensively
• Work with GraphQL
• Have a multilingual user base (particularly Ukrainian speakers)
• Use MongoDB with dynamic zones
• Need improved search functionality with filtering

The upgrade process is straightforward with no breaking changes, making this a low-risk update that brings valuable improvements across the platform.

Bug Fixes

Media Library Fixes

• Fixed issues with file uploads in the Media Library
• Improved file name handling for original files and generated media (thumbnails and resized images)
• Fixed hash generation based on file names
• Fixed selected files handling in the media library modal

GraphQL Plugin Fixes

• Fixed GraphQL fields not being required during creation when model attributes have default values
• Made JWT not required for register mutation, improving authentication flow

UI and Display Fixes

• Fixed missing images on index.html
• Fixed wrong flag display for Swedish language
• Fixed broken link in plugin installation popup
• Fixed all lowercase action name in users-permissions plugin

Database and Query Fixes

• Updated mount-models.js to check if dynamic zone fields exist in returned MongoDB objects
• Added more reserved words to the database handling list
• Fixed search for numbers in MongoDB versions earlier than 4.2.0

Other Fixes

• Fixed malformed JSON in email plugin
• Fixed Cloudinary upload error messages

New Features

Added Ukrainian Translations

Complete Ukrainian language support has been added throughout the Strapi admin interface, making the platform more accessible to Ukrainian-speaking users.

Enhanced Search Routes with Filtering

The search functionality now supports filtering, allowing for more precise and targeted search queries across your content.

Apollo Federation Support for GraphQL

The GraphQL plugin now supports Apollo Federation, enabling Strapi to act as an implementing service within a federated GraphQL architecture. This allows for better integration with other services in a microservices environment.

Environment Variable Customization

• Added STRAPI_UUID_PREFIX environment variable support
• Added environment variables to control startup message display
• Improved dotenv library loading at application start, allowing for earlier access to environment variables

Custom User Population

Added support for custom populate options in ctx.state.user, giving developers more flexibility when working with user data in custom controllers and services.

Security Updates

No specific security fixes were mentioned in this release. However, the improvements to the authentication flow in the GraphQL plugin (making JWT not required for register mutation) and the enhanced user data handling with custom populate options contribute to a more secure and flexible authentication system.

Performance Improvements

Optimized Media Library

The fixes to the Media Library upload process and file handling improve the overall performance and reliability of media asset management.

Improved Database Queries

The fix for MongoDB queries with dynamic zones and the improved search functionality for MongoDB versions earlier than 4.2.0 enhance database performance and reliability.

Early Environment Variable Loading

Loading the dotenv library at application start improves initialization performance and allows for earlier access to configuration settings.

Impact Summary

Strapi v3.0.6 is a maintenance release that brings significant quality-of-life improvements across the platform. The addition of Ukrainian translations enhances accessibility for international users, while the improved search functionality with filtering capabilities provides more powerful content management tools.

Developers will benefit from the Apollo Federation support in the GraphQL plugin, enabling better integration in microservices architectures. The fixes to Media Library uploads and file handling address important usability issues that content managers may have encountered.

The improvements to environment variable handling, including early dotenv loading and the ability to hide startup messages, give administrators more control over their Strapi instances. Database-related fixes, particularly for MongoDB users working with dynamic zones, enhance the reliability of content storage and retrieval.

Overall, this release focuses on stability, usability, and extending the platform's capabilities without introducing breaking changes, making it a recommended upgrade for all Strapi users.

Full Release Notes