Ghost Release: 1.9.0

TL;DR

Ghost 1.9.0 introduces a significant new feature for managing redirects via JSON file upload/download, enables Unsplash integration by default, and improves error handling for email notifications. This release enhances both the admin experience and developer workflow with better redirect management capabilities and improved integration with Unsplash for image selection.

This update focuses on making Ghost more user-friendly while providing better tools for site migration and maintenance through the new redirects management system.

Highlight of the Release

• New redirects.json upload/download functionality for easier redirect management
• Unsplash integration enabled by default for all Ghost installations
• Improved error handling for welcome emails with cleaner logs
• Tag story counts now link directly to filtered content lists
• Fixed UI issues with Unsplash search text in Night Shift mode

Migration Guide

Redirects Management

If you've been managing redirects manually by editing the redirects.json file, you can now use the admin interface to upload and download this file. No migration is necessary, but you may want to familiarize yourself with the new UI for managing redirects.

Unsplash Integration

Unsplash is now enabled by default. If you previously had custom Unsplash settings:

• If you explicitly disabled Unsplash, it will remain disabled
• If you had a custom API key, it will continue to work but will be overridden on the next save
• No action is required unless you specifically want to disable the Unsplash integration

Upgrade Recommendations

This is a recommended upgrade for all Ghost users. The new redirects management feature provides significant improvements for site management, and the default Unsplash integration enhances the content creation experience.

The upgrade should be straightforward with no breaking changes reported. As always, it's recommended to:

1. Back up your Ghost installation before upgrading
2. Test the upgrade in a staging environment if possible
3. Follow the standard Ghost upgrade process for your installation method

For those using the Ghost CLI:

ghost update

Bug Fixes

UI and Usability Fixes

• Fixed unreadable Unsplash search text in Night Shift mode, improving accessibility and usability in dark mode
• Improved error messages for mail failures with more consistent formatting and better reason reporting
• Removed unnecessary "Error:" notation from translation strings for more consistent user messaging

New Features

Redirects Management System

Ghost now offers a dedicated system for managing redirects through JSON file upload and download. This new feature allows administrators to:

• Upload a redirects.json file through the admin interface
• Download the current redirects configuration as a JSON file
• Reload and re-register redirects at runtime without requiring a server restart

This functionality is particularly useful for site migrations or URL restructuring, making it much easier to maintain proper SEO and user experience when changing your site structure.

Unsplash Integration Enabled by Default

The Unsplash integration is now enabled by default in all Ghost installations, providing immediate access to free, high-quality stock photography directly within the editor. The system intelligently handles various configuration scenarios:

• New installations have Unsplash enabled automatically
• Existing installations with Unsplash explicitly disabled will remain disabled
• Installations with custom API keys will maintain functionality but keys will be overridden on next save

Enhanced Tag Management

Tags now feature clickable story counts that link directly to filtered content lists, improving navigation and content organization workflows.

Security Updates

No specific security fixes were mentioned in this release.

Performance Improvements

Error Handling Improvements

The error handling for welcome emails has been significantly improved:

• Reduced log verbosity for welcome email errors
• Implemented better error wrapping practices to prevent stack growth
• Applied the principle that the lowest component should instantiate specific errors

Test Environment Improvements

• Reorganized test environment to use temporary folders instead of the root content folder
• Updated test fixtures to use the latest Casper theme
• Improved isolation between test environments to prevent cross-contamination

Impact Summary

Ghost 1.9.0 represents a meaningful improvement to both the admin and content creation experience. The new redirects management system addresses a long-standing need for better URL management tools, particularly for sites that undergo restructuring or migration.

The decision to enable Unsplash by default removes a configuration step for new users and immediately provides access to high-quality imagery within the editor. This change, combined with the UI improvements for tag management and night shift mode, creates a more intuitive and efficient content creation workflow.

For developers and system administrators, the improved error handling and test environment organization reflect Ghost's ongoing commitment to code quality and maintainability.

Overall, this release enhances Ghost's capabilities as a professional publishing platform while maintaining its focus on user experience and developer-friendly architecture.

Full Release Notes