Compatibility

Meridian requires Ghost v6.0.0 or later. How to check your Ghost version, what self-builders need, and answers to common compatibility questions.

Using Ghost(Pro) or managed hosting?

If you use Ghost(Pro) or another managed Ghost hosting provider (such as MagicPages, Midnight, DigitalPress, Synaps Media, Gloat, etc.), your Ghost version is always kept up to date automatically. You can safely install the latest Meridian version without worrying about compatibility.

Ghost version requirement

Meridian requires Ghost v6.0.0 or later. Only the latest version of Meridian is distributed, so there's no version to choose — keep your Ghost installation up to date and always install the newest Meridian.

Ghost v5.x is not supported

Meridian declares Ghost v6.0.0 or later as a hard requirement. Ghost itself will refuse to activate the theme on a Ghost v5.x installation. If you're still on Ghost v5.x, upgrade your Ghost installation before installing Meridian.


How to check your Ghost version

Not sure which Ghost version you're running? Follow these steps:

Log in to your Ghost Admin panel (typically at your-site.com/ghost).

Click on the gear icon (⚙️) at the bottom of the left sidebar to open Settings.

Scroll down to the very bottom of the settings page and look for the About section. Your Ghost version number is displayed there (e.g., Ghost v6.0.0).


Build requirements (developers only)

If you plan to rebuild Meridian from source — for example to customize design tokens or partials — you'll also need:

  • Node.js v22.12.0 or later
  • Yarn (any recent v1.x)

These are only needed when running yarn dev / yarn build / yarn zip against the source. Site editors uploading the pre-built meridian.zip to Ghost Admin do not need Node or Yarn installed anywhere.

See For developers for the full build workflow.


Frequently asked questions


Keeping everything up to date

For the best experience, we recommend keeping both your Ghost installation and your Meridian theme up to date. Check the Changelog regularly for new releases, and refer to this page whenever you're upgrading to make sure your versions are compatible.