TL;DR
Strapi v5.0.0-rc.13 brings significant improvements to the internationalization (i18n) plugin with the ability to fill content from another locale, enhances template management with a new system, and improves compatibility with v4 data structures. This release also fixes several UI issues in the Content Manager and Content-Type Builder, adds support for loading local plugin admin files from the dist directory, and introduces document service query parameter validation. Additionally, it addresses issues with draft relations and unidirectional relations synchronization.
Highlight of the Release
- New feature to fill in content from another locale in the i18n plugin
- Improved templates system for create-strapi-app
- Enhanced compatibility with v4 data structures
- Support for loading local plugin admin files from dist directory
- Fixed issues with draft relations and unidirectional relations synchronization
Migration Guide
Document Service Query Parameter Validation
The document service now includes validation for query parameters, which is a breaking change. If you're using custom query parameters with the document service, you'll need to ensure they conform to the new validation requirements.
NoContent to EmptyStateLayout Replacement
A codemod has been added to replace NoContent with EmptyStateLayout. If your custom code uses the NoContent component, you should update it to use EmptyStateLayout instead:
// Before
import { NoContent } from '@strapi/helper-plugin';
// After
import { EmptyStateLayout } from '@strapi/design-system';
Local Plugin Admin Files
If you're developing local plugins, note that admin files are now loaded from the dist directory. Make sure your build process outputs to this location.
Upgrade Recommendations
This release is a release candidate (RC) for Strapi v5.0.0, specifically RC.13. As it's still a pre-release version, it's recommended for testing and development environments rather than production.
If you're already using v5.0.0-rc.12, upgrading to rc.13 is recommended to benefit from the bug fixes and new features, especially if you're experiencing any of the issues addressed in this release.
For those still on Strapi v4, this release continues to improve compatibility with v4 data structures, but as it's a major version change, a full migration plan should be prepared before upgrading production environments.
Bug Fixes
Content-Type Builder Issues
- Fixed invalid permission check in the Content-Type Builder configure view
- Resolved tab state management issues in the Content-Type Builder
UI and Visual Improvements
- Changed the color of draft tags for better visibility
- Fixed dropdown icons size in content releases
- Changed dialog buttons to have fullWidth for better usability
Data and Migration Issues
- Fixed an issue where draft relations were not being copied over when migrating to v5
- Fixed list view populated data not being properly managed
- Resolved an issue with self-referential relations by reproducing v4 behavior for data compatibility
Admin Path and Security
- Fixed admin path not being taken into account on build and security middleware
Package Version During Installation
- Fixed dynamic package.json import to get the correct package version during installation
New Features
Fill in Content from Another Locale
The i18n plugin now allows content editors to fill in content from another locale, making it easier to manage multilingual content. This feature helps streamline the workflow when creating content in multiple languages by allowing editors to use existing content as a starting point.
Loading Local Plugin Admin Files from Dist Directory
Strapi now supports loading local plugin admin files from the dist directory, which improves the plugin development experience and aligns with modern build practices.
New Templates System
A new templates system has been implemented in create-strapi-app, providing more flexibility and better organization for project templates.
Sync Unidirectional Relations
This release introduces synchronization for unidirectional relations, improving data consistency across the application.
Security Updates
No specific security fixes were mentioned in this release.
Performance Improvements
No specific performance improvements were highlighted in this release. The changes were primarily focused on new features, bug fixes, and compatibility improvements.
Impact Summary
Strapi v5.0.0-rc.13 delivers significant improvements for content editors working with multilingual content through the new "fill from another locale" feature in the i18n plugin. This streamlines the workflow for creating content in multiple languages by allowing editors to use existing content as a starting point.
For developers, the release enhances compatibility with v4 data structures and introduces document service query parameter validation, which may require code adjustments. The new templates system in create-strapi-app provides more flexibility for project setup, and support for loading local plugin admin files from the dist directory improves the plugin development experience.
Several UI improvements make the admin interface more user-friendly, including better dialog buttons, improved draft tag colors, and fixed dropdown icon sizes. Critical fixes for issues with draft relations during migration and unidirectional relations synchronization ensure data integrity when moving from v4 to v5.
As a release candidate, this version continues to refine Strapi v5 before its stable release, addressing key issues and adding features that improve the overall user experience for both content editors and developers.
