Ghost Release: 5.22.7

TL;DR

Ghost v5.22.7 is a maintenance release that fixes two important issues: validation for the Members API newsletters endpoint and a bug in the subscription upgrade flow for new Tiers. This release ensures proper validation of newsletter data and restores the ability to upgrade subscriptions to Tiers created in version 5.22.x.

Highlight of the Release

• Fixed validation for Members API newsletters endpoint to match Admin API schema
• Fixed subscription upgrade flow for Tiers created since Ghost 5.22.x

Migration Guide

No migration steps are required for this release. The fixes are applied automatically when upgrading to v5.22.7.

Upgrade Recommendations

This is a recommended upgrade for all Ghost users, especially those who:

1. Use the Members API for newsletter management
2. Have created new Tiers since upgrading to Ghost 5.22.x and need to manage subscription upgrades

The release contains important bug fixes with no breaking changes, making it a safe and beneficial update for all installations.

Bug Fixes

Fixed validation for Members API newsletters endpoint

The validation schema for the Members API newsletters endpoint has been updated to match the subset of Admin API's members validation schema. This ensures consistent behavior across APIs and prevents validation errors when working with newsletter data.

Fixed upgrading Subscriptions to new Tiers

This release fixes a critical issue where users couldn't upgrade subscriptions to Tiers created since Ghost 5.22.x. The logic for fetching price information from Tiers had not been updated to use the new Tiers package and Payments service, causing the upgrade flow to fail. This fix ensures that subscription upgrades work correctly with all Tiers, including those created in the latest versions.

New Features

No new features were introduced in this maintenance release.

Security Updates

No security fixes were included in this release.

Performance Improvements

No specific performance improvements were included in this release.

Impact Summary

Ghost v5.22.7 is a targeted maintenance release that addresses two specific issues affecting the platform's subscription and API functionality. The fixes ensure proper validation in the Members API newsletters endpoint and restore the ability to upgrade subscriptions to newly created Tiers.

These improvements maintain the integrity of Ghost's membership and subscription systems, which are core to the platform's monetization capabilities. While the changes are relatively small in scope (91 changes across 7 files), they resolve important functional issues that could impact subscription management workflows and API integrations.

Users should experience more reliable subscription management and fewer validation errors when working with the Members API after this update.

Full Release Notes