Ghost Release: 4.8.0

TL;DR

Ghost 4.8.0 introduces multiple products support behind a feature flag, allowing site owners to offer different membership tiers. The release also adds extensive newsletter customization options, improves the editor experience, and includes various performance improvements and bug fixes. This update lays groundwork for more flexible monetization options while maintaining backward compatibility through feature flags.

Highlight of the Release

• Multiple products support added behind a feature flag, enabling membership tiers
• Extensive newsletter customization options including header image, alignment, fonts, and feature image display
• Administrator staff users can now manage member email settings
• Improved editor experience with default focus on title for new posts
• Significant code refactoring for better maintainability and future extensibility

Migration Guide

Feature Flags

• Multiple products functionality is behind the multipleProducts labs feature flag
• Post settings menu redesign is behind the psmRedesign labs flag
• Feature image metadata (alt text, captions) is behind a labs flag

Code Changes

• American English spellings are now used throughout the codebase instead of British English
• JSConfig has been added to enable type checking
• Many internal modules have been extracted to @tryghost/* packages

For Theme Developers

• No breaking changes to themes in this release
• New newsletter customization options may require theme updates to take full advantage of the new settings

For Plugin/Extension Developers

• The Bookshelf plugins have been extracted to separate packages
• If you were using internal validation tools, they've been moved to @tryghost/validator

Upgrade Recommendations

This is a feature-rich release with significant improvements to newsletter customization and the groundwork for multiple products support. The upgrade is recommended for all Ghost users, especially those who:

1. Use the newsletter feature and want more customization options
2. Are interested in testing the upcoming multiple products feature (behind feature flag)
3. Have administrator staff who need to manage member email settings

The release contains mostly non-breaking changes as new features are behind feature flags. Standard upgrade procedures apply:

1. Back up your Ghost installation
2. Follow the standard upgrade process
3. If you're using a custom theme, test it thoroughly after upgrading

For self-hosted installations, the upgrade should be straightforward with minimal risk. For developers working with the Ghost codebase, note the significant refactoring and modularization efforts that may affect custom code integrations.

Bug Fixes

UI and Experience Fixes

• Fixed confusing member count shown in save notification and editor header
• Fixed sticky "unsaved settings" modal that wouldn't dismiss properly
• Fixed order of flatten/clean operations in posts output serializers
• Fixed broken syntax in pagination plugin
• Fixed JSDoc for database helper functions

API and Data Handling

• Fixed issue where product table could retain references to Stripe price IDs after disconnect
• Added cache invalidation for products API to ensure frontend endpoints use updated product data
• Fixed handling of feature image metadata in API output

New Features

Multiple Products Support (Behind Feature Flag)

• Added labs feature flag for multiple products/membership tiers
• Updated Portal UI to support multiple products when flag is enabled
• Added ability to assign products directly to members
• Added portal_products setting to control which products are available in Portal

Enhanced Newsletter Customization

• Added new settings for newsletter appearance:
  • newsletter_header_image - Optional header image URL
  • newsletter_show_header_icon - Toggle header icon visibility
  • newsletter_show_header_title - Toggle header title visibility
  • newsletter_title_alignment - Center or left alignment options
  • newsletter_title_font_category - Serif or sans-serif font options
  • newsletter_show_feature_image - Toggle feature image visibility
• Added support for feature image captions and alt text in email templates

Other Improvements

• Administrator staff users can now manage member email settings
• Added support for canceling subscriptions via API
• Added Sentry integration for Portal error tracking

Security Updates

No significant security fixes were explicitly mentioned in this release. Regular dependency updates were included which may contain security patches, but no specific security vulnerabilities were addressed in the release notes.

Performance Improvements

Code Optimization

• Converted Bookshelf collision plugin to use async-await for better performance
• Extracted Bookshelf plugins from Ghost to Framework repo for better modularity
• Refactored validation tools for improved efficiency
• Split config utils into utils and helpers for better organization
• Moved package dependencies from devDependencies to dependencies where appropriate

Dependency Updates

• Updated numerous dependencies to latest versions for better performance and security
• Replaced ghost-ignition with @tryghost/debug and @tryghost/logging
• Switched to @tryghost/validator, removing direct validator dependency
• Updated CSS preprocessors

Impact Summary

Ghost 4.8.0 represents a significant step forward in the platform's evolution, particularly for creators looking to monetize their content. The addition of multiple products support (behind a feature flag) lays the groundwork for more flexible membership offerings, allowing publishers to create different tiers with varying benefits.

The extensive newsletter customization options give publishers much more control over their email presentation, enabling better brand consistency and reader experience. This is particularly valuable as email continues to be a critical channel for audience engagement.

The code refactoring and modularization efforts, while less visible to end users, represent important progress in making Ghost more maintainable and extensible. By breaking down the codebase into smaller, decoupled modules, the Ghost team is setting the stage for more rapid feature development and easier maintenance in the future.

For most users, this update brings immediate benefits through the newsletter customization options and editor improvements. For those interested in more advanced monetization strategies, the multiple products feature (when enabled) will open up new possibilities for tiered memberships and more sophisticated business models.

Full Release Notes