Ghost Release: 2.11.1

TL;DR

Ghost 2.11.1: Bug Fix Release

This minor release addresses several critical bugs in Ghost 2.11.0, focusing on improving stability and fixing errors that affected image handling, redirects, and content organization. The update resolves issues with responsive images for .ico files, fixes uncaught exceptions from image fetches, ensures custom redirects properly forward URL hashes, and corrects a 500 error that occurred with content not assigned to collections.

Highlight of the Release

• Fixed custom redirects to properly forward URL hashes/fragments
• Resolved 500 errors for content not assigned to collections (now returns appropriate 404)
• Improved handling of .ico files in responsive images
• Fixed uncaught exceptions when fetching images

Migration Guide

No migration steps are required for this update. Ghost 2.11.1 is a minor bug fix release that can be installed directly over Ghost 2.11.0 without any special migration procedures.

To update:

1. Back up your Ghost installation
2. Follow the standard Ghost update procedure for your installation method
3. No configuration changes or database migrations are needed

Upgrade Recommendations

Priority: Medium

This update is recommended for all Ghost 2.11.0 users as it fixes several bugs that could impact site functionality and user experience:

• If you're experiencing issues with custom redirects not preserving URL fragments, content errors, or image processing problems, upgrading is highly recommended.
• Even if you haven't encountered these specific issues, upgrading is advised to prevent potential problems.
• As this is a patch release (2.11.0 → 2.11.1), the upgrade should be straightforward with minimal risk.

Follow your standard Ghost update procedure based on your installation method (Docker, direct install, Ghost CLI, etc.).

Bug Fixes

Custom Redirects Hash Forwarding

• Fixed an issue where custom redirects weren't properly forwarding URL hashes/fragments (#10319)
• Ensures that anchor links in redirected URLs work as expected

Content Collection Errors

• Fixed a 500 "Resource Not Found" error that occurred when accessing content not assigned to any collection
• Now correctly returns a 404 error instead, properly indicating that this is a content configuration issue rather than a server error
• Improves error clarity for misconfigured content or collections

Image Processing Improvements

• Fixed uncaught exceptions that occurred during image fetches (#10383)
• Upgraded the 'got' package to version 8.3.2 which includes better error handling
• Added compatibility fix to hardcode 'http://' for xmlrpc due to breaking changes in the 'got' package (now defaults to https)

Responsive Images for ICO Files

• Fixed an issue with responsive image handling for .ico files (#10301)
• Added special handling for .ico files which cannot be resized like standard image formats
• Ensures proper display of favicon and other icon files

New Features

No new features were introduced in this maintenance release. Ghost 2.11.1 focuses exclusively on bug fixes and stability improvements to address issues discovered in version 2.11.0.

Security Updates

No security fixes were explicitly mentioned in this release. The changes were focused on bug fixes and stability improvements rather than addressing security vulnerabilities.

Performance Improvements

No specific performance improvements were included in this release. The focus was on bug fixes and stability rather than performance enhancements.

Impact Summary

Ghost 2.11.1 is a targeted bug fix release that addresses several specific issues affecting the platform's stability and functionality. The most significant impact is on sites using custom redirects with URL fragments, those with content organization issues, and those utilizing .ico files or external image fetching.

The fixes for custom redirects ensure that URL fragments (hash components) are properly preserved when redirecting users, maintaining the intended user experience when linking to specific sections of pages. The correction of the 500 error for content without collections improves error handling and provides clearer feedback about content configuration issues.

Image processing improvements address two specific pain points: the handling of .ico files (which have special requirements and cannot be resized like standard images) and uncaught exceptions during image fetches that could potentially disrupt site operations.

While these changes are relatively minor in scope, they collectively improve the reliability and user experience of Ghost installations, particularly for content creators and site administrators who may have been encountering these specific issues.

Full Release Notes