Strapi Release: 4.1.8

TL;DR

Strapi v4.1.8 brings performance improvements to the admin panel with faster Webpack builds, adds a new CLI command to opt out of telemetry, enhances security with better secret management in production, and fixes several bugs related to component fields and boolean rendering. The release also includes internationalization improvements with new language support.

Highlight of the Release

• Significant Webpack performance improvements for faster admin panel builds
• New CLI command to opt out of telemetry data collection
• Enhanced security with improved secret generation handling in production
• Fixed rendering of boolean fields in dynamic tables
• Added support for date fields as component main fields
• Added new language support: German, Kyrgyz, Tajik, and Sanskrit

Migration Guide

Upgrading to v4.1.8

This is a minor release with no breaking changes, so upgrading from v4.1.7 should be straightforward:

1. Update your package.json dependencies:

   npm install [email protected] --save
   # or
   yarn upgrade [email protected]
   

2. Secret Management Changes: If you're deploying to production, ensure that you have properly set the following environment variables rather than relying on auto-generation:

   • APP_KEYS
   • API_TOKEN_SALT
   • ADMIN_JWT_SECRET
   • JWT_SECRET

   The application will now show clearer error messages if these are missing in production.

3. If you've been experiencing issues with boolean fields in list views or date fields as component main fields, these should now be resolved after upgrading.

Upgrade Recommendations

This release is recommended for all Strapi users, especially for:

• Developers who want to benefit from faster admin panel builds
• Teams working with complex component structures who were experiencing error message issues
• Projects using boolean fields in list views
• Applications that need to use date fields as component main fields
• Developers who want to opt out of telemetry via CLI
• International teams who need German, Kyrgyz, Tajik, or Sanskrit language support

The upgrade process is straightforward with no breaking changes, making this a low-risk update that brings several quality-of-life improvements.

Bug Fixes

Content Manager Fixes

• Fixed rendering of boolean fields in dynamic tables, ensuring they display correctly in list views
• Fixed date unit tests to ensure consistent behavior across environments
• Fixed error messages in nested RepeatableComponent, improving the developer experience when working with complex component structures

Component Field Selection Improvements

• Disallowed password fields from being selected as component main fields for security reasons
• Fixed an issue where date fields couldn't be selected as component main fields

Upload Plugin Fixes

• Fixed an issue where actionOptions were not being properly considered by the upload provider
• Improved error handling in the upload process

New Features

New CLI Command for Telemetry Opt-Out

A new CLI command has been added that allows users to opt out of telemetry data collection directly from the command line. This provides a more convenient way for users who prefer not to share usage data with Strapi.

New Language Support

This release adds several new languages to the admin panel:

• Complete German translations
• Kyrgyz language support
• Tajik language support
• Sanskrit language support

Marketplace Offline Layout

A new offline layout has been added to the marketplace, improving the user experience when the application is not connected to the internet.

Security Updates

Improved Secret Management

This release harmonizes secret generation across the application and prevents automatic generation of secrets in production mode. This is an important security enhancement that:

1. Improves the handling of sensitive environment variables
2. Provides clearer error messages when required secrets are missing
3. Adds deprecation warnings for older environment variable patterns

Purest Package Upgrade

The users-permissions plugin now uses Purest v4.x, which includes security improvements for authentication providers.

Performance Improvements

Admin Panel Build Performance

The most notable performance improvement in this release is the significant speed-up of Webpack builds for the admin panel. This enhancement uses the ESBuild loader for compression, resulting in faster build times and improved developer experience when working with the Strapi admin panel.

Optimized Upload Stream Handling

The upload plugin has been refactored to improve the handling of upload streams, which should result in more efficient file uploads.

Impact Summary

Strapi v4.1.8 delivers notable performance improvements to the admin panel through Webpack optimizations, enhancing the development experience with faster builds. Security is strengthened with better secret management practices, particularly in production environments where auto-generation of secrets is now prevented.

The release addresses several UI and functionality issues, including fixes for boolean field rendering in dynamic tables and improved error handling in nested components. Developers gain a new CLI command to opt out of telemetry, providing more control over data sharing.

Internationalization receives significant attention with the addition of complete German translations and support for Kyrgyz, Tajik, and Sanskrit languages, making Strapi more accessible to global users.

Overall, this release focuses on performance, security, and quality-of-life improvements that benefit developers, administrators, and content editors without introducing breaking changes.

Full Release Notes