Ghost Release: 5.33.2

TL;DR

Ghost v5.33.2 fixes a critical issue with the {{price}} helper that previously caused page rendering errors when price data was empty. Now, instead of throwing an error, the helper will render an empty string, following the same pattern used by other helpers like {{img_url}} and {{url}}. This change improves site stability by preventing crashes on pages that use the price helper with missing data.

Highlight of the Release

• Fixed {{price}} helper to render empty instead of throwing errors when price data is missing
• Downgraded the 'GS090-NO-PRICE-DATA-CURRENCY-CONTEXT' rule in gscan to non-fatal
• Improved consistency with other helpers like {{img_url}} and {{url}} that already follow this pattern

Migration Guide

No migration steps are required for this release. The fix for the {{price}} helper is backward compatible and will automatically improve the behavior of existing themes and content that use the price helper.

Upgrade Recommendations

This release is recommended for all Ghost users, especially those using themes that include the {{price}} helper. The update improves site stability by preventing page rendering errors when price data is missing.

Upgrading to v5.33.2 is straightforward and should not cause any disruption to your site. As always, it's recommended to backup your Ghost installation before upgrading.

Bug Fixes

Fixed {{price}} helper error handling

The {{price}} helper has been updated to handle cases where price data is empty or missing. Previously, using the helper with empty price data would throw an error and cause page rendering to fail. Now, it will render an empty string instead.

This fix specifically addresses scenarios like using legacy syntax such as {{price [email protected]}} when price data is not available. Instead of causing a page render error, the helper will now return an empty price string.

This change brings the {{price}} helper in line with other helpers like {{img_url}} and {{url}} which already follow the pattern of returning an empty string instead of crashing when data is missing.

New Features

No new features were introduced in this release.

Security Updates

No security fixes were included in this release.

Performance Improvements

No specific performance improvements were included in this release.

Impact Summary

This release focuses on improving the robustness of Ghost's templating system by fixing how the {{price}} helper handles missing data. The change prevents page rendering errors that could previously occur when price data was empty or missing, which enhances overall site stability.

The fix is particularly important for sites using themes that include price helpers, especially with legacy syntax patterns. By making the {{price}} helper more resilient and consistent with other helpers, this update reduces the likelihood of visitors encountering broken pages due to template rendering errors.

This change also makes theme development more forgiving, as developers no longer need to implement special checks to handle cases where price data might be missing.

Full Release Notes