Home

>

Tools

>

Ghost

>

Releases

>

3.29.2

Ghost Release: 3.29.2

Tag Name: 3.29.2

Release Date: 8/18/2020

Ghost LogoGhost

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

TL;DR

Ghost 3.29.2: Bug Fix Release

This patch release addresses several important bugs affecting email rendering, structured data, collections metadata, and database migrations. Key improvements include fixing apostrophe display in Outlook emails, removing unwanted URL text in email previews, optimizing Stripe JS loading, and resolving metadata issues with tag-based collections. This release ensures better compatibility with email clients and fixes a critical migration issue from older Ghost versions.

Highlight of the Release

    • Fixed apostrophes not displaying correctly in Outlook for member emails
    • Removed unwanted [http://url/] output in member email preview text
    • Updated Stripe JS to load asynchronously for better performance
    • Fixed metadata when using tag data in collections
    • Fixed published time and modified time for structured data on pages
    • Fixed failing database migration from Ghost versions <2.34 to 3.29

Migration Guide

No specific migration steps are required for this update. This release actually fixes a migration issue, making it easier to upgrade from older Ghost versions (pre-2.34) to version 3.29+.

Simply update to Ghost 3.29.2 using your standard update process:

ghost update

Or if using Docker:

docker pull ghost:3.29.2

Upgrade Recommendations

This update is highly recommended for all Ghost users, especially for:

  • Sites that send member emails, as it fixes important email rendering issues
  • Sites using tag-based collections
  • Anyone upgrading from Ghost versions older than 2.34
  • Sites using Stripe for memberships

The release contains no breaking changes and addresses several important bugs that affect email delivery, site performance, and upgrade paths from older versions.

Bug Fixes

Email Rendering Improvements

  • Fixed apostrophes in Outlook emails: Resolved an issue where apostrophes weren't displaying correctly in Outlook for member emails. The fix replaces &#apos; with &#39; which is better supported by Outlook.

  • Removed unwanted URL text in email previews: Fixed an issue where email preview text would show [http://url/] when using post excerpts. The email serializer now removes these URL references from the preview text.

Metadata and Structured Data Fixes

  • Fixed metadata for tag-based collections: Resolved an issue where metadata was not correctly applied when using a tag as a data source for collections. The context array now properly includes 'tag'.

  • Fixed structured data timestamps for pages: Published time and modified time were not populating correctly in structured data for pages. This has been fixed by using the common contextObject and getContextObject utility.

Technical Fixes

  • Fixed database migration issue: Resolved a critical bug that prevented migrations when upgrading from Ghost versions older than 2.34 to 3.29. The issue was caused by a variable name mismatch when checking for an existing unique index.

New Features

No new features were introduced in this patch release. This is a bug fix and performance improvement release.

Security Updates

No security fixes were included in this release.

Performance Improvements

Performance Enhancements

  • Async loading of Stripe JS: Updated Stripe JavaScript to load asynchronously in the head section when a Stripe account is connected to a members-enabled site. This prevents blocking the main thread during page rendering, resulting in faster page loads.

  • Optimized script loading: The Stripe script now uses the async attribute while the Members script continues to use defer, ensuring optimal loading behavior for both scripts without blocking page rendering.

Impact Summary

Ghost 3.29.2 is a targeted bug fix release that addresses several important issues affecting email rendering, metadata handling, and database migrations.

The email-related fixes ensure that newsletters sent to members will display correctly across email clients, particularly in Outlook where apostrophes were previously broken. The removal of unwanted URL text in email previews also improves the professional appearance of emails in subscribers' inboxes.

Performance improvements come from the async loading of Stripe JS, which prevents render blocking and improves page load times for sites with Stripe integration.

For content creators, the fixes to metadata handling in tag-based collections and structured data for pages ensure better SEO and content discovery.

Perhaps most critically, this release fixes an important database migration issue that prevented some users from upgrading from older Ghost versions (pre-2.34) to version 3.29, ensuring smoother upgrade paths for all users.

Overall, while this is a minor patch release, it addresses several quality-of-life issues that improve the reliability and compatibility of the Ghost platform.

Full Release Notes

  • 🐛 Fixed failing migration from <2.34 to 3.29 - Kevin Ansfield
  • 🐛 Fixed published time and modified time for structured data (#12085) - Roshan Dash
  • 🐛 Fixed meta data when using tag data in collection (#12137) - Fabien 'egg' O'Carroll
  • 🐛 Removed [http://url/] output in member email preview text - Kevin Ansfield
  • 🐛 Fixed apostrophes not displaying correctly in Outlook for member emails - Kevin Ansfield

See the changelogs for Ghost and Ghost-Admin for the details of every change in this release.

Statistics:

File Changed10
Line Additions72
Line Deletions16
Line Changes88
Total Commits8

User Affected:

  • Can now successfully upgrade from Ghost versions older than 2.34 to 3.29+
  • Will see improved site performance due to async loading of Stripe JS

Contributors:

kevinansfieldrshbhgrgallouisroshandash411daniellockyer