> ## Documentation Index
> Fetch the complete documentation index at: https://rankahead.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# CMS Integrations: Publish Blog Posts Directly

> Connect your CMS to Rankahead to publish AI-generated blog posts directly to your website. Supports multiple simultaneous CMS connections.

CMS integrations let you publish AI-generated blog posts from Rankahead directly to your website without manually copying content. Once you connect a CMS, any blog post in **DRAFT** status can be sent to your site in a single click. Rankahead supports multiple simultaneous CMS connections, so you can publish to different sites or platforms from the same account.

## How CMS integrations work

When you connect a CMS, Rankahead stores your credentials securely and uses them to authenticate publishing requests on your behalf. Your credentials are encrypted at rest and are never displayed in the Rankahead interface after the initial setup — not in connection lists, logs, or API responses.

When you publish a blog post, Rankahead sends the post content to your CMS via its API. The post appears on your website as a new entry in your CMS, ready to review, schedule, or go live depending on your CMS settings.

<Note>
  After a post is published to your CMS, Rankahead continues to track its Google Search Console performance. Clicks, impressions, CTR, and position data become available in the post detail view after GSC accumulates enough data — typically within a few days.
</Note>

## Connect a CMS

<Steps>
  <Step title="Open Settings">
    Navigate to **Settings** in the sidebar, then select **Integrations**.
  </Step>

  <Step title="Find the CMS integrations section">
    The Integrations page lists all available connection types. Locate the CMS platform you want to connect.
  </Step>

  <Step title="Add a connection">
    Click **Connect** next to your CMS platform. You'll be prompted to provide your credentials — typically an API key, site URL, or OAuth authorization depending on the platform.
  </Step>

  <Step title="Confirm the connection">
    Once your credentials are validated, the connection appears in your integrations list with an **Active** status. It is now available to use when publishing blog posts.
  </Step>
</Steps>

<Warning>
  Make sure the API key or credentials you provide have permission to create and publish posts on your CMS. Read-only credentials will cause publishing to fail.
</Warning>

## Manage active connections

You can view all your CMS connections from **Settings > Integrations**. Each connection shows:

* The platform type (e.g., WordPress, Webflow)
* Whether the connection is active or inactive

<Info>
  Credentials are never shown after initial setup. If you need to rotate an API key or update your credentials, remove the existing connection and add a new one with the updated details.
</Info>

You can have multiple active connections at the same time. This is useful if you manage content for multiple sites, publish to a staging environment before production, or use more than one CMS platform across your domains.

## Publish a blog post to your CMS

Once you have at least one active CMS connection, you can publish any draft post directly from the blog posts section.

<Steps>
  <Step title="Open the blog post">
    Go to **Content > Blog posts** and select the post you want to publish. The post must be in **DRAFT** status.
  </Step>

  <Step title="Review your content">
    Read through the generated content and make any edits you need before publishing. Once a post is published, you can no longer edit it inside Rankahead.
  </Step>

  <Step title="Open the publish panel">
    In the post detail view, locate the publish panel — typically on the right side of the editor.
  </Step>

  <Step title="Select a CMS connection">
    Choose which CMS connection to publish to from the dropdown. All your active connections are listed here.
  </Step>

  <Step title="Publish">
    Click **Publish**. Rankahead sends the post to your CMS and updates the post status to **PUBLISHED**.
  </Step>
</Steps>

<Tip>
  If you manage multiple domains, double-check that you're selecting the CMS connection that corresponds to the correct domain before publishing.
</Tip>

## After publishing

Once a post is published:

* The post appears in your CMS as a new content entry
* The post status in Rankahead changes to **PUBLISHED** and can no longer be edited in Rankahead
* Rankahead begins tracking the post's URL in Google Search Console
* GSC performance data — clicks, impressions, CTR, and position — appears in the post detail view after the page is indexed and data accumulates (usually 2–5 days)

<CardGroup cols={2}>
  <Card title="Blog posts" icon="file-text" href="/content/blog-posts">
    Learn how to generate and edit AI-optimized blog posts before publishing.
  </Card>

  <Card title="Search performance" icon="trending-up" href="/dashboard/search-performance">
    View GSC metrics for your published posts alongside your broader search performance data.
  </Card>
</CardGroup>

## Troubleshooting

**The publish panel shows no CMS connections.**

You need to add a CMS connection before you can publish. Go to **Settings > Integrations** and connect your CMS. See [Connect a CMS](#connect-a-cms) above.

**Publishing failed.**

Check that your CMS credentials are still valid and that the API key has write permissions. If you recently rotated an API key, remove the existing connection and reconnect with the new key.

**The post published but I can't see it on my site.**

Some CMS platforms create posts in a draft state by default, even when published via API. Check your CMS dashboard and confirm whether the post needs to be manually published or scheduled there.