Ghost Release: 2.35.0

TL;DR

Ghost 2.35.0 Release

Ghost 2.35.0 fixes critical bugs from previous versions that could cause content loss in markdown cards. It also introduces member notes functionality, adds reading time property to posts/pages, and improves URL handling. This release is essential for anyone using markdown cards created in older Ghost versions (0.x/1.x) and brings useful enhancements for member management.

Highlight of the Release

• Fixed critical bug that could cause content loss in markdown cards created in Ghost 0.x or 1.x
• Added member notes functionality for better member management
• Added reading_time property to post/page resources in Content API
• Improved URL handling to prevent duplicate hosts in URLs

Migration Guide

Member Schema Changes

If you're directly interacting with the members database or API:

• The members table now has a new note column
• The name field validation has been updated to remove the minimum length requirement
• Member creation and update functions now default falsy name and note values to null

API Changes

• The members endpoint has been removed from admin v2 API
• Post and page resources in the Content API now include a reading_time property

No breaking changes were introduced that would require significant migration efforts.

Upgrade Recommendations

Priority: High

This release fixes a critical bug that could result in content loss when editing posts with markdown cards created in Ghost 0.x or 1.x. If you're using Ghost 2.32 through 2.34 and have content with markdown cards from older versions, upgrading to 2.35.0 is strongly recommended.

The upgrade process should be straightforward with no breaking changes reported. As always, it's recommended to:

1. Back up your database before upgrading
2. Test the upgrade in a staging environment if possible
3. Follow the standard Ghost upgrade process

Bug Fixes

Critical Fixes

• Fixed content loss in markdown cards: Resolved a critical bug that could result in content being lost when editing posts with markdown cards created in Ghost 0.x or 1.x. The issue was related to how the card-markdown alias was handled during URL transformations.

• Fixed characters being lost at the end of markdown card content: Bumped @tryghost/url-utils with relevant fix to prevent character loss.

Other Fixes

• Fixed duplicated host in URLs: Resolved an issue where URLs returned from the API when saved as relative could contain duplicate hosts (e.g., http://mysite.com/http://mysite.com/item-path/relative-path).

• Fixed unsafeAttributes fetching in Admin API v2: Implemented a missing check that was previously only implemented for canary.

• Fixed URL utils errors: Resolved errors thrown from urlUtils method calls where the itemPath parameter was not passed.

New Features

Member Notes

Ghost now supports adding notes to member profiles. This feature allows administrators to keep track of important information about members:

• Added a note column to the members table
• Included note field in CSV import/export functionality
• Updated member JSON schema to include the note property
• Wired up the note property to the members-API

Reading Time for Posts and Pages

The Content API now includes a reading_time property for post and page resources, making it easier to display estimated reading times for your content.

Security Updates

No specific security fixes were mentioned in this release.

Performance Improvements

Query Improvements

• Decoupled add from importCSV queries for better performance and maintainability

Code Optimizations

• Removed unused stripe_customers relationship
• Updated create, get & update member functions to async functions
• Defaults falsy name and note to null for better data consistency

Impact Summary

Ghost 2.35.0 addresses a critical content-loss bug affecting markdown cards created in older Ghost versions. This fix is essential for preserving content integrity when editing posts with these cards.

The release also introduces member notes functionality, allowing administrators to store additional information about members directly in Ghost. This feature enhances member management capabilities without requiring external tools.

The addition of reading time to post/page resources in the Content API provides a useful metric for themes and frontends without requiring custom calculation.

URL handling improvements fix issues with duplicate hosts in relative URLs, ensuring proper link formatting throughout the platform.

Overall, this release combines critical bug fixes with useful enhancements that improve content management, member administration, and developer experience.

Full Release Notes