Ghost Release: 5.16.0

TL;DR

Ghost v5.16.0 introduces a comprehensive analytics and attribution system, allowing site owners to track link clicks, referral sources, and member activity. This release adds detailed analytics dashboards for posts and members, improves email tracking capabilities, and enhances the Lexical editor support. The update also includes fixes for newsletter image rendering and optimizes asset caching for better performance.

Highlight of the Release

• New analytics system with link click tracking and referral source attribution
• Enhanced post analytics page with detailed metrics and link performance data
• Improved member attribution with referrer tracking and source grouping
• Better Lexical editor support with visual indicators and rendering improvements
• Optimized asset caching with jsDelivr CDN integration

Migration Guide

Member Attribution and Analytics

If you're using custom themes or integrations that interact with member data or analytics, you may need to update your code to accommodate the new attribution fields and analytics endpoints.

Lexical Editor

If you've built custom integrations with the editor, note that there are now visual indicators for Lexical editor content in the admin UI. The Lexical editor is still behind a feature flag but has received significant improvements in this release.

CDN Changes

The release switches to a Ghost-specific jsDelivr CDN endpoint with a shorter 10-minute browser cache. If you've implemented custom caching strategies for Ghost assets, you may need to review and adjust your configuration.

Upgrade Recommendations

This is a recommended upgrade for all Ghost users, especially those interested in better analytics and member attribution data. The new features provide valuable insights into content performance and member acquisition without any breaking changes.

The upgrade process should be straightforward with no special steps required. As always, it's recommended to backup your database before upgrading.

Bug Fixes

• Fixed distorted images in newsletters for product cards
• Fixed "cannot save both mobiledoc and lexical" error when tabbing from title field
• Fixed "Cannot find module 'react'" when rendering lexical in production
• Fixed "Cannot find module '@lexical/clipboard'" when rendering lexical
• Fixed empty paid subscriptions chart for fake data
• Fixed missing shadow on hovering edit button in post list
• Fixed incorrect API error response messages
• Fixed post counts cleared when member attribution flag was disabled
• Fixed format option in gh-format-post-time helper
• Fixed subdirectories saved in the link_redirects table
• Fixed missing subscribers count from list-item-clicks

New Features

Analytics and Attribution System

• Added comprehensive link click tracking system for emails and content
• Implemented source attribution for tracking where members come from
• Added referrer tracking with source and medium identification
• Created new analytics dashboards for posts with detailed metrics
• Added activity feed showing member clicks in emails

Post Analytics Enhancements

• Added link click counts to post analytics page
• Implemented source attribution table for post referrers
• Added resources section to post analytics page
• Added real count data to analytics page

Member Attribution

• Added referrer information capture and storage
• Implemented known referrers list for grouping traffic sources
• Added source attribution widget to the dashboard
• Updated subscription box design with attribution data

Lexical Editor Improvements

• Added indicator to Lexical editor screen and post list
• Added link and heading ID attribute support when rendering Lexical content
• Added aside and blockquote Lexical rendering support
• Added __GHOST_URL__ transform support to posts.lexical field

Email Enhancements

• Added Mailgun as transaction email transport option
• Added tracking to email links with click events
• Improved handling of Mailgun errors on bulk send

Security Updates

No significant security fixes were included in this release.

Performance Improvements

Asset Caching Improvements

• Switched to jsDelivr CDN endpoint with shorter browser cache (10 min) for quicker asset refreshes
• Made Admin assets aggressively cacheable with 'immutable' cache-control header to prevent redundant requests
• Optimized link tracking and storage for better performance

Database Optimizations

• Added efficient database storage for link redirects and click events
• Improved data handling for analytics metrics
• Optimized referrer attribution calculation logic

Impact Summary

Ghost v5.16.0 significantly enhances the platform's analytics capabilities, giving site owners deeper insights into how members discover and interact with their content. The new link tracking and attribution system helps understand where traffic and members come from, while improved post analytics provide detailed metrics on content performance.

The Lexical editor continues to mature with better rendering support and visual indicators, preparing for its eventual promotion from labs feature to general availability. Performance improvements to asset caching will result in faster admin interface loading times and reduced server load.

This release represents a major step forward in Ghost's analytics capabilities, helping publishers better understand their audience and content performance without requiring third-party tools.

Full Release Notes