Ghost Release: 5.25.1

TL;DR

Ghost v5.25.1 is a maintenance release that fixes critical email tracking issues. It resolves errors that occurred when processing email events for deleted members and prevents the loss of email delivery data after hard bounces. These fixes improve the reliability of Ghost's email infrastructure, particularly for sites with large subscriber bases that depend on accurate email analytics.

Highlight of the Release

• Fixed uncaught errors when processing email events for deleted members
• Preserved email delivery data after hard bounces
• Improved performance for batch email sending

Migration Guide

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

Upgrade Recommendations

This update is recommended for all Ghost users, especially those who rely heavily on email newsletters and need accurate email analytics. The fixes address important issues with email tracking and improve system stability.

The update is particularly important for sites with:

• Large subscriber bases
• Regular newsletter sending
• Member management workflows that include deleting members

Since this is a patch release with no breaking changes, upgrading should be straightforward with minimal risk.

Bug Fixes

Email Event Processing Fixes

• Fixed uncaught Bookshelf EmptyResponse errors that occurred when processing email open events for deleted members
• Added try-catch blocks for all event listeners in the last seen at updater to prevent unhandled exceptions
• Fixed an issue where delivered_at timestamps were being set to null after hard bounces, which caused loss of delivery information
• Modified the system to properly handle recipients that have both failed_at and delivered_at timestamps set

Performance Improvements

• Disabled autoRefresh for batch sending service to increase performance when sending emails to large subscriber lists

New Features

No new features were introduced in this maintenance release.

Security Updates

No security fixes were included in this release.

Performance Improvements

Batch Email Sending Performance

The batch sending service has been optimized by disabling the autoRefresh feature, which significantly improves performance when sending emails to large subscriber lists. This change reduces database load during batch operations and allows emails to be processed more efficiently.

Impact Summary

Ghost v5.25.1 focuses on improving the reliability of email tracking and analytics. The release fixes two critical issues: errors when processing email events for deleted members and the loss of delivery information after hard bounces.

For newsletter publishers, these fixes ensure more accurate tracking data, even in edge cases like deleted members opening emails. The preservation of delivery timestamps after bounces provides a more complete picture of email performance.

System administrators will benefit from improved stability with fewer uncaught errors in the email processing pipeline. The performance optimization for batch sending will be particularly noticeable for sites with large subscriber bases.

Overall, this maintenance release strengthens Ghost's email infrastructure, making it more robust and reliable for production environments.

Full Release Notes