TL;DR
Strapi v4.1.2 introduces a new Usecase/Persona feature to better understand user needs, adds Mongolian locale support, and fixes several critical bugs related to file uploads, populate filtering, and GraphQL functionality. This maintenance release improves both the admin experience and developer workflow with important fixes for server restarting issues and custom webpack configurations.
Highlight of the Release
- New Usecase/Persona feature to better understand user needs during onboarding
- Added Mongolian locale support
- Fixed populate filtering for improved data querying
- Fixed issues with file uploads in GraphQL and direct entity uploads
- Improved server stability by fixing unnecessary restarts when modifying admin files
Migration Guide
No breaking changes were introduced in this release, so no migration steps are required when upgrading from v4.1.1 to v4.1.2.
For users upgrading from earlier versions, please refer to the official Strapi migration guides for detailed instructions.
Upgrade Recommendations
This release contains important bug fixes and enhancements that improve the stability and functionality of Strapi. It is recommended for all users to upgrade to v4.1.2, especially if you:
- Use GraphQL for file uploads
- Work with populate filtering
- Experience issues with server restarts during development
- Need Mongolian language support
- Upload files directly to entities
To upgrade, run one of the following commands depending on your package manager:
npm install [email protected] --save
# or
yarn upgrade [email protected]
Bug Fixes
Core Fixes
- Fixed populate filtering issues that affected data querying
- Fixed server restarting unnecessarily when modifying admin files, improving developer workflow
- Fixed issues with uploading files directly to entities
GraphQL Plugin Fixes
- Fixed uploading of non-image files through GraphQL
- Fixed date field handling in GraphQL to properly maintain date values as strings
i18n Plugin Fixes
- Fixed populate nested images for getNonLocalisedFields, ensuring proper image handling in localized content
Tooling Fixes
- Fixed webpack devServer configuration merging, now properly combining custom configurations with defaults
New Features
Usecase/Persona Feature
A new onboarding feature has been added to collect information about how users intend to use Strapi. This helps Strapi better understand user needs and improve the product accordingly. The feature appears after registration and allows users to provide details about their use case and persona.
Registration Checkbox
Enhanced registration flow with a checkbox option, improving the user onboarding experience.
Mongolian Locale
Added support for the Mongolian language, expanding Strapi's internationalization capabilities and making it more accessible to Mongolian-speaking users.
Security Updates
No specific security fixes were included in this release.
Performance Improvements
Server Performance
- Reduced unnecessary server restarts when modifying admin files, leading to a smoother development experience and faster workflow
Data Handling
- Improved populate filtering mechanism, enhancing query performance and data retrieval capabilities
Impact Summary
Strapi v4.1.2 is a maintenance release that focuses on enhancing the user experience and fixing critical bugs. The new Usecase/Persona feature provides valuable insights into how users are utilizing Strapi, which will help guide future development priorities.
Several important fixes address issues with file uploads, populate filtering, and GraphQL functionality, making the platform more stable and reliable. The addition of Mongolian locale support expands Strapi's accessibility to more users worldwide.
Developer experience improvements include fixing server restart issues when modifying admin files and properly merging custom webpack configurations, resulting in a smoother development workflow.
Overall, this release improves both the admin experience and developer workflow with targeted enhancements and bug fixes that address specific pain points reported by the community.
Full Release Notes
💅 Enhancement
🔥 Bug fix
📚 Migration guides can be found here 📚