Ghost Release: 4.47.0

TL;DR

Ghost v4.47.0 brings important fixes for newsletter management and member editing. This release addresses issues with newsletter header images being saved incorrectly and errors when updating non-existent members. It also includes migration of legacy email settings to the new newsletter system, improving overall stability and consistency in email communications.

Highlight of the Release

• Fixed issue with newsletter header images being saved incorrectly
• Resolved error when attempting to update non-existent members
• Migrated legacy email settings to the newsletter system
• Improved URL handling for member configuration

Migration Guide

Newsletter Settings Migration

This release includes a migration that moves legacy email settings to the newsletter system:

• The original migration to create the default newsletter omitted the from-address and reply-to settings
• sender_reply_to and members_reply_address settings are now properly copied to newsletters
• members_from_address had a default value of 'noreply' as the fallback, which is remapped to NULL in the newsletters table
• These changes apply to all newsletters that haven't already been reconfigured

Newsletter Header Images

A migration is included to update all newsletters with header images to ensure they're saved in the transform-ready format rather than as absolute URLs. This is handled automatically during the upgrade process.

Upgrade Recommendations

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

1. Use newsletters with header images
2. Manage members through the admin interface
3. Have recently migrated from older Ghost versions with legacy email settings

The upgrade should be straightforward with no breaking changes reported.

Bug Fixes

Newsletter Header Image Fix

Fixed an issue where newsletter header images were being saved as absolute URLs instead of in the transform-ready format. This ensures proper handling of header images when:

• Writing to the database (transformed to the transformReady path)
• Reading from the database (transformed to an absolute path)

A migration is included to update all existing newsletters with header images to ensure they're saved in the correct format.

Member Update Error Fix

Resolved an error that occurred when attempting to update a non-existent member. Previously, this would result in a 500 error being thrown, but now the system handles this case gracefully.

URL Handling in Member Configuration

Fixed incorrect URL handling in the member configuration provider:

• The existing code incorrectly used API versions for members, despite the members API not being versioned
• This caused a bug where the issuer was being set to {{admin_url}}/ghost/api/undefined
• The updated code now returns the correct value and includes unit tests

New Features

No significant new features were added in this release. The changes focus primarily on bug fixes, improvements to existing functionality, and preparation work for future updates.

Security Updates

No security fixes were mentioned in this release.

Performance Improvements

No specific performance improvements were highlighted in this release. The changes focus primarily on bug fixes and code improvements rather than performance optimizations.

Impact Summary

Ghost v4.47.0 focuses on stabilizing newsletter functionality and fixing member management issues. The most significant changes include fixing how newsletter header images are stored, resolving errors when updating non-existent members, and properly migrating legacy email settings to the newsletter system.

For newsletter managers, this means more reliable header image display and proper inheritance of email settings from previous configurations. Administrators will benefit from more robust member management with fewer unexpected errors. Developers will appreciate the more consistent codebase with standardized URL handling.

This release also includes preparation work for removing API versions in the future, which will make the codebase more maintainable long-term. While there are no major new features, these fixes and improvements enhance the overall stability and reliability of the Ghost platform.

Full Release Notes