Ghost Release: 4.20.4

TL;DR

Ghost v4.20.4 is a maintenance release that fixes several bugs affecting theme functionality and GScan validation. Key fixes include resolving a 500 error when accessing email-only posts, preventing GScan crashes on certain package.json files, fixing false "unused theme setting" errors, and addressing issues with custom settings sync for themes with periods in their names. This release improves stability for theme developers and site owners without introducing new features.

Highlight of the Release

• Fixed 500 error when accessing email-only posts via public URLs
• Resolved GScan crashes on files starting with package.json
• Fixed false positives for unused theme settings in GScan
• Fixed custom settings sync for themes with periods in their names

Migration Guide

No migration steps are required for this release. This is a drop-in bug fix update that can be applied without any additional configuration changes.

Upgrade Recommendations

This release contains important bug fixes for theme functionality and GScan validation. We recommend all Ghost users upgrade to v4.20.4, especially if you:

• Use custom themes with period characters in their names
• Work with email-only posts
• Develop or validate themes using GScan

The update is backward compatible and requires no configuration changes.

Bug Fixes

• Email-only Posts: Fixed a 500 error that occurred when visiting an email-only post link. Now returns a proper 404 error when an email-only post is accessed through its public URL. This addresses an edge case where v4 Admin API allows sending email-only posts, but v3 Themes don't support this functionality.

• GScan Theme Validation:

  • Fixed GScan falsely triggering the "unused theme setting" error by improving partial template parsing
  • Fixed GScan crashes that occurred when processing files starting with package.json by preventing incorrect JSON parsing attempts

• Custom Theme Settings: Fixed an error in custom settings synchronization when theme names contain period (.) characters. The fix properly wraps theme names in quotes when generating filter strings, e.g., theme:'4.1.1-my-theme' instead of causing invalid filter syntax.

New Features

No new features were introduced in this maintenance release.

Security Updates

No security fixes were included in this release.

Performance Improvements

No specific performance improvements were included in this release.

Impact Summary

Ghost v4.20.4 is a bug fix release that addresses several issues related to theme validation and handling of email-only posts. The fixes improve stability for theme developers by resolving GScan validation errors and crashes, while also enhancing the user experience by properly handling email-only post URLs.

The most significant impact is for theme developers who previously encountered false positives in GScan validation or had issues with themes containing periods in their names. Site owners will benefit from more stable theme validation and proper error handling for email-only posts.

This release demonstrates Ghost's commitment to maintaining a stable platform by addressing edge cases and improving error handling without introducing breaking changes.

Full Release Notes