5.17.0-beta.0

TL;DR

Strapi 5.17.0-beta.0 introduces conditional fields, a powerful new feature that allows content creators to dynamically show or hide fields based on the values of other fields. This release enhances content modeling flexibility, improves the user interface with standardized menu items, and fixes several bugs including search field behavior and media library issues.

Highlight of the Release

• Introduction of conditional fields that can show/hide based on other field values
• Support for conditional fields in components and dynamic zones
• Improved UI with standardized menu items
• Fixed search field closing behavior
• Enhanced media library with improved CSS handling for image cropping

Migration Guide

Migrating to Conditional Fields

When implementing conditional fields in your existing content types, consider the following:

1. Review your content structure: Identify fields that would benefit from conditional visibility.

2. Plan your conditions carefully: Consider the logical relationships between fields before implementing conditions.

3. Testing: After implementing conditional fields, thoroughly test your content types to ensure:

   • Conditions work as expected
   • Validation behaves correctly for hidden fields
   • Relations function properly when fields are conditionally shown/hidden

4. Custom code considerations: If you have custom code that interacts with your content types:

   • Be aware that hidden fields will not be validated or included in API responses
   • Update any code that assumes all fields are always present

5. Components and Dynamic Zones: When using conditional fields with components or dynamic zones, test thoroughly as these have more complex behavior.

Upgrade Recommendations

This is a beta release (5.17.0-beta.0) that introduces significant new functionality with conditional fields. We recommend:

• Development environments: Feel free to upgrade and experiment with the new conditional fields feature.
• Testing environments: Upgrade and thoroughly test your specific use cases, especially if you plan to implement conditional fields.
• Production environments: Wait for the stable release before upgrading production instances.

When upgrading:

1. Follow the standard Strapi upgrade process
2. Test your application thoroughly, especially if you plan to implement conditional fields
3. Review the documentation on conditional fields to understand their capabilities and limitations

Bug Fixes

UI and Navigation Fixes

• Fixed an issue where the search field wasn't closing properly (#22415)
• Standardized menu items for improved consistency across the application (#23264)

Media Library Improvements

• Fixed CSS import for cropperjs by implementing it through styled components (#23707)

Conditional Fields Related Fixes

• Ensured hidden fields are not validated or passed through at any point
• Fixed saving relations on the fly when using conditional fields
• Properly handled conditional fields in components and dynamic zones
• Fixed display of hidden dynamic zones in history
• Ensured proper generation of conditions for relation fields in Content-Type Builder

New Features

Conditional Fields

The major feature of this release is the introduction of conditional fields in Strapi's Content-Type Builder and Content Manager. This powerful enhancement allows you to:

• Define conditions that determine when specific fields should be visible or hidden
• Create dynamic forms that adapt based on the values of other fields
• Support for conditional logic in regular fields, components, and dynamic zones
• Skip validation for fields that are hidden by conditions
• Properly handle relations in conditional fields

Content-Type Builder Enhancements

• Added UI for creating and managing field conditions
• Implemented confirmation dialog when setting up conditional fields
• Added support for displaying related field names in warning dialogs

Security Updates

No security fixes were mentioned in this release.

Performance Improvements

No specific performance improvements were highlighted in this release. The focus was primarily on introducing the new conditional fields feature and fixing various bugs.

Impact Summary

The introduction of conditional fields represents a significant enhancement to Strapi's content modeling capabilities. This feature allows for more dynamic and contextual content forms by showing or hiding fields based on the values of other fields.

For content creators, this means cleaner, more focused forms that only show relevant fields based on context. For developers and administrators, it provides powerful new tools for designing sophisticated content structures with conditional logic.

The implementation is comprehensive, supporting conditional fields not just for basic field types but also for components and dynamic zones. The system properly handles validation, ensuring that hidden fields are not validated or included in API responses.

Additional UI improvements like standardized menu items and fixes to the search field and media library enhance the overall user experience. These changes collectively make Strapi more intuitive and flexible for content management.

Full Release Notes