Ghost Release: 3.40.4

TL;DR

Ghost 3.40.4: Bug Fix for Member Deletion

This minor release fixes a critical bug that caused errors when deleting members who had received newsletter emails. The fix ensures that newsletter email recipient records are properly handled during member deletion, preventing database errors and allowing for smoother member management operations.

Highlight of the Release

• Fixed critical error when deleting members who had received newsletter emails
• Updated bookshelf-relations dependency to properly handle parent-child relationships
• Improved database integrity for member management operations

Migration Guide

No migration steps are required for this update. Simply upgrade to version 3.40.4 to benefit from the bug fix.

Upgrade Recommendations

This update is recommended for all Ghost users who manage members and send newsletter emails, as it fixes a critical bug that prevents proper member deletion.

The upgrade process is straightforward:

1. Back up your Ghost installation
2. Update to Ghost 3.40.4 using your preferred method (Git, Docker, or direct download)
3. Restart your Ghost instance

No configuration changes or additional steps are required after upgrading.

Bug Fixes

Member Deletion Error Fix

This release resolves a critical bug (issue #12493) that caused errors when attempting to delete members who had received newsletter emails. The issue was related to how database relationships were handled between members and their email recipient records.

The fix includes:

• Updated bookshelf-relations dependency to version 1.4.1, which properly supports the hasMany relationship configuration needed
• Added configuration to the Member.email_recipients relationship to preserve related records when a member is deleted
• Removed unnecessary bookshelf-relations configuration in the EmailRecipient model

This ensures that when a member is deleted, the operation completes successfully without database constraint errors, while maintaining proper record relationships.

New Features

No new features were introduced in this release. This is a bug fix release focused on resolving an issue with member deletion.

Security Updates

No security fixes were included in this release.

Performance Improvements

No specific performance improvements were included in this release. The focus was on fixing the member deletion bug.

Impact Summary

This release addresses a specific but important bug that affected member management in Ghost. By fixing the error that occurred when deleting members who had received newsletter emails, Ghost 3.40.4 ensures smoother administrative operations and prevents potential database inconsistencies.

The fix is particularly valuable for Ghost sites with active newsletter functionality, where administrators regularly need to manage their member database. The update ensures that member deletion operations work reliably regardless of the member's newsletter interaction history.

While this is a minor release with a focused scope, it resolves a pain point that could significantly disrupt member management workflows for site administrators.

Full Release Notes