Ghost Release: 4.9.3

TL;DR

Ghost v4.9.3 - Bug Fix Release

This minor release fixes a critical bug that was causing "Cannot destructure property" errors when users attempted to overwrite their active theme. The fix addresses issues with theme activation and error handling, ensuring that theme uploads complete successfully without hidden errors.

Highlight of the Release

• Fixed critical 'Cannot destructure property' error when overwriting active themes
• Improved error handling for theme uploads
• Corrected method name from activator.activateFromOverride to activator.activateFromAPIOverride

Migration Guide

No migration steps are required for this update. This is a drop-in bug fix release that resolves theme activation issues without requiring any changes to your existing setup.

Upgrade Recommendations

This update is highly recommended for all Ghost users who work with custom themes or frequently update their themes, as it fixes a critical bug in the theme activation process.

The update is straightforward with no breaking changes or migration steps required. You can upgrade using your standard update process:

ghost update

If you're using Ghost(Pro), your site will be updated automatically.

Bug Fixes

Theme Activation Fixes

• Fixed "Cannot destructure property" error that occurred when attempting to overwrite an active theme
• Added missing throw error statement in the setFromZip() catch block that was previously hiding underlying errors when a theme uploaded and saved successfully but other code failed
• Corrected incorrect method name from activator.activateFromOverride to activator.activateFromAPIOverride

These fixes address the issue reported in TryGhost/action-deploy-theme#45.

New Features

No new features were added in this release. This is a bug fix release focused on resolving theme activation issues.

Security Updates

No security fixes were included in this release.

Performance Improvements

No specific performance improvements were included in this release. The focus was on fixing critical bugs related to theme activation.

Impact Summary

This release fixes a critical bug in Ghost's theme management system that was causing errors when overwriting active themes. The issue was related to improper error handling and an incorrect method name in the theme activation process.

The fix ensures that:

1. Proper error messages are displayed when theme uploads fail
2. The correct activation method is called when overwriting themes
3. Underlying errors are no longer hidden when theme uploads partially succeed

This update is particularly important for theme developers and site administrators who frequently update or switch themes. The fix improves the reliability of theme management in Ghost and prevents frustrating errors during theme updates.

Full Release Notes