Strapi Release: 5.0.0-beta.4

TL;DR

Strapi v5.0.0-beta.4 Release

This beta release brings significant architectural changes, moving the Review Workflows feature to a plugin structure, refactoring UI components to v2 standards, and improving SSO authentication routes. The release also introduces a breaking change in the API response status code for entity creation (now 201 instead of 200), enhances license checking for the history feature, and includes various bug fixes for SSO, draft relations, and typings. Documentation improvements for contributors and type systems are also included.

Highlight of the Release

• Review Workflows feature moved to plugin architecture
• Breaking change: API create operations now return 201 status code (was 200)
• Fixed SSO authentication route ordering
• Added history license check
• Refactored LinkButton components to use v2 standards

Migration Guide

Breaking Changes Migration

API Status Code Change

The API now returns a 201 status code for entity creation operations instead of the previous 200 status code. This change aligns with REST API standards where resource creation should return 201.

Required Action: Update any client code that specifically checks for a 200 status code on entity creation to now expect 201.

Review Workflows as Plugin

If you were using Review Workflows functionality, it has been moved to a plugin architecture.

Required Action: No immediate action is required for existing installations, but be aware of the architectural change if you're extending or customizing Review Workflows functionality.

Upgrade Recommendations

As this is a beta release (v5.0.0-beta.4), it's recommended for testing and development environments only. Production environments should continue using stable releases.

For developers testing the v5 beta:

• Upgrade from v5.0.0-beta.3 to v5.0.0-beta.4 to test the latest features and fixes
• Pay special attention to the breaking change in API status codes for entity creation
• Test SSO functionality if you're using it, as route ordering has been fixed
• If using Review Workflows, test thoroughly as it's been moved to a plugin architecture

To upgrade:

npm install [email protected]

or

yarn add [email protected]

Bug Fixes

SSO Authentication Fixes

• Fixed SSO login by switching the order of authentication routes (#20090)
• Fixed RBAC issue by using the correct property name in useRBAC hook (#20105)

UI and Component Fixes

• Fixed link dependency coming from react-router-dom
• Adjusted new links to link button component
• Fixed prop handling by using forwardedAs instead of as prop
• Fixed release of invalid versions

API and Data Fixes

• Fixed number of draft relations in API tests (#20101)
• Fixed typings in various components
• Fixed Content Manager updates when fields are updated

New Features

Review Workflows as a Plugin

The Review Workflows feature has been moved to a plugin architecture (#19937). This significant architectural change includes:

• Complete refactoring of the Review Workflows frontend
• Implementation of dedicated middlewares
• Support for document ID and locale for entity assignee and stage
• Fixed stage permissions
• End-to-end tests for the new plugin structure

History License Check

Added license checking for the history feature (#20099), ensuring proper license validation when using history-related functionality. This enhancement includes adding history to default license data.

Security Updates

No specific security fixes were included in this release.

Performance Improvements

Code Organization and Structure

• Separated documentation and entries logic for better code organization
• Extended entries code with improved structure (#20060)
• Removed pack-up from monorepo (#20092) to streamline dependencies

Impact Summary

This beta release represents continued progress toward Strapi v5, with significant architectural changes and enhancements. The move of Review Workflows to a plugin structure improves modularity and maintainability. The breaking change to API status codes (201 for creation) aligns Strapi with REST standards but requires client-side adjustments. SSO authentication fixes improve reliability for enterprise users. UI component refactoring to v2 standards continues the modernization of Strapi's interface. This release maintains backward compatibility except for the noted status code change, making it a relatively smooth upgrade for beta testers while bringing valuable improvements to the platform's architecture and functionality.

Full Release Notes