Ghost Release: 5.126.0

TL;DR

Ghost 5.126.0 introduces significant enhancements to newsletter design capabilities, improved analytics features, and various performance optimizations. This update focuses on giving publishers more control over their newsletter appearance with expanded customization options, while also improving the analytics experience with better data visualization and interaction features.

Highlight of the Release

• Enhanced newsletter design settings with more customization options
• Improved analytics interface with tooltips and better data visualization
• Performance optimizations with new database indexes for subscriber counts
• Better email client compatibility, especially for dark mode and Outlook
• New site_uuid implementation for improved multi-tenant service integration

Migration Guide

This release doesn't require any specific migration steps for most users. The new newsletter design settings will be available in the admin interface after updating.

For developers integrating with Ghost's analytics:

• The site_uuid is now available through the site Admin API endpoint
• Traffic analytics requests now include an x-site-uuid header
• A new trafficAnalyticsTracking labs flag has been added to enable tracking separately from the main analytics features

Upgrade Recommendations

This is a feature-rich update with significant improvements to newsletter design capabilities and analytics. It's recommended for all users to upgrade, especially those who rely heavily on newsletters and analytics features.

The update includes no breaking changes and should be safe to apply without any special precautions. As always, it's recommended to back up your database before upgrading.

Bug Fixes

Email Rendering Fixes

• Fixed newsletter design preview button text color
• Fixed feature image caption links to match header text color
• Fixed dark mode display issues in email templates
• Fixed Outlook always having blue links in header cards
• Fixed white line below title in Outlook with dark header backgrounds
• Fixed "auto" link color not being respected
• Fixed email product card rating always using dark images

Other Fixes

• Fixed spacing issues on analytics overview
• Fixed scroll jump when interacting with threaded notes in ActivityPub
• Reduced likelihood of subscription box triggering Gmail auto-resizing
• Improved behavior of outline buttons in darkmode inversions
• Fixed incorrect paywall text color with opposing header/body background darkness

New Features

Enhanced Newsletter Design Settings

• Added more customization options for newsletter templates
• Implemented independent link color settings separate from accent colors
• Added improved button styling options with better color handling
• Refined font weight options for serif title fonts

Improved Analytics

• Added tooltips to whole blocks in newsletter analytics
• Implemented diff values in growth charts to better visualize trends
• Fixed spacing issues in analytics overview
• Added share modal in Analytics for better content sharing

ActivityPub Enhancements

• Added "Follows you" badge to profiles
• Connected Explore and suggested profiles to optimized endpoint
• Fixed dark mode display issues
• Fixed scroll jump when interacting with threaded notes

Security Updates

No specific security fixes were mentioned in this release.

Performance Improvements

Database Optimizations

• Added email_disabled index in members table
• Added newsletter_id and created_at indexes in members_subscribe_events table
• These new indexes dramatically speed up the subscriber-count endpoint

API and Frontend Improvements

• Refactored link processing logic in post analytics for better reuse
• Connected ActivityPub Explore and suggested profiles to optimized endpoint
• Reduced API requests and improved loading speed for ActivityPub profiles
• Improved cache update logic for likes, replies, and reposts in ActivityPub

Impact Summary

Ghost 5.126.0 significantly enhances the newsletter experience with expanded design settings, giving publishers more control over their email appearance. The update also improves analytics with better data visualization and interaction features.

Key improvements include:

1. More newsletter design customization options including independent link colors and improved button styling
2. Enhanced analytics with tooltips and better data visualization
3. Performance optimizations with new database indexes for subscriber counts
4. Better email client compatibility, especially for dark mode and Outlook
5. New site_uuid implementation for improved multi-tenant service integration

These changes collectively provide a more polished and flexible publishing experience, particularly for newsletter-focused publishers. The performance improvements and bug fixes also contribute to a more stable and efficient platform overall.

Full Release Notes