Ghost Release: 1.22.4

TL;DR

Ghost 1.22.4 brings important bug fixes for URL handling in subdirectory setups, author display in post previews, and reading time calculations. This maintenance release improves stability and user experience with several small but meaningful fixes across the platform.

This update ensures URLs work correctly in subdirectory installations, fixes author display issues in the editor preview, and simplifies the reading time helper by removing the "seconds" option. The default theme Casper has also been updated to version 2.2.1 with various improvements.

Highlight of the Release

• Fixed URL service to properly respect subdirectory setups
• Fixed author display in post previews
• Simplified reading time helper by removing the "seconds" option
• Fixed Ghost setup compatibility with latest Node.js versions
• Updated default theme Casper to version 2.2.1

Migration Guide

No migration steps are required for this update. This is a maintenance release that can be installed with standard update procedures.

For the {{reading_time}} helper changes:

• The minimum reading time is now "1 min read" (the "<1 min read" option has been removed)
• If you were using custom i18n strings with the seconds option, you'll need to update your code as this option has been removed

Upgrade Recommendations

This is a recommended upgrade for all Ghost users, especially those running Ghost in a subdirectory setup. The release contains important bug fixes that improve stability and user experience.

The update process follows the standard Ghost upgrade procedure and should be straightforward with no breaking changes.

Bug Fixes

URL Service Improvements

• Fixed URL service to properly respect subdirectory setups (e.g., when Ghost is configured at localhost:2368/blog, URLs now correctly include /blog/ prefix)
• Optimized URL event triggering with relative/absolute URLs for better performance

Content & Editor Fixes

• Fixed {{author}} helper for post previews, ensuring author properties are accessible
• Fixed tag/author removal in post settings which was incorrectly removing multiple tags/authors
• Fixed broken i18n keys that were causing localization issues

Developer Experience

• Fixed Ghost setup compatibility with latest Node.js versions
• Improved importer context objects to show correct data instead of modified references

New Features

No significant new features were added in this maintenance release. The changes focus primarily on bug fixes, refinements to existing functionality, and code improvements.

Security Updates

No security fixes were included in this release.

Performance Improvements

• Optimized URL service to handle relative and absolute URLs more efficiently
• Changed YAML settings files to load synchronously, simplifying the express bootstrap architecture
• Removed unnecessary Promise.resolve in code that was running synchronously anyway

Impact Summary

Ghost 1.22.4 is a maintenance release focused on bug fixes and refinements. The most significant improvements address URL handling in subdirectory setups, author display in post previews, and reading time calculations.

For developers, the URL service now correctly handles subdirectory configurations, ensuring proper URL generation throughout the platform. Content creators will benefit from fixes to the author display in post previews and a simplified reading time helper.

The update to Casper 2.2.1 brings small refinements to the default theme, and various code improvements enhance overall stability. This release represents Ghost's ongoing commitment to polishing the platform and addressing user-reported issues.

Full Release Notes