5.15.1

TL;DR

Strapi 5.15.1: Bug Fixes and Performance Improvements

This patch release focuses on fixing several critical bugs in the Content Manager and Upload plugin, while also delivering performance improvements for the Edit View. Key fixes address issues with relation loading in repeatable components, draft content visibility, timezone handling, and UI problems in the Dynamic Zone configuration. The update also includes security improvements with a nodemailer update and enhanced TypeScript support.

Highlight of the Release

• Fixed critical bug with one-to-many relations returning both published and draft versions
• Improved Edit View performance by preventing unnecessary rerenders
• Fixed UI issues in Dynamic Zone configuration when handling many elements
• Enhanced TypeScript support with exported configuration shared types
• Security update for nodemailer from 6.9.1 to 6.10.1

Migration Guide

No specific migration steps are required for this patch release. This is a drop-in replacement that fixes bugs and improves performance without introducing breaking changes.

To update to Strapi 5.15.1, you can use your package manager:

# Using npm
npm install @strapi/strapi@5.15.1

# Using yarn
yarn upgrade @strapi/strapi@5.15.1

# Using pnpm
pnpm update @strapi/strapi@5.15.1

Upgrade Recommendations

This patch release (5.15.1) is highly recommended for all Strapi 5.15.0 users as it fixes several important bugs:

• The fix for one-to-many relations returning both published and draft versions is particularly important for maintaining data integrity.
• UI improvements in the Content Manager will enhance the editing experience.
• Performance optimizations will benefit users working with complex content types.
• The security update to nodemailer addresses a known vulnerability.

There are no breaking changes in this release, making it a safe and straightforward upgrade from 5.15.0.

Bug Fixes

Content Manager Fixes

• Repeatable Components: Fixed issue where repeatable components were unnecessarily loading relations when creating a new entry (#22549).
• Dynamic Zone UI: Resolved UI issues that occurred when too many elements were present in Dynamic Zones in the Configure View interface.
• Field Dragging: Fixed a bug where dragging fields in the Configure View would move incorrect fields (#23602).
• Edit View Performance: Prevented unnecessary rerenders in the Edit View, improving overall performance (#23667).
• Blocks Editor: Added debounce to blocks editor updates to improve performance (#23681).

Relation and Data Handling

• One-to-Many Relations: Fixed critical issue where one-to-many relations were returning both published and draft versions of content (#23673).
• Default Timezone: Resolved issues related to default timezone handling that affected content releases (#23629).

Upload Plugin

• Tab Switching: Fixed an issue where switching tabs would cause problems when updating pagination in the Media Library.

New Features

Enhanced TypeScript Support

• Exported Configuration Shared Types: TypeScript definitions for configuration have been exported, making it easier for developers to create type-safe plugins and extensions (#22620).

Improved Developer Experience

• Overridable File Name Generation: The generateFileName function has been moved to the image-manipulation package, allowing developers to override this functionality for custom file naming strategies.

Security Updates

• Nodemailer Update: Updated nodemailer from version 6.9.1 to 6.10.1 to address security vulnerability referenced in GitHub advisory GHSA-9h6g-pr28-7cqp (#23678).

Performance Improvements

Edit View Optimizations

• Reduced Rerenders: The Edit View now prevents unnecessary rerenders, resulting in a smoother editing experience and better performance, especially when working with complex content types (#23667).

Blocks Editor Improvements

• Debounced Updates: Added debouncing to blocks editor updates, reducing the frequency of updates and improving performance when editing block content (#23681).

Impact Summary

Strapi 5.15.1 is a maintenance release that addresses several important bugs and performance issues. The most significant fixes include resolving problems with relation handling (preventing both draft and published versions from being returned in one-to-many relations) and fixing UI issues in the Content Manager's Dynamic Zone configuration.

Performance improvements focus on reducing unnecessary rerenders in the Edit View and optimizing the blocks editor with debounced updates, which will be particularly beneficial for content editors working with complex content types.

The release also includes a security update for nodemailer and improved TypeScript support through exported configuration shared types, enhancing the developer experience.

Overall, this is a quality-of-life update that improves stability and performance without introducing breaking changes, making it a recommended upgrade for all Strapi 5.15.0 users.

Full Release Notes