Ghost Release: 1.18.1

TL;DR

Ghost 1.18.1: Improved Error Handling & Critical Bug Fixes

This maintenance release focuses on improving error handling across Ghost and fixing several critical bugs that were causing 500 errors in specific scenarios. Key improvements include better handling of file storage errors, pagination misuse, and fixes for URL encoding issues. The update also includes several dependency bumps to keep the platform secure and performant. This release is particularly important for sites using custom themes, URL structures with primary tags, or those running on Windows 10 with Edge browser.

Highlight of the Release

• Improved error handling for missing images on file storage, now returning proper 404 responses
• Fixed sitemap generation when permalinks contain primary tags
• Fixed import and redirect uploads for Windows 10/Edge users
• Better error messages for incorrect pagination helper usage
• Fixed 500 errors caused by invalid encoded URLs

Migration Guide

No migration steps are required for this maintenance release. The update focuses on bug fixes and error handling improvements that should work seamlessly with existing Ghost installations.

If you're developing custom themes, you may notice more helpful error messages when using the pagination helper incorrectly. These improved messages include links to documentation that can help resolve any issues.

Upgrade Recommendations

This release is highly recommended for all Ghost users, especially those:

• Running Ghost on Windows 10 with Edge browser
• Using custom themes with pagination
• Having permalinks that include primary tags
• Managing redirects through the admin interface

The bug fixes in this release address several issues that could cause 500 errors in production environments, so upgrading will improve the stability and reliability of your Ghost installation.

As this is a patch release (1.18.0 → 1.18.1), the upgrade should be straightforward with minimal risk of breaking changes.

Bug Fixes

Critical Bug Fixes

• Fixed Sitemap Generation: Resolved issues with sitemap generation when permalinks contain primary tags by including tags in the sitemap post-generator (#9273)

• Fixed Import and Redirect Uploads for Windows 10/Edge: Added text/plain to the allowed mime types for database and redirect uploads, fixing compatibility issues (#9267)

• Fixed 500 Errors for Invalid Encoded URLs: Now returns a proper 404 error instead of crashing with a 500 when URLs contain invalid encoded characters like /AF% (#9279)

• Fixed Error Handling for HTML Response: Resolved issues with error handling in AMP pages and templates with invalid Handlebars logic (#9280)

• Fixed Re-uploading Redirects: Resolved an issue preventing users from re-uploading the same redirects file (TryGhost/Admin#912)

• Fixed Error Attachment: Re-attached error objects to request objects when rendering error templates to ensure errors appear in logs

New Features

Enhanced Error Handling

This release doesn't introduce new features but significantly improves error handling throughout the platform:

• Better File Storage Error Handling: Now properly differentiates between missing images (404) and server errors (500)
• Improved Pagination Error Messages: Clearer guidance when pagination helper is used incorrectly, including help documentation links
• Enhanced Template Error Handling: Better management of errors in Handlebars templates, particularly for AMP pages

Security Updates

No specific security fixes were mentioned in this release. However, the dependency updates (particularly sanitize-html to 1.16.1) likely include security patches that help maintain the overall security posture of Ghost.

Performance Improvements

• Test Suite Optimization: Significantly reduced test execution times by:

  • Speeding up SchedulingDefault_spec.js unit test by reducing unnecessary timeouts
  • Ensuring tests exit properly in Travis CI environments
  • Updating test utilities to handle Promise and callback usage correctly

• Dependency Updates: Multiple dependency updates to improve performance and security:

  • Updated gscan to version 1.2.3
  • Updated sanitize-html to version 1.16.1
  • Updated eslint to version 4.12.0
  • Updated nock to version 9.1.3
  • Updated sqlite3 to version 3.1.13
  • Updated sinon to version 4.1.2
  • Updated should to version 13.1.3
  • Updated mocha to version 4.0.1
  • Updated various Grunt-related dependencies

Impact Summary

Ghost 1.18.1 is a maintenance release that significantly improves error handling throughout the platform. It addresses several critical bugs that were causing 500 errors in specific scenarios, making the CMS more robust and user-friendly.

The most notable improvements are in how Ghost handles edge cases: invalid URLs now return proper 404 errors instead of crashing, missing images on file storage return appropriate status codes, and template errors are handled more gracefully. These changes make Ghost more resilient in production environments.

For administrators, the fixes to import and redirect uploads on Windows 10/Edge are particularly valuable, removing a platform-specific limitation. Theme developers will benefit from clearer error messages when pagination is used incorrectly, and content creators will see more reliable sitemap generation.

While this release doesn't introduce new features, the comprehensive bug fixes and error handling improvements make it an important update for maintaining a stable Ghost installation.

Full Release Notes