5.17.0

TL;DR

Strapi 5.17.0: Introducing Conditional Fields

Strapi 5.17.0 introduces conditional fields in the Content Manager, allowing content creators to dynamically show or hide fields based on specific conditions. This release also includes several UI improvements and bug fixes for the Media Library, locale selector, and user status display. The update enhances content modeling flexibility while improving the overall user experience.

Highlight of the Release

• Introduction of conditional fields in Content Manager allowing dynamic form behavior based on field values
• Improved Media Library with better fallbacks for documents and audio files
• Fixed folder creation in Media Library when pressing Enter key
• Added guided tour feature flag and metadata endpoint
• Fixed locale selector dropdown showing incorrect status

Migration Guide

Migrating to Conditional Fields

When implementing conditional fields in your content types:

1. Existing Content Types:

   • Adding conditions to existing fields won't affect your current data
   • Be careful when adding conditions to required fields, as they may still be required even when hidden

2. Validation Behavior:

   • Fields hidden by conditions will be skipped during validation
   • Hidden fields won't be included in the submitted data

3. Components and Dynamic Zones:

   • Conditional logic works with components and dynamic zones
   • When a parent field is hidden, all nested fields will also be hidden

4. Relations:

   • Relations in conditional fields are properly handled
   • Be aware that hiding relation fields may affect the display of related content

5. Content-Type Builder:

   • Conditions can be added through the Content-Type Builder interface
   • Consider the impact on existing content when adding conditions to fields

Upgrade Recommendations

This release introduces valuable new features and fixes several bugs, making it a recommended upgrade for most Strapi users.

Priority: Medium

• Content-heavy sites should prioritize this update to take advantage of conditional fields
• Sites with extensive media libraries will benefit from the Media Library improvements
• Standard upgrade procedures apply with no special considerations needed

To upgrade:

npm install strapi@5.17.0
# or
yarn upgrade strapi@5.17.0

After upgrading, test your conditional field configurations thoroughly if you plan to implement this feature.

Bug Fixes

UI and Design Fixes

• Fixed design issues with user status display for improved visibility
• Updated Strapi logo throughout the application
• Fixed locale selector dropdown showing incorrect status in Content Manager

Media Library Improvements

• Fixed issue where new folders weren't being created when hitting Enter key
• Implemented cleaner fallback displays for documents and audio files in the Media Library
• Improved handling of media previews

Technical Fixes

• Removed policy from license-limit-info that was breaking releases
• Fixed handling of hidden dynamic zones in history
• Ensured hidden fields are properly excluded from validation and submission

New Features

Conditional Fields

The major feature in this release is the introduction of conditional fields in the Content Manager. This powerful enhancement allows content creators to:

• Show or hide fields based on the values of other fields
• Create dynamic forms that adapt to the content being created
• Support for conditional logic in components and dynamic zones
• Skip validation for fields that are hidden by conditions
• Maintain proper handling of relations in conditional scenarios

Guided Tour

• Added a new admin endpoint to retrieve guided tour metadata
• Introduced a guided tour feature flag for enabling/disabling the functionality

Analytics Improvements

• Added tracking for widgets usage to better understand user behavior
• Implemented tracker for conditional field count

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 new features, UI enhancements, and bug fixes.

Impact Summary

Strapi 5.17.0 significantly enhances content modeling capabilities with the introduction of conditional fields, allowing for more dynamic and contextual content creation experiences. This feature enables content creators to build smarter forms that adapt based on user input, showing or hiding fields as needed.

The release also addresses several UI/UX pain points, particularly in the Media Library where folder creation now works properly with the Enter key and better fallbacks are provided for document and audio file previews. The fixed locale selector and improved user status design contribute to a more polished admin interface.

For developers, the conditional fields implementation extends to components and dynamic zones, with proper handling of validation and relations. The addition of guided tour functionality (behind a feature flag) sets the groundwork for improved onboarding experiences.

While this update doesn't include performance or security improvements, the feature enhancements and bug fixes make it a worthwhile upgrade for most Strapi installations, especially those with complex content modeling needs.

Full Release Notes