Strapi Release: 5.8.1

TL;DR

Strapi v5.8.1 is a maintenance release that fixes several important bugs, including issues with dynamic zones, internationalization, and data transfers. It also includes improvements to telemetry, dependency updates, and CI/CD workflows. This release focuses on stability and quality-of-life improvements for developers working with complex content structures.

Highlight of the Release

• Fixed critical bug where adding components to dynamic zones would overwrite existing data
• Fixed internationalization issue allowing unique + unlocalized fields on i18n content types
• Improved data transfers by disabling lifecycle hooks
• Enhanced telemetry with smoother event rate limiting

Migration Guide

No migration steps are required for this patch release. You can upgrade directly from v5.8.0 to v5.8.1 without any additional configuration changes.

Upgrade Recommendations

This release contains important bug fixes for dynamic zones, internationalization, and data transfers. We recommend all users upgrade to v5.8.1, especially if you:

• Use dynamic zones in your content types
• Work with internationalized content types that have unique fields
• Perform data transfers between environments

To upgrade, run:

npm install [email protected]

or

yarn upgrade [email protected]

Bug Fixes

• Dynamic Zone Components: Fixed critical issue where adding a component to a dynamic zone would overwrite existing data (#22656)

  • Fixed component positioning when adding to dynamic zones
  • Improved dynamic zone component menu alignment
  • Fixed theme values for padding and styling

• Internationalization: Fixed issue to allow unique + unlocalized fields on internationalized content types (#22634)

• Data Transfers: Disabled lifecycle hooks during transfers to prevent unexpected side effects (#22651)

New Features

This release doesn't introduce major new features but includes several enhancements:

• Improved GitHub Bug Report Template: Switched to the new GitHub bug report template system for better issue reporting and tracking.
• Enhanced CI/CD Workflows: Added new release workflow and updated prepublish release script to use nx.
• Smoother Telemetry: Rate limited events now reset 24 hours after the last event (or process start), instead of each day at midnight, providing a smoother distribution of telemetry events.

Security Updates

No specific security fixes were included in this release.

Performance Improvements

• Telemetry Optimization: Improved telemetry event rate limiting by changing the reset period from daily at midnight to 24 hours after the last event or process start. This change smooths the sending of events and prevents bursts of events hitting the telemetry server at midnight, resulting in more consistent server performance and more evenly distributed telemetry data collection.

Impact Summary

Strapi v5.8.1 is primarily a bug fix release that addresses several important issues affecting content management and data integrity. The most significant fix resolves a problem where adding components to dynamic zones would overwrite existing data, which could lead to content loss. This is particularly important for content editors working with complex content structures.

The release also improves internationalization support by allowing unique and unlocalized fields on internationalized content types, enhances data transfers by disabling lifecycle hooks to prevent unexpected side effects, and optimizes telemetry with smoother event rate limiting.

While this is a patch release without breaking changes, the fixes for dynamic zones and internationalization make it an important update for most Strapi users, especially those with complex content modeling needs.

Full Release Notes