Ghost Release: 5.25.2

TL;DR

Ghost v5.25.2 fixes a critical bug in the offer redemption tracking system

This patch release addresses an issue where offer redemptions weren't being properly counted due to missing metadata in Stripe checkout sessions. The bug was introduced in a previous refactoring and affected the ability to track how many times an offer had been used, which is crucial for offers with limited redemptions.

Highlight of the Release

• Fixed offer redemption counting for Stripe checkout sessions
• Restored proper tracking of limited-use offers
• Improved reliability of the subscription offer system

Migration Guide

No migration steps are required for this patch release. The fix is automatically applied when upgrading to v5.25.2.

Upgrade Recommendations

This is a recommended upgrade for all Ghost users who utilize the offer system, especially those who create offers with redemption limits.

How to upgrade:

1. Back up your Ghost installation
2. Follow the standard Ghost update process for your installation method:
   • For Ghost(Pro) users: Updates are automatic
   • For self-hosted installations: Use the Ghost-CLI with ghost update

The update is backward compatible and requires no additional configuration changes.

Bug Fixes

Fixed Offer Redemption Counting

This release fixes a critical bug in the offer redemption tracking system. The issue occurred because offer IDs were not being properly attached to Stripe checkout metadata during the checkout process. This meant that when a subscription was created through a checkout session, the system wasn't recording which offer was used.

The bug was introduced in a previous refactoring (commit 25d8d69) and affected the ability to:

• Track how many times an offer had been redeemed
• Enforce redemption limits on offers
• Generate accurate reporting on offer performance

This fix ensures that offer IDs are properly included in checkout session metadata and that redemption counts are correctly incremented when offers are used.

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

This patch release fixes a specific but important bug in Ghost's integration with Stripe for tracking offer redemptions. The issue prevented proper counting of offer redemptions, which could lead to offers with limited redemptions not being enforced correctly. This fix ensures that when subscribers use an offer during checkout, the system properly records which offer was used and increments the redemption count accordingly.

For site administrators and content creators who rely on limited-use offers as part of their monetization strategy, this fix restores the expected functionality and ensures accurate tracking. The change is focused solely on fixing this specific issue and doesn't introduce any new features or require any migration steps.

Full Release Notes