Ghost Release: 3.22.2

TL;DR

Ghost 3.22.2 brings important bug fixes for the members feature and API access

This patch release addresses three key issues: fixing the members subscription migration to handle missing data, ensuring proper access defaults in the v3 API, and resolving a settings cache issue that affected themes. These fixes improve stability for sites using the members feature and ensure proper data synchronization throughout the application.

Highlight of the Release

• Fixed members subscription migration to handle databases with missing data
• Updated access property to default to true in v3 API for better consistency
• Improved settings cache reinitialization to properly emit events for all settings

Migration Guide

No migration steps are required for this patch release. The update can be applied directly without any additional configuration changes or data migrations needed from users.

Upgrade Recommendations

This patch release is recommended for all Ghost users, especially those using the members feature or who have experienced issues with settings not being properly synchronized after migrations. The fixes improve stability and ensure proper data handling.

To upgrade:

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

Bug Fixes

• Members Subscription Migration: Fixed an issue where the migration could fail when encountering databases with unexpected states or missing data. The code now checks for each property before using it and applies defaults when data is missing (#12009).

• API Access Property: Resolved an issue with the access property in the v3 API. It now defaults to true when members feature is disabled, and when members is enabled, it correctly reflects the currently logged-in member's access level (#11990).

• Settings Cache Events: Fixed a bug where settings events weren't being properly emitted when the cache was reinitialized after migrations. This caused services that depend on these events (like the themes i18n service) to have stale data. Now all settings events are properly emitted during reinit (#12012).

New Features

No new features were introduced in this patch release. This version focuses exclusively on bug fixes and stability improvements.

Security Updates

No security fixes were included in this release.

Performance Improvements

No specific performance improvements were included in this release. The changes focus on bug fixes and stability rather than performance enhancements.

Impact Summary

Ghost 3.22.2 is a maintenance release that addresses three specific bugs affecting members functionality, API behavior, and settings synchronization. The fixes ensure more robust handling of member subscription data during migrations, consistent API behavior regarding the access property, and proper event emission for settings changes. These improvements enhance stability for sites using the members feature and ensure that all parts of Ghost remain properly synchronized when settings change, particularly after migrations have run. The changes are backward compatible and require no special migration steps.

Full Release Notes