Ghost Release: 4.46.1

TL;DR

Ghost v4.46.1 fixes a critical bug in the newsletter migration process that was causing failures when site names were empty (NULL). This patch ensures the migration works correctly for all sites regardless of their configuration.

Highlight of the Release

• Fixed critical bug in default newsletter migration that failed when site name was NULL
• Improved database migration reliability by excluding non-nullable columns
• Enhanced timestamp handling by using SQL's native CURRENT_TIMESTAMP instead of JavaScript Date objects

Migration Guide

No migration steps are required for this patch release. The fix is automatically applied when upgrading to v4.46.1.

If you previously experienced failures during the newsletter migration process due to NULL site names, upgrading to this version should resolve those issues without any additional steps required.

Upgrade Recommendations

This patch release is highly recommended for all Ghost installations, especially for:

• Sites that have experienced failures during the newsletter migration process
• Installations with empty/NULL site names in settings
• Any site running v4.46.0 that hasn't yet completed the newsletter migration

The upgrade process is standard and should be straightforward:

ghost update

Or if using Docker or other deployment methods, update to the v4.46.1 tag.

Bug Fixes

Newsletter Migration Fix

This release addresses a critical bug in the default newsletter migration process:

• Fixed an issue where the migration would fail when a site had an empty name (NULL value in settings)
• The root cause was that the newsletter table's name column is not nullable, but the migration was attempting to copy NULL values from settings
• The fix excludes all non-nullable columns from being populated with NULL values
• Additionally improved timestamp handling by replacing JavaScript Date objects with raw SQL CURRENT_TIMESTAMP for better reliability

New Features

No new features were introduced in this patch release. This is a bug fix release focused on resolving a specific issue with the newsletter migration process.

Security Updates

No security fixes were included in this patch release.

Performance Improvements

No specific performance improvements were included in this patch release. The focus was on fixing the newsletter migration bug.

Impact Summary

This patch release fixes a specific but important bug in the newsletter migration process that could prevent successful migrations on sites with empty names. The fix makes the migration process more robust by properly handling NULL values and improving timestamp management.

While this is a targeted fix for a specific scenario, it's an important reliability improvement for the database migration system. The change ensures that all Ghost installations can successfully complete the newsletter migration regardless of their configuration, particularly addressing edge cases where site names might be empty.

No new features or other changes are included in this release, making it a safe and recommended upgrade for all users currently on v4.46.0.

Full Release Notes