Strapi Release: 4.13.5

TL;DR

Strapi v4.13.5 addresses critical URL handling issues in the admin panel. This patch fixes problems with relative URLs and ensures proper fallback for the backend URL configuration, improving the reliability of admin panel operations especially in custom deployment environments.

Highlight of the Release

• Fixed relative URLs failing with appendSearchParamsToUrl function
• Added fallback to window.location.href when backendURL is not defined
• Implemented proper fallback mechanism for window.strapi.backendURL

Migration Guide

No specific migration steps are required for this patch release. Standard update procedures apply:

1. Update your package.json to reference the new version (v4.13.5)
2. Run npm install or yarn install to update dependencies
3. Restart your Strapi application

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

Upgrade Recommendations

This patch release (v4.13.5) is recommended for all Strapi users, especially those who:

• Use custom deployment configurations
• Have experienced issues with URL handling in the admin panel
• Rely on relative URLs in their Strapi implementation

As this is a patch release fixing critical URL handling bugs, upgrading should be straightforward with minimal risk of introducing new issues.

Bug Fixes

URL Handling Fixes

• Fixed an issue where relative URLs were failing when used with the appendSearchParamsToUrl function (#17967)
• Added a fallback to window.location.href when backendURL is not defined, ensuring the admin panel can still function properly (#17982)
• Implemented a proper fallback mechanism where window.strapi.backendURL is defined, preventing potential errors when the value is empty or undefined (#18028)

New Features

No new features were introduced in this patch release. This version focuses exclusively on bug fixes related to URL handling in the admin panel.

Security Updates

No security fixes were explicitly mentioned in this release. The changes were focused on functional bug fixes related to URL handling.

Performance Improvements

No specific performance improvements were included in this patch release. The focus was on fixing URL handling bugs in the admin panel.

Impact Summary

This release addresses several URL handling issues in the Strapi admin panel that could affect connectivity between the frontend and backend components. The fixes ensure proper fallback mechanisms are in place when backend URLs are not correctly defined or when using relative URLs.

The changes improve the robustness of Strapi deployments, particularly in custom hosting environments where URL configuration might be complex. By fixing these issues, the release enhances the reliability of the admin panel and prevents potential disconnections or errors during administrative operations.

While the changes are focused on bug fixes rather than new features, they represent important stability improvements for Strapi installations across various deployment scenarios.

Full Release Notes