Strapi Release: 3.2.2

TL;DR

Strapi v3.2.2 is a maintenance release that includes several bug fixes and enhancements. Key improvements include fixes to database queries, Draft & Publish functionality, and permission conditions. The release also enhances the health check endpoint and refactors log level configuration for better usability.

Highlight of the Release

• Fixed Draft & Publish content population in both REST and GraphQL APIs
• Added support for GET requests to the /_health endpoint
• Fixed 'has same role as author' permission condition
• Refactored log level configuration for better usability
• Updated default favicon with the new Strapi logo

Migration Guide

Upgrading from v3.2.1 to v3.2.2

This is a patch release with no breaking changes. To upgrade:

1. Update your dependencies in package.json:

{
  "dependencies": {
    "strapi": "3.2.2",
    "strapi-admin": "3.2.2",
    "strapi-connector-bookshelf": "3.2.2",
    "strapi-plugin-content-manager": "3.2.2",
    "strapi-plugin-content-type-builder": "3.2.2",
    "strapi-plugin-email": "3.2.2",
    "strapi-plugin-upload": "3.2.2",
    "strapi-plugin-users-permissions": "3.2.2",
    "strapi-utils": "3.2.2"
  }
}

2. Run yarn install or npm install to install the updated packages.

3. Start your Strapi application with yarn develop or npm run develop.

For more detailed migration guides, refer to the official Strapi migration documentation.

Upgrade Recommendations

This release contains important bug fixes for database operations, Draft & Publish functionality, and permission conditions. If you're using these features, upgrading is highly recommended.

Priority: Medium

• If you're using Draft & Publish: High priority upgrade due to fixed population issues
• If you're using custom permissions with role conditions: High priority upgrade
• If you're using health checks for monitoring: Medium priority for improved compatibility

There are no breaking changes in this release, making it a safe upgrade from v3.2.1.

Bug Fixes

Database Fixes

• Fixed wrong query generation with Bookshelf that was causing incorrect SQL queries
• Added 'format' to the list of reserved model words to prevent naming conflicts
• Fixed an issue where IDs were being set to undefined in certain database operations
• Fixed Draft & Publish content population in both REST and GraphQL APIs

UI/UX Fixes

• Fixed UI glitch in the component picker
• Fixed incorrect notification when copying media URL to clipboard
• Fixed English copy of email-confirmation-redirection description

Permission Fixes

• Fixed "has same role as author" condition that wasn't working properly in content permissions

New Features

Events System

A new events system has been added to Strapi, allowing for better integration and extension capabilities. This feature enables developers to hook into various Strapi lifecycle events.

Updated Default Favicon

The default favicon has been updated with the new Strapi logo, providing a more modern look for new projects.

Security Updates

No specific security fixes were included in this release. However, the dependency update of axios from 0.19.2 to 0.20.0 may include security improvements from the axios project.

Performance Improvements

Log Level Configuration

The log level configuration system has been refactored to be more intuitive and provide better error messages when misconfigured. This improves the developer experience when debugging and monitoring Strapi applications.

Health Check Endpoint

The /_health endpoint now accepts GET requests in addition to HEAD requests, making it more compatible with various monitoring tools and services.

Impact Summary

Strapi v3.2.2 is primarily a maintenance release that addresses several important bugs and adds minor enhancements. The most significant fixes relate to database operations, particularly for Draft & Publish content population and permission conditions.

For developers, the improvements to the health check endpoint and log level configuration provide better tooling for monitoring and debugging Strapi applications. Content editors will benefit from fixed permission conditions and UI improvements.

This release also includes dependency updates, most notably upgrading axios from 0.19.2 to 0.20.0.

Overall, this is a recommended upgrade for all Strapi users, especially those using Draft & Publish functionality or custom permission conditions.

Full Release Notes