Ghost Release: 5.90.2

TL;DR

Ghost v5.90.2 is a minor release that addresses three specific issues: a form validation bug in the TextField component, a reversion of a routing change that prioritized collections over built-in routes, and a rollback of email analytics job improvements that were causing performance issues for larger sites. This maintenance release focuses on stability rather than introducing new features.

Highlight of the Release

• Fixed form validation issues with TextField component and Radix UI
• Reverted routing changes that incorrectly prioritized collections over built-in routes
• Rolled back email analytics job improvements to prevent potential data loss for large sites

Migration Guide

No migration steps are required for this release. The update can be applied directly without any additional configuration changes.

Upgrade Recommendations

This release is recommended for all Ghost users, especially those running larger sites with high email volumes who may have been affected by the email analytics processing issues. The update addresses important bugs and prevents potential data loss in email analytics, making it a worthwhile upgrade for stability purposes.

Bug Fixes

Form Validation Fix

Fixed an issue with the TextField component where a div was incorrectly positioned as a direct child of a form control primitive, causing custom validity errors with Radix UI. The fix properly moves the input element to be the direct child of the form control primitive, resolving validation problems.

Routing Priority Reversion

Reverted a previous change (from PR #20765) that incorrectly prioritized collections over built-in routes in the frontend routing system. This reversion restores the expected routing behavior.

New Features

No new features were introduced in this maintenance release. This version focuses exclusively on bug fixes and performance improvements.

Security Updates

No security fixes were included in this release.

Performance Improvements

Email Analytics Processing

Reverted recent email analytics job improvements that were causing performance issues for larger Ghost sites. The previous implementation was taking 2-5x longer than expected for the "opened" events aggregation queries, potentially causing some Mailgun events to be missed on high-volume sites. This rollback ensures more reliable email analytics processing while the team works on optimizing the aggregation queries before reimplementing the improvements.

Impact Summary

Ghost v5.90.2 is a targeted maintenance release that addresses three specific issues affecting form validation, routing, and email analytics processing. The most significant impact is for larger Ghost sites that send high volumes of emails, as the rollback of email analytics job improvements prevents potential missed Mailgun events and ensures more reliable data collection. Site administrators will benefit from fixed form validation in the admin interface and restored expected routing behavior. While this release doesn't introduce new features, it strengthens the platform's stability and reliability, particularly for newsletter-focused publications.

Full Release Notes