TL;DR
Strapi v5.12.5 brings several improvements including IPv6 support for absolute URLs, bug fixes for relation icons and schema validation optimization for MySQL/MariaDB, and dependency updates. This release enhances both functionality and performance while maintaining backward compatibility.
Highlight of the Release
- Added support for IPv6 addresses in absolute URLs
- Fixed relation icons shape in the relation modal
- Optimized schema validation lookup for MySQL/MariaDB databases
- Removed sdk-plugin dependencies from user dependencies
Migration Guide
No migration steps are required for this release. Strapi v5.12.5 is a maintenance release with bug fixes and enhancements that maintain backward compatibility with v5.12.4.
Upgrade Recommendations
This is a recommended upgrade for all Strapi users, especially for those:
- Running Strapi in IPv6 environments
- Using MySQL or MariaDB as their database
- Experiencing issues with relation icons in the content manager
The release contains important bug fixes and performance improvements without introducing breaking changes. You can upgrade directly from v5.12.4 or earlier v5.12.x versions without any special migration steps.
Bug Fixes
Relation Icons Shape Fix
Fixed an issue with relation icons shape in the relation modal (#22371). This visual bug affected how relationship icons were displayed in the content manager, potentially causing confusion when managing content relationships. The fix ensures proper visual representation of relation types.
Schema Validation Lookup Optimization
Optimized schema validation lookup for MySQL and MariaDB databases (#23331). This fix improves how Strapi performs schema validation operations, resulting in more efficient database queries and better overall performance when working with these database systems.
New Features
IPv6 Support for Absolute URLs
Strapi now properly supports IPv6 addresses in absolute URLs (#23212). This enhancement ensures that Strapi can correctly handle IPv6 formatted addresses when generating absolute URLs, making the CMS fully compatible with IPv6 network environments. This is particularly important as more organizations transition to IPv6 addressing schemes.
Homepage Widgets API (Future Feature)
Several commits indicate work on a new Homepage Widgets API (#23342, #23345, #23352) that will allow for more customizable dashboard experiences. While these appear to be preparatory changes for a future release, they lay the groundwork for extending Strapi's homepage functionality.
Security Updates
No specific security fixes were mentioned in this release. However, the dependency update to undici (from 6.21.1 to 7.4.0) may include security patches as part of the upgrade.
Performance Improvements
MySQL/MariaDB Schema Validation Optimization
The optimization of schema validation lookup for MySQL and MariaDB (#23331) provides a notable performance improvement. This change enhances how Strapi validates database schemas, reducing overhead and improving response times for operations that involve schema validation.
E2E Test Improvements
Several test-related improvements were made to enhance the development experience:
- Improved flakiness and performance of file reset in E2E tests (#23337)
- Enhanced initial server launch in watch mode for E2E tests (#23354)
These changes don't directly affect production performance but contribute to a more reliable and efficient development process.
Impact Summary
Strapi v5.12.5 is a maintenance release that focuses on bug fixes, performance improvements, and minor enhancements. The addition of IPv6 support for absolute URLs is particularly valuable for deployments in modern network environments. Performance optimizations for MySQL and MariaDB databases will benefit many users by improving schema validation operations.
The fix for relation icons improves the content management experience by ensuring proper visual representation of relationships. Additionally, the removal of sdk-plugin dependencies from user dependencies helps streamline the dependency management process.
This release maintains backward compatibility with previous v5.12.x versions and requires no special migration steps, making it a straightforward and recommended upgrade for all Strapi users.
Full Release Notes
5.12.5 (2025-04-16)
🔥 Bug fix
- relation icons shape in the relation modal (#22371)
- optimize schema validation lookup for mysql/mariadb (#23331)
⚙️ Chore
- remove sdk-plugin dependencies from user deps (#23250)
- release backmerge (670dd814bc)
- deps: bump undici in the npm_and_yarn group across 1 directory (#23133)
💅 Enhancement
- support for IPv6 addresses in absolute urls (#23212)
❤️ Thank You