v6.0.0-rc.0
Breaking Changes📦 ghostView on GitHub →
⚠ 9 breaking✨ 2 features🐛 1 fixes🔧 7 symbols
Summary
This major release introduces native Web Analytics and ActivityPub federation while removing deprecated features like AMP and older Node.js versions (v18, v20). Several breaking changes enforce limits on API/helper queries and remove specific fields from payloads.
⚠️ Breaking Changes
- Serving files without an extension from themes has been removed. Ensure all theme assets have correct extensions.
- The `mobiledoc` field has been removed from post/page webhook payloads. Consumers relying on this field must update.
- The GET /session/ endpoint has been removed. Clients should use alternative authentication/session management methods.
- The maximum value for `limit` in the `{{#get}}` helper is now strictly enforced at 100. Queries requesting more than 100 results will be capped.
- The maximum value for the `?limit` query parameter in API requests is now strictly enforced at 100. Requests exceeding this limit will be capped.
- AMP (Accelerated Mobile Pages) has been removed from the core application.
- The `updated_by` and `created_by` fields have been removed from data payloads.
- Support for Node.js v20 has been removed. Users must upgrade to Node.js v21 or newer.
- Support for Node.js v18 has been removed. Users must upgrade to Node.js v21 or newer.
Migration Steps
- Review webhook consumers to remove reliance on the `mobiledoc` field.
- Update any API clients or internal scripts that relied on the GET /session/ endpoint.
- Ensure all theme assets have file extensions.
- Update any usage of the `{{#get}}` helper or API calls using `?limit` to respect the new maximum limit of 100.
✨ New Features
- Added native Web Analytics integration using Tinybird.
- Implemented federated Ghost sites over ActivityPub, enabling social web interactions.
🐛 Bug Fixes
- Fixed an issue causing incorrect rendering of 404 errors for theme assets.