Home

>

Tools

>

Ghost

>

Releases

>

4.23.0

Ghost Release: 4.23.0

Tag Name: v4.23.0

Release Date: 11/25/2021

Ghost LogoGhost

Open-source publishing platform specifically designed for professional bloggers and publications. Focuses on clean, minimalist writing and publishing experience.

TL;DR

Ghost v4.23.0 brings important bug fixes for embedding content and offer management. The release addresses issues with the oembed service that were causing errors to be swallowed and fixes intermittent failures with embedding content. Additionally, it introduces a 40-character limit for offer names to ensure compatibility with Stripe coupon naming restrictions. These changes improve the reliability of content embedding and prevent potential issues when creating promotional offers.

Highlight of the Release

    • Fixed errors being swallowed in the oembed service, improving error reporting
    • Resolved intermittent failures with content embedding by reverting oembed-parser to version 1.4.9
    • Restricted offer names to 40 characters to ensure compatibility with Stripe coupon naming limits

Migration Guide

Offer Name Length Restriction

If you've been creating offers with names longer than 40 characters, be aware that:

  1. Existing offer names that exceed 40 characters have been automatically truncated
  2. New offers will now enforce a 40-character limit on names
  3. This change ensures compatibility with Stripe's coupon name limitations

No manual migration steps are required as the database migration will handle truncating existing offer names automatically.

Upgrade Recommendations

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

  • Use embedded content in their posts and pages
  • Have experienced intermittent failures with content embedding
  • Create and manage promotional offers through the Ghost admin interface

The upgrade addresses important bug fixes that improve the reliability of content embedding and ensures compatibility with Stripe for offer management.

Bug Fixes

Embedding Fixes

  • Fixed an issue where errors were being swallowed in the oembed service due to incorrect error handling after switching to async/await
  • Improved error logging by adding clearer messages when embedding fails
  • Resolved intermittent failures with embedding content by reverting the oembed-parser dependency from version 1.5.2 to 1.4.9
  • Added the oembed-parser package to Renovate's ignore list to prevent automatic updates that might reintroduce the issue

Offer Management Fixes

  • Restricted offer names to a maximum of 40 characters to match Stripe's coupon name limit
  • Added a migration to automatically truncate existing offer names that exceed 40 characters
  • Ensured consistent naming between Ghost offers and their corresponding Stripe coupons

New Features

No significant new features were introduced in this release. The changes focus on bug fixes and compatibility improvements.

Security Updates

No security fixes were included in this release.

Performance Improvements

No specific performance improvements were included in this release.

Impact Summary

Ghost v4.23.0 focuses on fixing two key issues that impact content creators and site administrators.

First, it addresses problems with the oembed service that were causing errors to be silently ignored and intermittent failures when embedding external content. By reverting to a more stable version of the oembed-parser dependency and improving error handling, content embedding should now be more reliable.

Second, it introduces a 40-character limit for offer names to ensure compatibility with Stripe's coupon naming restrictions. This change includes a migration that automatically truncates any existing offer names that exceed this limit.

While these changes don't introduce new features, they significantly improve the reliability of existing functionality and prevent potential issues when working with embedded content and promotional offers.

Full Release Notes

Statistics:

File Changed6
Line Additions119
Line Deletions52
Line Changes171
Total Commits6

User Affected:

  • More reliable embedding of external content in posts and pages
  • Fewer intermittent failures when embedding content from external sources
  • Better error reporting when embedding fails

Contributors:

kevinansfielddaniellockyerallouis