Ghost Release: 5.49.0

TL;DR

Ghost v5.49.0 introduces the Substack migrator app as a generally available feature under beta features, making it easier for users to migrate from Substack to Ghost. This release also fixes a critical bug where single letter product slugs were causing 500 errors, and includes numerous improvements to the Admin X settings interface with better organization of tiers into active and archived groups. The update brings enhanced feedback widgets, new components in the Admin X design system, and initial scaffolding for a Collections API.

Highlight of the Release

• Substack migrator app is now generally available under beta features
• Fixed critical bug where single letter product slugs caused 500 errors
• Improved Admin X settings interface with better organization and new components
• Added scaffolding for Collections API with full CRUD operations
• Enhanced development experience with --lexical and --adminX flags for yarn dev

Migration Guide

No specific migration steps are required for this release. The update should be straightforward for most users.

If you're using the Substack migrator, note that it has moved from Labs to beta features, so you'll need to look for it in the new location.

For developers working with the Admin X settings or building against the new Collections API, please refer to the updated documentation for implementation details.

Upgrade Recommendations

This release is recommended for all users, especially those who:

1. Use products with single letter slugs, as it fixes a critical 500 error
2. Want to migrate content from Substack to Ghost
3. Are developing with Admin X or working with the new Collections API

The update contains important bug fixes and feature enhancements that improve the overall stability and functionality of Ghost. As always, it's recommended to backup your database before upgrading.

Bug Fixes

Fixed Single Letter Product Slug Issue

Fixed an issue where product slugs consisting of a single letter would cause a 500 error when checking if a user had access to view a post associated with that product. The underlying cause was related to the NQL lexer, and this fix circumvents the issue by providing a value that the lexer will not error out on.

Fixed Update Check

Fixed the update check functionality that was failing due to recent changes in the tiers service. The service now needs initializing before the update check can be run.

Fixed Email Recipients Fetching

Added forced debug output for EmailRecipients fetching to address an issue where the number of email recipients would occasionally exceed the maximum batch size (1000 for MailGun). The fix de-dupes data in the batch and truncates it if the amount of records is still above the threshold, ensuring emails are sent to at least some recipients rather than none.

Fixed Collections API Behavior

Fixed behavior when editing a non-existent collection to return a 404 error instead of creating a new collection.

New Features

Substack Migrator Now Generally Available

The Substack migrator app has been moved from Labs to general availability under beta features. This makes it easier for users to migrate their content from Substack to Ghost with a more stable and tested migration path.

Admin X Settings Improvements

Several improvements have been made to the Admin X settings interface:

• Added a reusable interaction within the Setting Group component for easier state management
• Separated tiers into active and archived groups in dropdowns for better clarity
• Added text-based settings, static social account settings, and timezone settings with real data
• Implemented toggle component in the AdminX design system
• Added default option for global Dropdown component
• Wired publication language setting to read/write real site data

Collections API Scaffolding

Initial scaffolding for a Collections API has been added with the following endpoints:

• GET /collections - Browse collections
• GET /collections/:id - Read a specific collection
• POST /collections - Create a new collection
• PUT /collections/:id - Update a collection
• DELETE /collections/:id - Delete a collection

Development Enhancements

• Added --lexical support to yarn dev for using a local Lexical instance instead of the CDN version
• Added --adminX functionality to yarn dev for spinning up AdminX with zero additional steps
• Added trackEvent utility for sending events to Plausible

Security Updates

No specific security fixes were mentioned in this release.

Performance Improvements

Improved Email Recipient Handling

Enhanced the email recipient handling to better manage cases where the number of recipients might exceed the maximum batch size. The system now de-duplicates records and truncates the batch if necessary, ensuring that emails are sent to at least some recipients rather than failing completely.

Optimized Admin X Components

Several Admin X components have been refactored and optimized:

• Removed unnecessary state variable from the global setting group component
• Merged similar components (Setting group values and Setting group inputs) to reduce duplication
• Improved the interaction patterns in Setting Group components to handle state transitions more efficiently

Impact Summary

Ghost v5.49.0 brings several important improvements that enhance both the user and developer experience. The most notable change is the promotion of the Substack migrator to general availability under beta features, making it easier for content creators to move their content from Substack to Ghost.

The fix for single letter product slugs resolves a critical issue that was causing 500 errors, improving platform stability. This is particularly important for sites using short product identifiers.

For administrators and developers, the Admin X settings interface has received significant enhancements with better organization of tiers, improved components, and real data connections. The addition of development flags like --lexical and --adminX to the yarn dev command streamlines the development workflow.

The introduction of the Collections API scaffolding lays groundwork for future features that will allow for more flexible content organization and presentation.

Overall, this release focuses on platform stability, developer experience improvements, and enhancing the migration path from other platforms to Ghost.

Full Release Notes