Ghost Release: 5.57.1

TL;DR

Ghost v5.57.1 Patch Release

This patch release fixes a critical bug with custom routing for collections that was introduced in v5.57.0. The issue occurred when the NQL filter expansion was updated, which unintentionally broke custom routing collections functionality. This release reverts that change and restores proper custom routing behavior.

Highlight of the Release

• Fixed critical bug with custom routing for collections
• Restored proper functionality for sites using custom collection routes
• Addressed regression introduced in v5.57.0 related to NQL filter expansion

Migration Guide

No migration steps are required for this patch release. The update simply fixes the custom routing functionality without requiring any configuration changes or additional steps from users.

Upgrade Recommendations

This patch is highly recommended for all Ghost users who are currently on v5.57.0, especially those using custom routing with collections. The bug fix restores critical functionality for sites that rely on custom collection routes.

The update is a straightforward patch that fixes a regression without introducing any breaking changes, making it a safe and important upgrade for all affected installations.

Bug Fixes

Custom Routing Collections Fix

This release addresses a critical bug that broke custom routing with collections. The issue was introduced in v5.57.0 when the NQL filter expansion mechanism was updated. The change had an unintended side effect of breaking custom routing for collections.

The fix reverts the problematic change and restores the proper functionality of custom routing collections, ensuring that content is correctly displayed on custom routes as configured by site administrators.

New Features

No new features were added in this patch release. This update focuses exclusively on fixing the custom routing collections bug.

Security Updates

No security fixes were included in this patch release.

Performance Improvements

No specific performance improvements were included in this patch release. The focus was on fixing the critical custom routing bug.

Impact Summary

This patch release has a moderate impact on Ghost installations that use custom routing with collections. The fix restores expected behavior for custom routes that was broken in the previous release.

For sites that don't use custom routing with collections, the impact is minimal, but upgrading is still recommended to maintain compatibility with future updates.

The patch ensures that content organized in collections appears correctly on custom routes, which is essential for sites that have customized their URL structure beyond Ghost's defaults. Without this fix, some content might be inaccessible or appear in unexpected locations.

Full Release Notes