How to Connect Your Ghost Site to SEOmatic

Written By Minh

Last updated 1 day ago

Minimum Requirements

  • A Ghost site running version 5.0 or higher

  • Administrator access to your Ghost admin panel

Generating Your Admin API Key

Before connecting, you need to create a custom integration in Ghost.

  1. Log in to your Ghost admin panel (e.g. yoursite.ghost.io/ghost).

  2. Go to Settings > Integrations.

  3. Click "Add custom integration".

  4. Name it (e.g. "SEOmatic") and click "Create".

  5. Copy the Admin API Key. Save it somewhere secure.

Step 1: Go to Connections

In your SEOmatic dashboard, go to Connections from the sidebar (or click the "Missing connection" warning in the header if you see one).

Step 2: Enter Your Credentials

Click Connect Ghost and fill in your site domain (e.g. yoursite.ghost.io) and your Admin API Key from the integration you just created.

SEOmatic will automatically validate your credentials as you type.

Click Connect.

Step 3: You're Connected

On the Connections page, you should now see your Ghost site listed with a green "active" status - that means you're connected and ready to publish.

Troubleshooting

Problem

Solution

Invalid Admin API key format

The Admin API Key must be in the format id:secret — two values separated by a colon. Make sure you copied the full key from your Ghost integration settings.

Ghost Admin API not found

Double-check your domain. Make sure Ghost is installed and accessible at that address. Try visiting yoursite.ghost.io/ghost/api/admin/site/ in your browser to confirm.

Invalid Admin API key

Your key may have been regenerated or the integration deleted. Go back to Ghost Settings > Integrations, check your integration is still there, and copy the key again.

Failed to connect to Ghost

Your Ghost site may be down or unreachable. Try accessing it directly in your browser. If it loads fine, try again in a few minutes.