GhostRank
Docs and help

A docs surface that starts with architecture honesty

The help experience should teach people how to choose the right publish path, what the billing model actually means, and how the workflow behaves after they click publish.

Launch checklist

  • Connect one website to a verified publish destination
  • Create and refine the first article draft
  • Confirm how draft versus live publishing behaves on your stack
  • Verify credits, purchases, and subscription state in one place

Quick start

Connect your site in the right way for your stack

The fastest path depends on how your site is built. These guides help you pick the right connection and get your first article published without guesswork.

  • Using WordPress, Webflow, Shopify, Wix, or Ghost? A native adapter is ready to connect
  • Custom site? The secure webhook lane now ships a shared webhook contract package plus Next.js, Astro, and Remix starter kits aligned to the live GhostRank contract
  • Static site or headless CMS? Step-by-step guides cover the most common setups

Billing and credits

Understand your credits before you publish

See exactly what you have, what each action costs, and how to buy more — all in one place with a clear history.

  • Separate balances for AI writing credits and backlink credits
  • Full purchase and usage history — nothing approximate
  • Backlink refunds processed automatically when a placement fails

Publishing

Know exactly what happens when you press publish

From the moment you trigger a publish to the delivery confirmation — here is what the platform does, and what to expect when something goes wrong.

  • How credentials and permissions are checked before delivery starts
  • What happens when a publish fails, and how automatic retries work
  • How draft and live publishing behaves on each supported platform
Setup recipes

Step-by-step guides for connecting your stack

Pick the framework or CMS you use, follow the steps, and verify the connection before publishing your first article. Each recipe maps to a shipped publish lane.

Native adapter

WordPress

Beginner

Connect your WordPress site directly and publish articles as drafts or live posts — no webhooks, no code changes.

  1. 1.Open Integrations for the website in GhostRank and select WordPress.
  2. 2.Enter your WordPress site URL and an application password (Settings → Users → Application Passwords).
  3. 3.Save the connection and run verification — GhostRank checks credentials before anything publishes.
  4. 4.Create or generate an article, complete the review, and hit Publish. Choose draft or live at publish time.

Best for: Teams running a WordPress blog who want direct draft/live publishing with credential verification.

Native adapter

Webflow

Beginner

Push articles into any Webflow CMS collection with control over staged versus live publishing.

  1. 1.Open Integrations and select Webflow.
  2. 2.Paste your Webflow API token, site ID, and collection ID.
  3. 3.Map the content field key to the CMS collection field that holds article HTML.
  4. 4.Verify the connection, then publish articles as staged or live items.

Best for: Marketing teams using Webflow CMS who want collection-level control and published-URL tracking.

Native adapter

Shopify

Beginner

Send blog articles to your Shopify store in draft or live mode, with update support across content runs.

  1. 1.Open Integrations and select Shopify.
  2. 2.Enter your myshopify.com domain, access token, and blog ID.
  3. 3.Verify the connection so GhostRank confirms the store and blog exist.
  4. 4.Publish articles — each delivery records the Shopify post ID for future updates.

Best for: E-commerce teams who publish SEO content to a Shopify blog alongside their store.

Secure webhook

Next.js (webhook)

Intermediate

Receive article payloads in a Next.js App Router route handler and store them in your own database.

  1. 1.Create a route handler at /api/webhooks/ghostrank in your Next.js project.
  2. 2.Verify the bearer token from the Authorization header against the shared secret you configure in GhostRank.
  3. 3.Parse the article payload (title, slug, HTML, metadata) and write it into your content database.
  4. 4.Open Integrations in GhostRank, select Secure Webhook, enter the handler URL and auth token, and verify.
  5. 5.Publish an article — GhostRank delivers the payload, records the response, and retries on transient failures.

Best for: Next.js teams who own their content database and want full control over how articles land in the app.

Revalidation trigger

Next.js (revalidation)

Intermediate

After a publish, trigger on-demand revalidation of specific paths or tags so your ISR or hybrid site picks up the new content.

  1. 1.Create a revalidation endpoint in your Next.js project (e.g., /api/revalidate).
  2. 2.Accept a secret token and the target path or tag from the request body.
  3. 3.Call revalidatePath or revalidateTag inside the handler.
  4. 4.Open Integrations in GhostRank, select Revalidation Trigger, enter the endpoint URL, and verify.
  5. 5.When an article is published, GhostRank hits the endpoint and your site rebuilds the affected pages.

Best for: Next.js ISR or hybrid sites where content is already stored and publishing means refreshing the cache.

Secure webhook

Astro (webhook)

Intermediate

Receive article payloads in an Astro server endpoint and trigger a rebuild or store the content.

  1. 1.Add a server endpoint (e.g., src/pages/api/ghostrank.ts) in your Astro project.
  2. 2.Validate the bearer token, parse the article payload, and write to your data store or trigger a deploy webhook.
  3. 3.Open Integrations in GhostRank, select Secure Webhook, enter the endpoint URL and auth token, and verify.
  4. 4.Publish an article — the delivery hits your endpoint and either stores content or kicks off a rebuild.

Best for: Astro content sites that store articles in a database or trigger static rebuilds on publish.

Headless CMS bridge

Headless CMS (Contentful)

Intermediate

Send articles into Contentful so your existing frontend keeps reading from the same content source.

  1. 1.Open Integrations and select Headless CMS.
  2. 2.Enter your Contentful space ID, environment, content type ID, and management API token.
  3. 3.Map the GhostRank article fields to Contentful entry fields.
  4. 4.Verify the connection — GhostRank checks credentials and the content type exists.
  5. 5.Published articles create or update Contentful entries with the CMS entry ID saved as a durable receipt.

Best for: Teams with a Contentful-backed frontend who want to keep content ownership in the CMS while generating articles in GhostRank.

Git / PR publishing

Docs / MDX repos

Advanced

Publish articles as Markdown or MDX files in a GitHub repository via branch and pull request, so your team can review the diff before merge.

  1. 1.Open Integrations and select Git / PR.
  2. 2.Enter the GitHub repository owner, name, base branch, content directory, and a personal access token with repo scope.
  3. 3.Verify the connection — GhostRank confirms the repo and branch exist.
  4. 4.When you publish an article, GhostRank creates a branch, commits the Markdown file, and opens a pull request.
  5. 5.Your team reviews the PR in GitHub. Merging triggers your existing CI/CD pipeline to deploy.

Best for: Docs sites, MDX blogs, and compliance-heavy teams who want human review in GitHub before content goes live.

Support posture for launch

Guide first

Start with opinionated setup guides for CMS and TypeScript-site teams before expanding into a full docs IA.

Safety language

Explain retries, verification, idempotency, and credit grants in plain language so customers know what the automation is doing.

Help customers self-select

The best docs reduce misconfigured integrations by helping teams choose the correct lane before they ever paste a token.