Ghost Release: 5.17.1

TL;DR

Ghost v5.17.1 is a minor patch release that fixes critical issues with the member activity feed and click filtering functionality. It also addresses an inconsistency in email analytics where click rates could appear higher than open rates due to processing timing differences. This release ensures data integrity and improves the reliability of member activity tracking and email analytics reporting.

Highlight of the Release

• Fixed broken member activity feed and click filtering functionality
• Resolved inconsistency in email analytics reporting where click rates could appear higher than open rates
• Improved data integrity for member engagement tracking

Migration Guide

No migration steps are required for this update. This is a patch release that can be installed without any special considerations or actions needed from administrators.

Upgrade Recommendations

This update is highly recommended for all Ghost users, especially those who rely on member activity tracking and email analytics. The fixes address important functionality issues that could affect your ability to track member engagement accurately.

To upgrade:

1. Back up your Ghost installation
2. Follow the standard Ghost update procedure for your installation method (CLI, Docker, etc.)
3. No additional configuration changes are required after updating

Bug Fixes

Fixed Broken Activity Feed and Click Filter

The member activity feed and click filtering functionality was broken due to two issues:

1. The link relation of a member-click-event was incorrectly using link_id as a foreign key instead of redirect_id.
2. The database table members_link_click_events was renamed to members_click_events, but this change wasn't reflected in a recent update to the member model that contains custom filters.

These fixes restore proper functionality to the activity feed and click filtering features.

Email Analytics Consistency Fix

Fixed an issue where email click rates could appear higher than open rates due to processing timing differences. Ghost processes clicks much faster than Mailgun events, which could result in misleading analytics.

The fix ensures that the open rate will never be lower than the click rate by using the higher value of click count and open count for email open count calculations. This serves as a stopgap solution until click events can update the opened_at time for email recipients.

New Features

No new features were introduced in this patch release. This update focuses exclusively on bug fixes and improvements to existing functionality.

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 fixing functionality rather than enhancing performance.

Impact Summary

This patch release has a moderate impact on Ghost installations, particularly for users who actively monitor member engagement and email analytics. The fixes restore critical functionality to the member activity feed and click filtering, ensuring administrators can properly track and analyze member behavior.

The email analytics fix addresses a confusing inconsistency where click rates could appear higher than open rates, which could lead to misinterpretation of newsletter performance. By ensuring open rates are never lower than click rates, the data now presents a more logical and accurate representation of email engagement.

While these changes don't introduce new features or require migrations, they significantly improve the reliability of existing functionality that many Ghost users depend on for business insights and member management.

Full Release Notes