TL;DR
Ghost 5.15.0 introduces email click tracking, source attribution for member signups, and the foundation for a new Lexical editor. This release enhances analytics capabilities with post-specific stats, adds support for .m4a audio files, and improves the admin UI with updated modal patterns. Several bug fixes address issues with tag slugs, member imports, and tier creation.
Highlight of the Release
- Email click tracking with new email_track_clicks setting
- Source attribution for member signups
- Foundation for new Lexical editor (behind feature flag)
- Post-specific analytics page
- Support for .m4a audio format
- Improved members import experience
- New Solo theme added to theme directory
Migration Guide
Lexical Editor (Alpha Feature)
If you want to try the new Lexical editor (alpha), you can enable it via the Labs section in your Ghost admin. Note that content created with the Lexical editor won't be editable with the Mobiledoc editor and vice versa. This feature is still in development and should be used with caution in production environments.
Email Click Tracking
Email click tracking is enabled by default for new installations and will match your existing email_track_opens setting for existing installations. You can adjust this in the Email settings section of your Ghost admin.
Source Attribution
Source attribution is enabled behind a feature flag. No action is required to start collecting this data, but the UI for viewing this data is still in development.
Upgrade Recommendations
This release contains several new features and improvements with minimal breaking changes. It's recommended to upgrade to take advantage of the new analytics capabilities, email click tracking, and other enhancements.
For developers working with the Ghost API, note that the lexical field has been added but is not returned by default in API responses. If you need this field, you'll need to explicitly request it with ?formats=lexical.
As always, make a backup of your database before upgrading, especially if you're running a production site.
Bug Fixes
Fixed Tag Slug Auto-matching
Fixed an issue where tag slugs weren't automatically matching the tag title when creating a new tag. Now when you type a tag title, the slug will properly update to match it unless manually edited.
Fixed Duplicate Error Columns in Members Import
Resolved a bug that was creating duplicate error columns in the CSV file generated when there were errors during member imports.
Fixed Hidden Error in "Add Tier" Modal
Fixed an issue where errors in the "Add tier" modal were hidden, making it difficult to understand why tier creation was failing. The fix properly captures model errors and marks fields with validation errors.
Fixed "About Ghost" Missing System Information
Corrected an issue where system information was missing from the "About Ghost" modal due to controller code not being properly moved when the template was relocated.
Fixed Feature Image Caption Escaping
Fixed a bug where feature image captions were being escaped twice in newsletters, breaking the possibility to add links to captions.
New Features
Email Click Tracking
Ghost now supports tracking clicks in email newsletters with the new email_track_clicks setting. This feature allows you to see which links in your newsletters are getting the most engagement, providing valuable insights into what content resonates with your audience.
Source Attribution for Member Signups
A new source attribution system has been implemented to track where your members are coming from. This feature helps you understand which channels are driving member signups and conversions, allowing for more informed marketing decisions.
Post-specific Analytics
A dedicated analytics page for posts has been added, providing more detailed insights into how your content is performing. This includes email opens, clicks, and other engagement metrics specific to each post.
Support for .m4a Audio Format
The audio card now supports .m4a files, expanding the range of audio formats that can be used in your content. This Apple lossless format is commonly used and has been frequently requested by users.
New Solo Theme
The Solo theme has been added to the theme directory, providing another option for customizing your Ghost site's appearance.
Lexical Editor Foundation (Alpha)
The groundwork for a new Lexical-powered editor has been laid, with the addition of the posts.lexical database field and related infrastructure. This feature is currently behind a feature flag and will eventually replace the current Mobiledoc editor.
Security Updates
No significant security fixes were included in this release.
Performance Improvements
Fingerprinted Admin Assets
All Admin assets now contain fingerprint hashes, ensuring that browsers will load the latest version when assets are updated rather than using cached versions. This improves the experience when updating Ghost by eliminating the need for manual browser cache clearing.
Improved Column Rename Migration Performance
The migration that renames the bio column to expertise on the members table has been optimized for better performance on larger MySQL clusters by using raw SQL instead of the Knex helper when appropriate.
ARM64 Prebuilt Binaries for SQLite
Added ARM64 prebuilt binaries for SQLite, reducing the need for development tooling when running Ghost on ARM64 architecture (like Apple M1/M2 chips).
Impact Summary
Ghost 5.15.0 significantly enhances the platform's analytics capabilities with the addition of email click tracking and source attribution for member signups. Content creators will benefit from more detailed insights into how their content performs and which links drive engagement. The new post-specific analytics page provides a clearer view of content performance.
The groundwork for the new Lexical editor represents an important step in Ghost's editor evolution, though it's currently behind a feature flag and not ready for production use. Support for .m4a audio files addresses a long-standing feature request.
For administrators, the improved members import experience with better error handling and formatting makes managing your audience more efficient. Developers will appreciate performance improvements like fingerprinted admin assets and ARM64 prebuilt binaries for SQLite.
Overall, this release focuses on enhancing analytics, improving the user experience, and laying groundwork for future editor improvements while maintaining stability.
Full Release Notes
- ✨ Added support for .m4a format in audio cards - Naz
- 🎨 Added number formatting to members import email - Simon Backx
- 🐛 Fixed tag slug not auto-matching tag title when creating new tag - Kevin Ansfield
- 🐛 Fixed duplicate error columns in members import error CSV - Simon Backx
- 🐛 Fixed Hidden error in "Add tier" modal (#15361) - Hakim Razalan
View the changelog for full details: v5.14.2...v5.15.0
🪄 Love open source? We're hiring Node.js Engineers to work on Ghost full-time