Ghost Release: 3.20.2

TL;DR

Ghost 3.20.2: Bug Fix Release

This minor release fixes an issue with incorrect save warnings appearing in the design settings of the Ghost Admin interface. It also includes improvements to the Admin API by allowing the ?formats parameter in post and page create/edit requests, and fixes an issue with image size population when forcing re-renders of posts.

Highlight of the Release

• Fixed incorrect save warning on design settings
• Added support for ?formats parameter in Admin API post and page create/edit requests
• Fixed image size population when forcing re-render of posts

Migration Guide

No migration steps are required for this release. This is a minor bug fix release that can be installed without any special considerations.

Upgrade Recommendations

This is a minor bug fix release that addresses UI issues and improves the Admin API functionality. We recommend all users upgrade to benefit from these fixes, especially if you:

• Use the design settings in Ghost Admin
• Work with the Admin API for content creation or editing
• Have experienced issues with image size population in posts

The upgrade process is standard and should not cause any disruption to your site.

Bug Fixes

UI Fixes

• Fixed incorrect save warning appearing on design settings
  • Users will no longer see false warnings about unsaved changes
  • Improves the reliability of the admin interface

Content Rendering Fixes

• Fixed population of image sizes when forcing re-render of posts
  • Corrected an incorrect method name call
  • Fixed an issue where post.mobiledoc was being set to a promise instead of waiting for the size population to complete
  • Ensures proper rendering of images with correct size information

New Features

Admin API Enhancement

• Added support for the ?formats parameter in Admin API post and page create/edit requests
  • This allows developers to get HTML content back directly from create/edit operations
  • Eliminates the need for a subsequent GET request to retrieve formatted content
  • Improves efficiency for API workflows that need formatted content immediately after editing

Security Updates

No security fixes were included in this release.

Performance Improvements

API Performance

• The new ?formats parameter for the Admin API reduces the number of API calls needed when creating or editing content that requires formatted output
• Fixed image size population ensures more reliable content rendering without unnecessary re-processing

Impact Summary

Ghost 3.20.2 is a maintenance release focused on fixing UI issues and improving developer experience. The fix for incorrect save warnings in design settings will improve the admin user experience by eliminating false notifications. Developers will benefit from the new ?formats parameter in the Admin API, allowing more efficient content operations. The image size population fix ensures more reliable content rendering. Overall, this release enhances stability and usability without introducing breaking changes.

Full Release Notes