Strapi Release: 4.7.1

TL;DR

Strapi v4.7.1 is a maintenance release that fixes critical issues with user creation due to license seat validation, improves performance for private attribute checking, and fixes database configuration generation for PostgreSQL. It also includes documentation improvements for package installation and Chinese (Simplified) translation updates.

Highlight of the Release

• Fixed critical issue with license seat validation that was blocking user creation
• Improved performance for private attribute checking
• Fixed PostgreSQL port configuration in generated database.js (now uses 5432 instead of 3306)
• Enhanced documentation for package installation with Lerna
• Updated Simplified Chinese (zh-Hans) translations

Migration Guide

No specific migration steps are required for this patch release. This is a drop-in replacement that fixes bugs and improves performance.

For general update guidance, refer to the official update guide.

Upgrade Recommendations

This release fixes critical issues with user creation and database configuration. Immediate upgrade is recommended for all Strapi users, especially for:

• Users who are experiencing issues creating new admin users
• Developers working with PostgreSQL databases
• Projects that heavily utilize private attributes

To upgrade from v4.7.0 to v4.7.1:

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

After upgrading, restart your Strapi application.

Bug Fixes

Critical Fixes

• Fixed an issue where undefined license seats were incorrectly blocking user creation (#15962)
• Fixed PostgreSQL port configuration in database.js generation - now correctly uses port 5432 instead of MySQL's 3306 port (#15941)
• Fixed a typo when returning component categories in the Content Manager (#15958)
• Added optional chaining on isPrivateAttribute to prevent potential errors (#15950)

New Features

No new features were introduced in this maintenance release. This is primarily a bug fix and performance improvement release.

Security Updates

No specific security fixes were included in this release.

Performance Improvements

Performance Enhancements

• Improved performance for private attribute checking by using optional chaining and making the code more efficient (#15950)
• Enhanced sanitization performance for password removal

Impact Summary

This patch release addresses several important issues that could impact day-to-day operations of Strapi instances. The fix for license seat validation is particularly important as it resolves a critical issue that was preventing user creation in some environments.

The PostgreSQL port configuration fix ensures that developers using PostgreSQL will have the correct default port (5432) when generating database configurations, preventing connection issues.

Performance improvements for private attribute checking will benefit all users, particularly those with complex content types that use many private attributes.

Documentation improvements and translation updates enhance the overall developer experience, especially for those working with monorepo setups using Lerna and Chinese-speaking users.

Overall, this is an important maintenance release that all Strapi users should apply to ensure smooth operation of their CMS.

Full Release Notes