Ghost Release: 5.25.3

TL;DR

Ghost v5.25.3 is a maintenance release that addresses several important bugs affecting email functionality, member management, and UI permissions. Key fixes include preventing free trials from being applied alongside offers in checkout, optimizing email header images to avoid serving unnecessarily large files, hiding the analytics page from editors who don't have access permissions, and resolving an issue with the "unsaved changes" modal appearing unexpectedly when deleting members.

Highlight of the Release

• Fixed issue where free trials were incorrectly applied alongside offers in checkout
• Optimized email header images to prevent serving unnecessarily large original files
• Removed analytics page access for editors who don't have permission to view it
• Fixed unexpected 'unsaved changes' modal appearing when deleting members

Migration Guide

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

Upgrade Recommendations

This release contains important bug fixes for email functionality and member management. It's recommended for all Ghost users to upgrade, especially those who:

1. Use email newsletters with header images
2. Offer free trials alongside discount offers
3. Have editor-level users who might be confused by seeing UI elements they don't have permission to access
4. Actively manage members through the admin interface

The update is straightforward with no breaking changes or migration steps required.

Bug Fixes

• Fixed free trial applied alongside an offer in checkout
  Previously, if a discount offer was associated with a tier that had a free trial enabled, the Stripe checkout would incorrectly apply both the discount and free trial to the member. This has been fixed by removing trial days from Stripe checkout when a coupon is being applied, ensuring only one promotion is applied at a time.

• Fixed email header images serving original image size
  Email header images were being served at their original size rather than an optimized version, potentially causing delivery issues with large images. This has been resolved by adding a new internal size to the imageOptimization config and fixing the URL generation for both new and old email flows.

• Hidden analytics page for editors
  The analytics page, which editors don't have permission to access, was incorrectly visible in the UI for editors. This has been fixed by removing the button that navigates to the analytics page for editors and authors.

• Fixed unexpected "unsaved changes" modal when deleting a member
  When deleting a member, an unexpected "unsaved changes" modal would appear after confirming deletion. If users chose to stay, they would remain on the member screen with stale data, causing further errors when attempting to make changes. This has been fixed by preventing the unsaved changes check from running for a deleted member.

New Features

No new features were added in this release. This is a maintenance release focused on bug fixes and improvements.

Security Updates

No security fixes were included in this release.

Performance Improvements

• Optimized email header images
  Email header images are now served at an optimized size (1200px width) instead of their original dimensions. This reduces the file size of emails, improving delivery rates and load times for recipients.

Impact Summary

This maintenance release addresses several important bugs that improve the user experience for both administrators and members. The fixes for email header image optimization will help ensure better email delivery by reducing file sizes. The correction to the checkout process ensures that promotional offers work as expected without incorrectly combining discounts with free trials. UI improvements for editors and the fix for the unexpected "unsaved changes" modal when deleting members streamline the administrative experience and prevent potential confusion or errors. While these changes are relatively minor in scope, they address specific pain points that could impact day-to-day operations for Ghost users.

Full Release Notes