---
title: "Ghost integration"
description: "Connect your Ghost site to publish, schedule and update articles from Rank Prompt, with their SEO fields, tags and images."
url: https://help.rankprompt.com/en/articles/107-ghost-integration
collection: "Integrations"
updated: 2026-11-17
language: en
---

# Ghost integration

Connect your Ghost site to publish, schedule and update articles from Rank Prompt, with their SEO fields, tags and images.

## What it does

Rank Prompt writes posts to your Ghost site through a custom integration. Each post carries its SEO title, meta description, social cards, excerpt, tags and feature image, and the article's structured data goes into the post's code injection. Images are copied to your Ghost site, so the post never depends on another server. Posts are never emailed to your members from here.

Each table in the article arrives as an HTML card in the Ghost editor, so it keeps its layout and scrolls sideways on a phone instead of widening the page.

You can publish now, schedule a date, save a draft for review, update a published post and remove it.

* * *

## What you need

-   Ghost 5 or later, on a public https address (Ghost(Pro) or self-hosted)
    
-   The Owner or an Administrator of the Ghost site, to add a custom integration
    
-   You must own the brand. Connecting works on every plan; publishing articles needs Starter or higher
    

* * *

## Connecting Ghost

1.  In Ghost Admin, open **Settings > Integrations**, click **Add custom integration**, name it "Rank Prompt" and copy the **Admin API key** (two parts joined by a colon, not the Content API key).
    
2.  In Rank Prompt, open **Integrations > Publish content**. In the **More platforms** card, click **Ghost**, or **+** (Connect a platform), pick **Ghost** and click **Continue**.
    
3.  Enter the **Site address**: the address you open Ghost Admin on, without `/ghost`.
    
4.  Paste the **Admin API key** and click **Continue**. Rank Prompt reads the site and its staff.
    
5.  Choose the author Ghost shows on every post, then click **Connect**.
    

The card now lists the site with the **Active** status. **Check connection** (the arrows) tests it again, and **Connection settings** (the gear) lets you change the key or the author, open Ghost or remove the connection.

* * *

## Publishing

Open an article, click **More actions** (the three dots) and **Publish**. Pick **Your Ghost** and choose **Publish**, a date under **Schedule**, or **Save as draft**. A scheduled post waits in Ghost as a draft and Rank Prompt publishes it at its time.

### Structured data

If your site already prints its own schema, open **Connection settings** (the gear) on the connection and switch off **Add structured data (JSON-LD)**, so no post carries it twice. Our structured data goes into each post's code injection; switch it off and the next update of a post clears it there. Only the brand owner changes it.

### Publishing settings

**Connection settings** (the gear) also holds the choices that apply to every post sent to the site. Only the brand owner changes them, on any plan.

-   **Featured image**: where the article's main image goes. **Only as the featured image** (the default) sends it as the post's featured image and leaves it out of the post body, since most themes print the featured image above the post. **Featured image and in the post** sends it both ways, and **Only in the post** sends no featured image. A site connected before 17 November 2026 keeps sending it both ways until you change it.
    
-   **Start every send as a draft**: the publish window opens with **Save as draft** on for this site, so your team reviews posts in Ghost first. You can still turn it off and publish live.
    
-   **Primary tag**: the tag every post leads with, which Ghost shows as its primary tag, among the site's public tags. Without a choice, the article's first tag leads.
    

A post already published takes a new choice the next time Rank Prompt updates it.

* * *

## Troubleshooting

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Message</p></th><th colspan="1" rowspan="1"><p>What to do</p></th></tr><tr><td colspan="1" rowspan="1"><p>The Ghost address must start with https://, since the Admin API key is sent with every call.</p></td><td colspan="1" rowspan="1"><p>Enter the https address of the site.</p></td></tr><tr><td colspan="1" rowspan="1"><p>This is not a Ghost Admin API key.</p></td><td colspan="1" rowspan="1"><p>Copy the Admin API key of a custom integration, not the Content API key.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Ghost refused the Admin API key.</p></td><td colspan="1" rowspan="1"><p>Copy the key again from Settings, Integrations and reconnect.</p></td></tr><tr><td colspan="1" rowspan="1"><p>This Ghost site is private (Settings, Access)</p></td><td colspan="1" rowspan="1"><p>Make the site public in Ghost, or search engines and AI platforms cannot read the posts.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Someone was editing this post in Ghost at the same time.</p></td><td colspan="1" rowspan="1"><p>Wait a minute and publish again.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Search engines are not told when you publish</p></td><td colspan="1" rowspan="1"><p>Ghost cannot serve an IndexNow key file, so Bing finds new posts on its own crawl. Nothing to fix.</p></td></tr></tbody></table>

A post deleted in Ghost is published again as a new post the next time you update it, and the article says so.

* * *

## Questions?

Email [support@rankprompt.com](mailto:support@rankprompt.com) and I'll help.
