Ghost Release: 5.22.2

TL;DR

Ghost v5.22.2 brings critical fixes for tier descriptions and event verification

This minor patch release addresses two important bugs in Ghost CMS: fixing the inability to set tier descriptions and resolving an issue with verification trigger usage in the Event Repository. These fixes ensure proper functionality for membership tiers and event handling, particularly important for sites using Ghost's membership and subscription features.

Highlight of the Release

• Fixed issue preventing tier descriptions from being set
• Resolved verification trigger usage problem with Event Repository
• Improved reliability of membership tier management

Migration Guide

No migration steps are required for this patch release. The update can be applied directly without any additional configuration changes.

Upgrade Recommendations

This patch release is recommended for all Ghost users, especially those utilizing membership tiers with descriptions or relying on event verification functionality.

The update addresses critical bugs that may impact your ability to properly configure membership offerings and could affect certain event-based operations. As a minor patch release (v5.22.1 → v5.22.2), the upgrade process should be straightforward with minimal risk.

To upgrade:

1. Back up your Ghost installation
2. Follow the standard Ghost update procedure for your installation method
3. No configuration changes are required after updating

Bug Fixes

• Fixed Tier Description Issue: Resolved a critical bug where tier descriptions could not be set. The validation function for tier descriptions was not returning the validated value, preventing users from setting or updating descriptions for membership tiers. (#15741, #15740)

• Fixed Verification Trigger: Corrected an issue with verification trigger usage of the Event Repository. The method signatures were updated to take MongoDB filter objects, but this particular call-site was not updated accordingly, causing potential verification failures. (Team#2192)

New Features

No new features were introduced in this patch release.

Security Updates

No security fixes were included in this patch release.

Performance Improvements

No specific performance improvements were included in this patch release.

Impact Summary

Ghost v5.22.2 delivers important fixes for membership tier functionality and event handling. The patch ensures that site administrators can properly set and edit tier descriptions, which is crucial for effectively communicating membership value propositions to potential subscribers. Additionally, it resolves an issue with verification trigger usage in the Event Repository, improving system reliability.

While these changes are technically minor, they address functionality that directly impacts user experience and system operations. Sites using Ghost's membership and subscription features will particularly benefit from the tier description fix, as it restores the ability to properly describe different membership offerings.

The release also highlights an architectural note for developers about the Event Repository using MongoDB filter objects rather than NQL filter strings, indicating a potential area for future improvement in the Ghost codebase.

Full Release Notes