Strapi Release: 3.0.0-beta.16.2

TL;DR

Strapi v3.0.0-beta.16.2 brings important fixes and enhancements to the headless CMS. This release fixes a critical issue with multi-image uploads that was causing old relations to be deleted, adds support for MongoDB 4.0.x with Mongoose 5.7.0, and includes documentation improvements. The authentication system has been moved to the strapi-admin package for better organization and maintainability.

Highlight of the Release

• Fixed critical issue with multi-image uploads that was deleting old relations
• Added support for MongoDB 4.0.x with Mongoose 5.7.0
• Moved authentication system to strapi-admin package
• Improved documentation with fixed typos and updated quickstart guide

Migration Guide

Authentication System Changes

If you've built custom extensions or modifications to the authentication system, you'll need to update your code to work with the new structure where authentication has been moved to the strapi-admin package.

MongoDB Connection Settings

If you're using MongoDB 4.0.x, you can now add the useUnifiedTopology option to your database.json configuration file to prevent deprecation warnings:

{
  "defaultConnection": "default",
  "connections": {
    "default": {
      "connector": "mongoose",
      "settings": {
        "database": "your-database",
        "host": "localhost",
        "port": 27017,
        "username": "",
        "password": "",
        "useUnifiedTopology": true
      },
      "options": {
        "ssl": false
      }
    }
  }
}

Upgrade Recommendations

This release contains important bug fixes and enhancements, particularly for users working with multi-image uploads and MongoDB 4.0.x.

If you're experiencing issues with image uploads or are using MongoDB 4.0.x, upgrading to this version is highly recommended. The authentication system refactoring is mostly internal, but if you've built custom extensions to the authentication system, you should test thoroughly after upgrading.

For most users, this is a safe upgrade that resolves several important issues without introducing breaking changes.

Bug Fixes

Multi-image Upload Fix

Fixed a critical issue where uploading multiple images was incorrectly deleting old relations. This ensures that when you upload new images to a field that already contains images, the existing images are preserved correctly.

WYSIWYG Preview Fix

Resolved an issue with the WYSIWYG editor preview functionality.

Admin Rerender Issue

Fixed a rerendering issue in the admin interface that was causing performance problems.

New Features

MongoDB 4.0.x Support

Added support for MongoDB 4.0.x using Mongoose 5.7.0. This includes a new connection setting useUnifiedTopology that can be configured via the database.json file in your Strapi project. By default, it's set to false.

Authentication System Refactoring

The authentication system has been moved to the strapi-admin package for better organization and maintainability. This includes:

• Migration of Logout component to functional component
• Removal of SCSS in favor of styled components
• Moving authentication translations to the admin package
• Creation of PageTitle components
• Refactoring of forms and creation of form utilities

Security Updates

No specific security fixes were mentioned in this release.

Performance Improvements

Admin Interface Optimizations

Several performance improvements have been made to the admin interface:

• Implemented global single request pattern to reduce API calls
• Removed unnecessary data hooks (willSecure and didGetSecured)
• Optimized component rendering to prevent excessive rerenders

Impact Summary

This release focuses on fixing critical issues and enhancing MongoDB support. The most significant impact is for users who work with multi-image uploads, as the fix prevents the unintended deletion of existing image relations when uploading new ones.

MongoDB users will benefit from proper support for version 4.0.x with the addition of the useUnifiedTopology configuration option, eliminating deprecation warnings.

The authentication system refactoring is a substantial internal change that improves code organization by moving authentication to the strapi-admin package, but this should be mostly transparent to end users unless they've built custom authentication extensions.

Documentation improvements, including an updated quickstart guide with new video content, will help new users get started more easily with Strapi.

Overall, this is a maintenance release that addresses specific issues while continuing to refine the codebase as Strapi moves toward a stable release.

Full Release Notes