●Change8

v6.0.0-rc.1

Breaking Changes
📦 ghostView on GitHub →
⚠ 9 breaking✨ 2 features🐛 7 fixes🔧 8 symbols

Summary

This major release introduces native Web Analytics and ActivityPub support while enforcing strict limits on API/helper pagination and removing deprecated features like AMP and older Node.js versions.

⚠️ Breaking Changes

  • Serving files without an extension from themes has been removed. Themes must now use file extensions.
  • The `mobiledoc` field has been removed from post/page webhook payloads. Consumers relying on this field must update their logic.
  • The GET /session/ endpoint has been removed. Consumers should use alternative authentication/session management methods.
  • The maximum value for `limit` in the `{{#get}}` helper is now strictly enforced at 100.
  • The maximum value for the `?limit` query parameter in API requests is now strictly enforced at 100.
  • AMP (Accelerated Mobile Pages) has been removed from the core application.
  • The `updated_by` and `created_by` fields have been removed from relevant data structures.
  • Support for Node.js v20 has been removed.
  • Support for Node.js v18 has been removed.

Migration Steps

  1. Review webhook consumers to remove reliance on the `mobiledoc` field in post/page payloads.
  2. Update any code that relied on the GET /session/ endpoint.
  3. Ensure all theme assets have file extensions.
  4. If using API requests or `{{#get}}` helper with `limit` greater than 100, reduce the limit to 100 or less.
  5. Update Node.js environment to a supported version (e.g., Node.js v21 or newer, as v18 and v20 are removed).

✨ New Features

  • Added native Web Analytics integration using Tinybird.
  • Implemented federated Ghost sites over ActivityPub (Social web).

🐛 Bug Fixes

  • Fixed an issue where remote posts were not loading.
  • Updated styles for update email members' emails.
  • Fixed rendering issues for 404 errors related to theme assets.
  • Updated Portuguese (pt) translations for search, portal, ghost, and comments.
  • Updated pt-BR translations for Comments, Ghost, and Portal.
  • Updated Turkish translations for Comments.
  • Updated French translations for Comments, Ghost, and Portal.

Affected Symbols

{{#get}} helperAPI requests limit parameterpost/page webhook payloadsGET /session/AMP core functionalitydata fields (updated_by, created_by)Node.js v18Node.js v20