Ghost Release: 5.62.0

TL;DR

Ghost v5.62.0 introduces significant improvements to the beta editor, including HTML-to-Lexical conversion support, fixes for bookmark card creation, and resolution of navigation issues. This release also adds comprehensive recommendation features, embeddable signup forms with newsletter selection, and enhanced AdminX UI with responsive design improvements. The update focuses on improving user experience while fixing critical bugs in the editor and recommendation system.

Highlight of the Release

• HTML-to-Lexical conversion support for the beta editor
• Embeddable signup forms with newsletter selection capabilities
• Comprehensive recommendation system with pagination and modal display
• AdminX UI improvements with responsive design for mobile devices
• Announcement bar customization in AdminX

Migration Guide

Offer Entity Changes

The Offer entity has been moved from its package to core as part of architecture improvements. If you've built custom integrations with the Offers system, note that:

1. The Offer is now exported from @tryghost/members-offers
2. The OfferRepository has been moved to Ghost core
3. Repository implementations now protect against invalid or malformed data

Redis Cache Configuration

If you're using custom Redis cache configurations, note that connections are now shared by default between caches. If you need separate connections with different configurations, you'll need to explicitly set "reuseConnection": false in your cache configuration.

Custom Signup Forms

If you're using custom signup forms, you can now take advantage of newsletter selection:

• Use the data-members-newsletter attribute on inputs to specify newsletter IDs
• For checkboxes, only selected newsletters will be subscribed to
• Multiple newsletter selection is now supported

Upgrade Recommendations

Recommended Upgrade Path

This release contains significant improvements to the beta editor, recommendation system, and AdminX UI. It's recommended for all users to upgrade, especially those using the beta editor or planning to implement recommendations.

Upgrade Priority: Medium

While there are no critical security fixes, the bug fixes for the beta editor and improvements to the recommendation system make this a worthwhile upgrade for most users.

Testing Recommendations

• If using the beta editor, test content creation via ?source=html and navigation between editor and post list
• If using recommendations, verify that pagination works correctly and that the modal displays properly
• If using custom signup forms, test newsletter selection functionality

Bug Fixes

Beta Editor Fixes

• Fixed broken "< Posts" and "Back to editor" links in the beta editor that were causing infinite save loops when using relative URLs
• Fixed bookmark card creation and pasted link unfurls that were failing due to incorrect assumptions about metadata attributes

Recommendation System Fixes

• Fixed loading of invalid recommendation icons and feature images
• Fixed notification and display logic for the recommendation modal
• Fixed direct subscribe links that were broken due to undefined site references

AdminX UI Fixes

• Fixed table action appearing in wrong position
• Fixed table action not appearing on cell hover
• Fixed heading regression
• Fixed AdminX search behavior
• Fixed AdminX modal routing

New Features

HTML-to-Lexical Conversion

Added support for converting HTML content to the beta editor format when creating posts via ?source=html. This allows content to be properly formatted in the beta editor rather than defaulting to the old editor.

Embeddable Signup Forms

Introduced customizable embeddable signup forms that can be added to external websites. These forms support:

• Newsletter selection capabilities
• Color customization options
• Multiple newsletter subscription options

Recommendation System Enhancements

• Added pagination support to the recommendations API
• Implemented random ordering and limiting of recommendations in the modal
• Added "Recommended you" section to settings
• Automatic enabling/disabling of recommendations based on content availability

AdminX Improvements

• Added announcement bar customization
• Implemented email customization with color picker support
• Improved responsive design for mobile devices
• Added ES Module loading for code splitting
• Enhanced pagination component for tables

Security Updates

No significant security fixes were included in this release.

Performance Improvements

Redis Connection Sharing

Added an option to share Redis connections across caches, improving memory usage and connection efficiency. This is enabled by default and relies on unique key prefixes to avoid collisions.

Collections Processing Optimization

Optimized PostEditedEvent processing in collections by skipping the matching collections update process when there are no visible changes, reducing unnecessary database transactions.

AdminX Loading Improvements

Updated AdminX to load via ES Modules, enabling code splitting for better initial load performance and more efficient resource usage.

Impact Summary

Ghost v5.62.0 delivers significant improvements to the content creation experience with fixes for the beta editor and enhanced bookmark functionality. Site administrators gain powerful new tools with embeddable signup forms featuring newsletter selection and a comprehensive recommendation system with pagination support. The AdminX interface receives substantial improvements with better responsive design, announcement bar customization, and email color customization options.

Under the hood, performance optimizations include Redis connection sharing and smarter collections processing. The architecture continues to evolve with better separation of business logic from repositories and improved error handling for invalid data.

This release represents a solid step forward in Ghost's evolution, particularly for sites using the beta editor or looking to implement recommendation features. The improvements to AdminX make the platform more accessible on mobile devices while providing more customization options for site administrators.

Full Release Notes