Strapi Release: 4.20.3

TL;DR

Strapi v4.20.3: Bug Fixes and Content Release Enhancements

This minor release focuses on fixing critical issues with data transfer operations and the i18n plugin while introducing significant enhancements to the Content Releases feature. Key improvements include fixing asset transfer issues, adding support for scheduled releases with timezone selection, and implementing release webhooks. This update is particularly valuable for teams using data transfer functionality, content managers working with scheduled publishing, and developers integrating with external systems via webhooks.

Highlight of the Release

• Fixed critical issue with data transfer operations getting stuck during asset transfers
• Added ability to schedule content releases with timezone support
• Implemented publish webhooks for content releases
• Fixed i18n locale validation to only occur during creation operations
• Added sizeInBytes support for upload providers

Migration Guide

No specific migration steps are required for this update. This is a minor release with bug fixes and feature enhancements that should not break existing functionality.

For general update guidance:

• Follow the standard update procedure by updating your package.json and running npm install or yarn install
• Test your application thoroughly after updating, especially if you rely on data transfer functionality or the i18n plugin

Upgrade Recommendations

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

• Use data transfer functionality between environments
• Work with internationalization features
• Need to schedule content releases
• Use custom upload providers

The bug fixes for data transfer operations and i18n locale validation address important issues that could impact your workflow. Additionally, the new content release scheduling features provide valuable functionality for content management.

To upgrade:

npm install [email protected]
# or
yarn add [email protected]

Bug Fixes

Data Transfer Fixes

• Fixed critical issue where asset transfers would get stuck or skip the assets step entirely
• Improved error handling when an asset transfer fails
• Added support for using mainHash for compatibility with older versions
• Refactored code to batch assets only once during transfer operations

i18n Plugin Fix

• Fixed locale validation to only occur during creation operations, preventing unnecessary validation errors

UI Improvements

• Fixed timezone formatting (using underscore instead of hyphen)
• Adjusted scheduled checkbox width for better display
• Various UI detail improvements for the content releases feature

New Features

Content Release Scheduling

• Added the ability to schedule content releases for future publication
• Implemented timezone selection for scheduled releases
• Added UI to display scheduled release dates
• Ensured proper timezone handling, including DST considerations

Content Release Webhooks

• Added publish webhooks for content releases
• Improved integration capabilities with external systems

Telemetry Improvements

• Added telemetry events for SSO usage
• Implemented usage data tracking for Audit Logs
• Added usage data collection for Releases feature

Security Updates

No significant security fixes were included in this release.

Performance Improvements

Telemetry Optimizations

• Optimized SSO events to reduce overhead
• Removed await on sending telemetry information to prevent slowing down server operations
• Improved data collection efficiency by sending information without waiting for CRON jobs

Impact Summary

This release primarily impacts three key areas of Strapi:

1. Data Transfer Reliability: The fixes to asset transfer operations resolve critical issues where transfers would get stuck or skip assets entirely. This significantly improves the reliability of moving content between environments, which is essential for deployment workflows.

2. Content Release Management: The addition of scheduling capabilities with timezone support enhances content planning and publishing workflows. Content teams can now prepare releases ahead of time and have them automatically publish at specified dates and times.

3. Integration Capabilities: The new webhook support for content releases enables better integration with external systems, allowing automated workflows when content is published.

The i18n plugin fix also removes a friction point for developers working with localized content by ensuring locale validation only happens during creation operations.

Overall, this release improves stability, adds useful features for content management, and enhances the developer experience without introducing breaking changes.

Full Release Notes