Strapi Release: 4.1.10-beta.0

TL;DR

Strapi v4.1.10-beta.0 introduces a new menu logo customization feature, allowing administrators to personalize their Strapi admin panel with a custom logo. This enhancement improves branding capabilities and user experience by providing options to upload logos from a computer or URL, with proper validation for file formats and dimensions.

Highlight of the Release

• New menu logo customization feature for Strapi admin panel
• Upload custom logos from computer or URL with validation for formats and dimensions
• New project settings API endpoints for managing logo customization
• Dedicated permissions system for project-level settings

Migration Guide

No migration is required for this feature. The menu logo customization is an optional feature that can be used by administrators through the admin panel interface.

Developers who want to programmatically interact with the logo customization feature can use the new project settings API endpoints:

• GET /project-settings - Retrieve current project settings including menu logo
• PUT /project-settings - Update project settings including menu logo

Upgrade Recommendations

This beta release introduces a new feature without breaking changes to existing functionality. It's recommended for:

• Users who want to test the new menu logo customization feature
• Developers building plugins or extensions that might interact with project settings
• Anyone interested in providing feedback on this new UI customization capability before its stable release

As this is a beta release (v4.1.10-beta.0), it's advisable to test in a non-production environment first.

Bug Fixes

No specific bug fixes were mentioned in the commit messages for this release.

New Features

Menu Logo Customization

• Custom Logo Upload: Administrators can now replace the default Strapi logo in the admin panel menu with their own custom logo
• Multiple Upload Methods:
  • Upload directly from computer with file format and size validation
  • Import logos from URL sources
• Logo Management:
  • Preview functionality before applying changes
  • Pending logo flow to review changes before confirming
  • Automatic cleanup of old logos when updating
• Project Settings API:
  • New /project-settings endpoints for managing logo configuration
  • Logo URL included in the /init route response

Permission System Updates

• Added dedicated permissions for project-level settings
• Separate read and update permissions for project settings management

Security Updates

No security fixes were mentioned in the commit messages for this release.

Performance Improvements

No specific performance improvements were highlighted in the commit messages for this release.

Impact Summary

This release enhances the branding capabilities of Strapi by allowing administrators to customize the menu logo in the admin panel. The feature is implemented with a comprehensive approach including:

1. A user-friendly interface for uploading and managing custom logos
2. Multiple upload methods (from computer or URL)
3. Validation for file formats and dimensions
4. A preview and confirmation workflow
5. Backend services for storing and serving the custom logos
6. A permissions system to control access to these settings

This improvement addresses the need for better white-labeling options in Strapi, particularly valuable for agencies and companies that want to maintain consistent branding across their admin interfaces. The implementation is non-disruptive to existing functionality while adding significant UI customization capabilities.

Full Release Notes