●Change8

Migrating to Ghost v6.0.0

Version v6.0.0 introduces 9 breaking changes. This guide details how to update your code.

Released: 8/4/2025

9
Breaking Changes
6
Migration Steps
7
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

{{#get}} helperAPI requests limit parameterpost/page webhook payloadsGET /session/theme file serving logicAMP implementationdata payloads (for created_by/updated_by removal)

Breaking Changes

●Issue #1

Removed serving files without an extension from themes.

●Issue #2

Removed `mobiledoc` field from post/page webhook payloads. Consumers relying on this field must update.

●Issue #3

Removed GET /session/ endpoint. Clients must use alternative authentication/session management methods.

●Issue #4

Enforced a maximum `limit` of 100 in the `{{#get}}` helper. Queries exceeding this limit will be truncated.

●Issue #5

Enforced a maximum `?limit` of 100 in API requests. Requests exceeding this limit will be truncated.

●Issue #6

Removed AMP (Accelerated Mobile Pages) support from the core application.

●Issue #7

Removed `updated_by` and `created_by` fields from data payloads. Consumers relying on these fields must update.

●Issue #8

Removed support for Node.js v20.

●Issue #9

Removed support for Node.js v18.

Migration Steps

  1. 1
    Review theme code to ensure files being served have extensions, as serving files without extensions is now blocked.
  2. 2
    Update any integrations or scripts that relied on the `mobiledoc` field in webhook payloads.
  3. 3
    Update clients to use alternative endpoints instead of GET /session/.
  4. 4
    Ensure all `{{#get}}` helper calls and API requests use a `limit` parameter of 100 or less.
  5. 5
    Remove any logic dependent on the `updated_by` and `created_by` fields being present in data structures.
  6. 6
    Upgrade your Node.js environment to a supported version (e.g., Node.js v22 or newer, as v18 and v20 are removed).

Release Summary

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

Need More Details?

View the full release notes and all changes for Ghost v6.0.0.

View Full Changelog