Strapi Release: 5.3.0

TL;DR

Strapi v5.3.0 introduces significant enhancements to content preview with iframe support, integration between review workflows and content releases, and environment targeting for cloud deployments. This release also includes important bug fixes for content translation, review workflows data persistence, and database operations. TypeScript migration continues with media library components now fully typed.

This update focuses on improving content management workflows, especially for teams using review stages and preview functionality, while maintaining stability through targeted bug fixes.

Highlight of the Release

• Preview content in an iframe for better visualization of how content will appear on the frontend
• Integration between review workflows and content releases for more controlled publishing processes
• Cloud CLI deploy command now supports targeting specific environments
• Improved content-type field translations in List and Edit views
• Media library components migrated to TypeScript for better type safety

Migration Guide

Upgrading to v5.3.0

This release doesn't contain breaking changes that require specific migration steps. To upgrade:

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

   npm install [email protected] --save
   

   or

   yarn add [email protected]
   

2. If you're using the review workflows feature with content releases, be aware that there are now additional checks to ensure content has passed through required review stages before publishing.

3. If you've customized any media library components, note that these have been migrated to TypeScript, which might affect your custom code if it extends or modifies these components.

For a complete guide on updating Strapi, refer to the official update guide.

Upgrade Recommendations

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

• Use the content preview feature and want improved visualization through iframes
• Rely on review workflows and content releases for content governance
• Deploy to Strapi Cloud and need environment-specific deployments
• Work with multilingual content and need proper field translations

The upgrade should be straightforward with no breaking changes reported. As always, it's recommended to test the upgrade in a development or staging environment before applying it to production.

For users who have heavily customized the media library components, additional testing may be needed due to the TypeScript migration of these components.

Bug Fixes

Content Type Field Translation

Fixed an issue where content-type fields were not being properly translated in List and Edit views. This improves the user experience for multilingual teams by ensuring field labels appear in the user's selected language.

Review Workflow Data Persistence

Resolved an issue with review workflow data not being properly persisted, ensuring that workflow states and assignees are maintained correctly throughout the content lifecycle.

Database Operations

Fixed a concurrency issue when running discardDrafts operations, preventing potential race conditions and improving database stability.

E2E Test Improvements

Several fixes to E2E tests have been implemented, including enabling tests in editview.spec.ts and updating block tests, improving the reliability of the test suite.

New Features

Preview Content in an Iframe

Content can now be previewed in an iframe, providing a more accurate representation of how content will appear on the frontend. This enhancement improves the content editing experience by allowing editors to visualize their content in context before publishing.

Review Workflows Integration with Content Releases

Review workflows are now integrated with content releases, allowing teams to enforce required stages before content can be published. This feature enhances content governance by ensuring that content goes through the necessary approval processes before being released.

Environment Targeting for Cloud Deployments

The Strapi Cloud CLI now supports targeting specific environments when deploying. Developers can specify which environment to deploy to using the deploy command, providing more control over the deployment process.

Security Updates

No security fixes were explicitly mentioned in this release.

Performance Improvements

No specific performance improvements were highlighted in this release. The focus appears to be on new features, bug fixes, and TypeScript migrations rather than performance optimizations.

Impact Summary

Strapi v5.3.0 delivers significant improvements to content management workflows, particularly for teams using review processes and preview functionality. The integration between review workflows and content releases creates a more robust governance system, ensuring content meets quality standards before publication.

The addition of iframe-based content previews provides a more accurate representation of how content will appear on the frontend, helping content creators make better decisions during the editing process. This feature, combined with the ability to copy preview URLs, streamlines the review process.

For developers, the TypeScript migration of media library components improves type safety and developer experience, while the environment targeting capability in the Cloud CLI offers more deployment flexibility.

Bug fixes addressing content-type field translations, review workflow data persistence, and database operations contribute to a more stable and reliable platform. Overall, this release enhances both the content creation experience and the technical foundation of the CMS.

Full Release Notes