Ghost Release: 4.9.0

TL;DR

Ghost 4.9.0 introduces several significant enhancements to content management capabilities, including support for feature image alt text and captions, webp image format, and conditional partials in themes. Security improvements include a new "reset all passwords" feature and better critical update alerts. The release also fixes several critical bugs related to migrations, API errors, and update notifications. This update improves both the editor experience and underlying platform stability while adding important accessibility features for content.

This release is particularly valuable for content creators who need better image management capabilities and developers working with custom themes. The security enhancements provide administrators with better tools for account management and system maintenance.

Highlight of the Release

• Feature image alt text and caption support for better accessibility and content context
• Webp image format support for improved image quality and performance
• New 'reset all passwords' feature for administrators
• Alpha support for segmented email content targeting specific member groups
• Critical bug fixes for migration issues and API errors

Migration Guide

Feature Image Alt Text and Caption

If your theme uses feature images, you should update it to take advantage of the new alt text and caption fields. In your theme templates, you can now use:

{{#if feature_image}}
  <img src="{{feature_image}}" alt="{{feature_image_alt}}">
  {{#if feature_image_caption}}
    <figcaption>{{feature_image_caption}}</figcaption>
  {{/if}}
{{/if}}

Note that feature_image_caption is automatically handled as a SafeString, so you don't need to use triple-curlies.

Webp Images

No changes are required to support webp images in your themes. Ghost will handle these files like any other image format.

Theme Development with Conditional Partials

If you're developing themes, be aware that Ghost now detects conditional partials like {{#if author}}{{> "partial"}}{{/if}}. Ensure all referenced partials exist in your theme to avoid validation errors during upload or activation.

Migration from 3.x to 4.9.0

If you're upgrading directly from Ghost 3.x to 4.9.0, the migration should handle URL transformations correctly. If you previously upgraded from 3.x to a version between 4.6.1 and 4.8.4, this release includes fixes for incorrectly stored URLs, which should be automatically applied during the upgrade process.

Upgrade Recommendations

Recommended for All Users

This upgrade is recommended for all Ghost users due to the important bug fixes and security enhancements included. The fixes for migration issues are particularly important for sites that upgraded from Ghost 3.x to versions between 4.6.1 and 4.8.4.

Testing Recommendations

As with any upgrade, it's recommended to:

1. Back up your database before upgrading
2. Test the upgrade in a staging environment if possible
3. Check your theme for any issues with feature image captions after upgrading
4. If you use custom themes, verify that they don't have any conditional partial issues

Upgrade Path

You can upgrade directly to Ghost 4.9.0 from any previous 4.x version. If upgrading from Ghost 3.x, it's recommended to upgrade directly to 4.9.0 rather than an intermediate version to benefit from the migration fixes included in this release.

Bug Fixes

Migration and Data Storage Fixes

• Fixed an issue where URLs could be incorrectly stored after migration from Ghost 3.x to versions 4.6.1-4.8.4, which could result in broken images
• Fixed potential for partial content regeneration in 4.0 migrations, ensuring more reliable upgrades
• Fixed validation on theme install API parameters to prevent 500 errors when parameters are missing

UI and Functionality Fixes

• Fixed a 500 error that occurred with incorrect fields parameter in API
• Fixed blank mobile preview for pages in the preview modal
• Fixed update notification continuing to show after upgrade
• Fixed version update indicator on the about page
• Fixed test email member UUID issue, ensuring unsubscribe URLs are set correctly
• Fixed account/dark mode/settings buttons not being accessible on small mobile devices

Theme and Content Fixes

• Fixed feature_image_caption requiring triple-curlies in themes
• Fixed issues with theme validation to prevent errors during installation

New Features

Feature Image Alt Text and Caption Support

Ghost now supports alt text and captions for feature images through the new feature_image_alt and feature_image_caption fields in the v4 posts API. Content creators can add these directly in the editor, improving both accessibility and providing additional context for images. Alt text is limited to 191 characters (screen readers typically cut off at 125 characters), while captions support basic HTML and can be up to 65535 characters.

Webp Image Support

Ghost now supports the webp image format, which offers superior compression and quality compared to traditional formats like JPEG and PNG. This can lead to faster page loads and better visual quality for the same file size.

Reset All Passwords Feature

Administrators now have access to a "reset all passwords" feature that allows them to:

• Reset passwords for all staff users
• Prevent staff from logging in until they reset their password
• Send password reset emails to all staff users
• Close all existing staff user sessions

This provides an important security tool for situations where account credentials may have been compromised.

Alpha Support for Segmented Email Cards

Ghost now includes experimental support for segmented email content. This feature allows content creators to insert email-only content targeted at specific segments of members (currently distinguishing between free and paid members). The segmentation uses NQL statements to target specific member groups.

Conditional Partials Detection in Themes

Ghost now detects conditional partials in themes, such as {{#if author}}{{> "partial"}}{{/if}}. This helps identify potential issues during theme upload/validation rather than encountering errors at runtime.

Security Updates

Reset All Passwords Feature

The new "reset all passwords" feature provides administrators with an important security tool for situations where account credentials may have been compromised. This feature:

• Resets all staff users' passwords
• Prevents staff from logging in until they reset their password
• Sends password reset emails to all staff users
• Closes all existing staff user sessions

Critical Update Alerts

Ghost now sends email notifications to administrators for critical update checks, ensuring that important security updates are not missed. This helps maintain the security posture of Ghost installations by encouraging timely updates.

Performance Improvements

Webp Image Support

The addition of webp image format support can significantly improve site performance. Webp images typically offer 25-35% smaller file sizes compared to JPEG at equivalent visual quality, leading to faster page loads and reduced bandwidth usage.

Improved Theme Validation

The enhanced detection of conditional partials in themes helps identify potential issues earlier in the development process, preventing runtime errors that could impact site performance.

Removed Netjet Support

Ghost has removed support for Netjet, a module that was designed for HTTP2/Push which never gained widespread adoption. This simplifies the codebase and removes an unnecessary dependency.

Impact Summary

Ghost 4.9.0 represents a significant enhancement to the platform's content management capabilities, particularly for image handling and accessibility. The addition of feature image alt text and captions directly addresses accessibility needs while providing more context for content. Support for webp images improves performance and visual quality.

For administrators, the new security features provide important tools for account management and system maintenance. The "reset all passwords" feature offers a crucial security measure for situations where credentials may be compromised.

Developers will benefit from improved theme validation with conditional partial detection, preventing runtime errors that could affect site stability. The fixes for migration issues are particularly important for sites that upgraded from Ghost 3.x to versions between 4.6.1 and 4.8.4.

The alpha support for segmented email content hints at Ghost's direction toward more sophisticated audience targeting capabilities, which will be valuable for publishers looking to personalize their content delivery.

Overall, this release balances new features with important bug fixes and security enhancements, making it a recommended upgrade for all Ghost users.

Full Release Notes