Home

>

Tools

>

Ghost

>

Releases

>

5.15.0

Ghost Release: 5.15.0

Tag Name: v5.15.0

Release Date: 9/16/2022

Ghost LogoGhost

Open-source publishing platform specifically designed for professional bloggers and publications. Focuses on clean, minimalist writing and publishing experience.

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

Statistics:

File Changed256
Line Additions8,184
Line Deletions3,547
Line Changes11,731
Total Commits123

User Affected:

  • Can now use .m4a audio files in audio cards
  • Will see improved post analytics with email click tracking
  • Will benefit from better UI for post lists with clearer status indicators
  • Will experience more consistent tag slug generation when creating new tags

Contributors:

ErisDSkevinansfieldrshbhgrgrenovate[bot]daniellockyerSimonBackxpeterzimonh2akimdjordjevlaissanne-sannazallouisaileengithub-actions[bot]