Ghost Release: 5.70.2

TL;DR

Ghost v5.70.2 fixes a critical bug that prevented multiple image uploads from working properly in custom theme settings. This patch ensures theme developers and site administrators can now successfully upload and manage multiple images in their custom theme configurations without encountering errors.

Highlight of the Release

• Fixed bug preventing multiple image uploads in custom theme settings
• Improved naming convention and reduced duplication in ImageUpload component
• Enhanced theme settings UI functionality

Migration Guide

No migration steps are required for this update. This is a patch release that fixes a bug without introducing any breaking changes or requiring configuration updates.

Simply update to v5.70.2 to benefit from the fixed image upload functionality in custom theme settings.

Upgrade Recommendations

This update is recommended for all Ghost users who utilize themes with multiple custom image settings.

The patch is particularly important for:

• Sites using themes that implement multiple image uploads in their settings
• Theme developers who create or maintain themes with multiple image customization options

As this is a minor patch release with no breaking changes, upgrading should be straightforward and low-risk.

Bug Fixes

Fixed custom setting image upload for multiple images

This release addresses an issue where uploading multiple images in custom theme settings was failing. The bug was caused by duplicate id properties in the ImageUpload component within ThemeSettings.tsx.

The fix refactors the id prop of the ImageUpload component to:

• Avoid duplication that was causing conflicts
• Follow proper naming conventions
• Ensure each image upload field has a unique identifier

This resolves issue #18718 where users were unable to upload multiple images in theme settings.

New Features

No new features were introduced in this patch release. This update focuses exclusively on fixing the bug related to multiple image uploads in custom theme settings.

Security Updates

No security fixes were included in this patch release.

Performance Improvements

No specific performance improvements were included in this patch release. The changes were focused on bug fixes rather than performance enhancements.

Impact Summary

This patch release fixes a specific but important bug affecting theme customization. The impact is primarily positive for theme developers and site administrators who work with custom theme settings that include multiple image uploads.

The fix improves the reliability of the theme settings interface, ensuring that all image upload fields work correctly. This enhances the overall user experience when customizing themes and allows theme developers to create more robust customization options without worrying about upload failures.

While the change is relatively small in scope (only affecting 3 files with 6 total changes), it resolves a frustrating issue that could prevent proper theme configuration and customization.

Full Release Notes