Strapi Release: 4.7.0

TL;DR

Strapi v4.7.0 introduces a major new feature: Data Transfer Capabilities, allowing users to transfer content between Strapi instances. The release also adds admin seat enforcement for Enterprise Edition, a new cloud section on the homepage, and documentation for relations reordering. Bug fixes include improvements to audit logs, media attribute validation, and various translation updates.

This release enhances Strapi's data management capabilities while improving the admin experience with better UI elements and enterprise features.

Highlight of the Release

• Introduction of Data Transfer Capabilities for moving content between Strapi instances
• Enterprise Edition admin seat enforcement implementation
• New cloud section added to the homepage
• Improved audit logs with better user identification
• Enhanced media attribute validation
• Documentation for relations reordering

Migration Guide

This release doesn't require specific migration steps for most users. However, if you plan to use the new Data Transfer features, you should be aware of the following:

1. Transfer Token Salt: To use transfer tokens, you need to set a transfer token salt in your environment variables:

   TRANSFER_TOKEN_SALT=your_secure_salt_here
   

2. Enterprise Edition Users: If you're using Enterprise Edition, be aware that admin seat enforcement is now active. Review your current admin user count against your license limits.

3. API Changes: If you've built custom code that interacts with media validation, review the changes to media attribute validation to ensure compatibility.

For a complete guide on updating Strapi, refer to the official update guide.

Upgrade Recommendations

Recommended for all users

This release introduces valuable new features like Data Transfer Capabilities and important bug fixes without breaking changes to the core API. The upgrade process should be straightforward for most users.

Upgrade Steps:

1. Back up your database and project files
2. Update your dependencies in package.json:

   "strapi": "^4.7.0",
   "@strapi/admin": "^4.7.0",
   "@strapi/plugin-*": "^4.7.0"
   

3. Run npm install or yarn install to update packages
4. Start your application with npm run develop or yarn develop

Enterprise Edition users should pay special attention to the new admin seat enforcement feature and review their current admin user count against their license limits.

For users planning to use the new Data Transfer features, ensure you set up the required environment variables, particularly TRANSFER_TOKEN_SALT.

Bug Fixes

• Audit Logs Improvement: Fixed audit logs to properly display username or email instead of user ID, making logs more readable and useful
• Media Attribute Validation: Added proper validation for required media fields in the API, ensuring that required repeatable media fields have at least one element
• Translation Issues: Fixed various translation issues and removed unused translation files
• Transaction Handling: Improved handling of database transactions during data transfers to prevent data corruption
• Error Handling: Enhanced error handling during transfers, including proper closing of transactions on failed transfers
• Token Authentication: Fixed issues with token salt generation and validation

New Features

Data Transfer Capabilities

Strapi v4.7.0 introduces a comprehensive Data Transfer system that allows users to transfer content between Strapi instances. This feature includes:

• Transfer Tokens: A new type of authentication token specifically designed for data transfers
• Transfer API: Backend services to handle the transfer of content, media, and configurations
• Progress Tracking: Real-time progress monitoring during transfers
• Batched Asset Transfer: Optimized transfer of media assets in batches for better performance
• CLI Support: Enhanced command-line interface for executing transfers with progress indicators

Enterprise Edition Admin Seat Enforcement

For Enterprise Edition customers, this release adds enforcement of admin seat limits:

• Visibility into current seat usage and limits
• Restrictions on creating new admin users when the seat limit is reached
• User interface elements showing license information and limitations

Security Updates

Security Improvements

• Transfer Token System: The new transfer token system provides a dedicated authentication mechanism for data transfers with specific permissions
• Token Salt Validation: Added validation to ensure transfer tokens have proper salt configuration, preventing security issues
• Warning Mechanism: The system now emits warnings when transfer features are enabled but salt configuration is missing
• Permission Enforcement: Enhanced permission checks for data transfer operations

Performance Improvements

• Batched Asset Transfer: The new Data Transfer system implements batching for asset transfers, significantly improving performance when transferring large media libraries
• Optimized Database Operations: Transactions are now properly managed during transfers to ensure data integrity while maintaining performance
• Streaming Improvements: Assets are now streamed in chunks based on byte size rather than individual files, providing better network utilization
• User List Management: Improved the way user lists are fetched and refreshed in the admin panel, reducing unnecessary API calls

Impact Summary

Strapi v4.7.0 delivers significant enhancements to the platform's data management capabilities with the introduction of Data Transfer features. This major addition allows administrators and developers to seamlessly transfer content, media, and configurations between Strapi instances, addressing a long-standing need for better migration tools.

Enterprise Edition customers will notice the implementation of admin seat enforcement, providing clearer visibility into license usage and limitations. This change improves license compliance while offering a better user experience through informative UI elements.

The release also brings quality-of-life improvements like a new cloud section on the homepage, better audit logs with improved user identification, and enhanced media validation. Developers will appreciate the new documentation on relations reordering, providing clarity on a previously underdocumented feature.

Performance improvements in asset handling and database operations make this release particularly valuable for projects with large media libraries or complex content structures. The batched asset transfer system significantly improves efficiency when moving content between environments.

Overall, this release strengthens Strapi's position as a flexible and powerful headless CMS while addressing important operational needs for content migration and enterprise license management.

Full Release Notes