Ghost Release: 3.41.4

TL;DR

Ghost 3.41.4: Bug Fixes and Maintenance Updates

This maintenance release addresses several important bugs, including a fix for the Member model that was inadvertently removing labels when unset. The update also resolves issues with newsletter bookmark cards in Gmail and improves template naming to prevent potential infinite loops in themes. This release is part of the 3.x maintenance branch and includes CI workflow updates to reflect this change in status.

Highlight of the Release

• Fixed Member model bug that was removing labels when unset
• Resolved Gmail display issues for newsletter bookmark cards
• Updated template naming to prevent infinite loops in themes
• Updated CI workflow to reflect 3.x branch maintenance status

Migration Guide

No migration steps are required for this update. This is a maintenance release that can be installed without any special considerations.

Upgrade Recommendations

This update is recommended for all Ghost 3.x users, especially those who:

• Use member labels in their site
• Send newsletters with bookmark cards
• Have custom themes that utilize the {{content}} helper

As this is a patch release (3.41.3 → 3.41.4), it contains only bug fixes and should be safe to apply without disrupting your site's functionality.

Bug Fixes

Member Label Management Fix

Fixed an issue where the Member model was inadvertently removing labels when they were unset. The bookshelf-relations plugin used by Ghost would remove all relations when set to an empty array, but leave them alone if set to undefined. The logic to deduplicate uppercase & lowercase versions of the same label was always setting labels to an array, which could be empty when the model was saved without passing labels. This update adds a check to skip all label handling if no labels are set.

Newsletter Display Improvements

• Fixed a bug causing newsletter bookmark cards to display incorrectly in Gmail
• Fixed an issue where newsletter bookmarks without an author would display a redundant separator

Template Naming Update

Updated the {{content}} helper partial template name from content.hbs to content-cta.hbs to prevent potential infinite loops in themes. This change addresses an issue where themes using a pattern of content.hbs with the {{content}} helper inside could cause infinite recursion in certain cases.

New Features

No significant new features were added in this maintenance release. The focus was 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.

Impact Summary

Ghost 3.41.4 is a maintenance release that addresses several bugs affecting member management and newsletter display. The most significant fix resolves an issue where member labels could be unexpectedly removed when updating member data. This release also improves compatibility with Gmail for newsletter bookmark cards and prevents potential infinite loops in themes using certain template patterns.

This update is part of the 3.x maintenance branch, indicating that Ghost is focusing on stability for the 3.x series while new feature development continues on newer versions. The CI workflow has been updated to reflect this change in status.

While this release doesn't introduce new features, it improves reliability for site administrators managing members and sending newsletters, particularly those using bookmark cards in their content.

Full Release Notes