> ## 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.

# AI-Generated Blog Posts for GEO Visibility

> Generate, edit, and publish AI-optimized blog posts from keyword suggestions, GSC data, or competitor URLs to improve your brand's presence in AI answers.

Blog posts in Rankahead are AI-generated articles built to improve your visibility in large language model outputs. Unlike standard SEO content, each post is structured to answer the kinds of questions that AI models surface — helping your brand appear in ChatGPT, Perplexity, Google AI Overviews, and similar systems. You choose a generation mode, provide a source, and Rankahead handles the drafting. From there you can review, edit, and publish directly to your connected CMS.

## Generation modes

Rankahead supports three ways to generate a blog post, each suited to a different starting point.

<CardGroup cols={3}>
  <Card title="From suggestions" icon="lightbulb">
    Use keyword suggestions surfaced by a prompt run. Best when you already have prompt data and want to act on a specific recommendation.
  </Card>

  <Card title="From GSC keyword" icon="trending-up">
    Target a keyword already appearing in your Google Search Console data. Best for reinforcing topics where you have existing organic presence.
  </Card>

  <Card title="From competitor" icon="git-compare">
    Analyze a competitor URL and generate content that covers the same topic from your brand's perspective. Best for closing competitive gaps identified in your gap analysis.
  </Card>
</CardGroup>

### From suggestions

When you run a prompt, Rankahead analyzes the AI-generated answers and surfaces keyword suggestions — topics where content could improve your visibility. Selecting **From suggestions** lets you pick one of those suggestions as the basis for your post. This mode works best when you want to act directly on what the AI is already surfacing for your tracked queries.

### From GSC keyword

If your Google Search Console account is connected, Rankahead can pull your keyword data and use a specific term as the target for a new post. This is useful when a keyword is driving impressions but not enough clicks, or when you want to reinforce a topic you already rank for with content that also performs in AI results.

### From competitor

Provide a competitor's URL and Rankahead will analyze that page's content to generate a post covering the same topic. Use this mode after identifying gaps in your gap analysis — topics where a competitor appears in AI answers but you do not.

## Post lifecycle

Every blog post moves through a defined set of statuses.

<Steps>
  <Step title="Generating">
    After you submit a generation request, the post enters the **GENERATING** state. Rankahead's AI writes the content in the background. This typically takes under a minute.
  </Step>

  <Step title="Draft">
    Once generation completes, the post becomes a **DRAFT**. You can review and edit the content at this stage. Only posts in DRAFT status can be edited.
  </Step>

  <Step title="Published">
    When you're satisfied with the draft, publish it to your connected CMS. The post moves to **PUBLISHED** status and appears on your website. After a few days, Google Search Console metrics — clicks, impressions, CTR, and position — become available in Rankahead for that post.
  </Step>
</Steps>

<Note>
  If something goes wrong during generation, the post enters a **FAILED** status. You can retry generation from the post detail view.
</Note>

## Create your first blog post

<Steps>
  <Step title="Open the Content section">
    Navigate to **Content** in the sidebar, then select **Blog posts**.
  </Step>

  <Step title="Click New post">
    Select **New post** in the top-right corner of the blog posts list.
  </Step>

  <Step title="Select a domain">
    Choose the domain you want to generate content for. The post will be attributed to this domain and its settings will apply.
  </Step>

  <Step title="Choose a generation mode">
    Pick one of the three modes: **From suggestions**, **From GSC keyword**, or **From competitor**.

    <Tabs>
      <Tab title="From suggestions">
        Select the prompt you want to draw from, then optionally select a specific prompt run. Rankahead will use the keyword suggestions from that run.
      </Tab>

      <Tab title="From GSC keyword">
        Enter the keyword you want to target. This keyword must exist in your connected GSC account's data.
      </Tab>

      <Tab title="From competitor">
        Paste the full URL of the competitor page you want to analyze. Rankahead will fetch and evaluate that page's content.
      </Tab>
    </Tabs>
  </Step>

  <Step title="Set a title (optional)">
    You can provide a custom title for the post. If you leave this blank, Rankahead will generate a title automatically based on the source content and target keyword.
  </Step>

  <Step title="Generate">
    Click **Generate**. The post enters the **GENERATING** state. You'll see it appear in your blog posts list while it processes.
  </Step>
</Steps>

## Edit a draft

Once your post reaches **DRAFT** status, you can open it and edit the content in Rankahead's built-in rich text editor. The editor uses TipTap format, which supports headings, lists, bold and italic text, links, and other standard formatting.

<Warning>
  Only posts in **DRAFT** status can be edited. Once a post is published, you cannot edit it inside Rankahead. To update published content, edit it directly in your CMS.
</Warning>

When editing, focus on:

* **Accuracy** — verify any facts, statistics, or product claims the AI generated
* **Brand voice** — adjust the tone to match your content style
* **Structure** — confirm the post addresses the target topic clearly and completely
* **Internal links** — add links to relevant pages on your site to strengthen topical authority

## Publish to your CMS

After reviewing your draft, publish it directly to your connected CMS from the post detail view.

<Steps>
  <Step title="Open the draft">
    Select the post from your blog posts list to open the detail view.
  </Step>

  <Step title="Select a CMS connection">
    In the publish panel, choose which CMS connection to publish to. All active connections for your account are listed here.
  </Step>

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

<Tip>
  If you don't see any CMS connections in the publish panel, you need to set one up first. See [CMS integrations](/content/cms-integrations) for instructions.
</Tip>

## Track post performance

After a post is published, Rankahead pulls Google Search Console data for that post's URL. Once GSC has indexed the page and accumulated data (usually within a few days), you'll see the following metrics on the post detail view:

| Metric          | Description                                                                   |
| --------------- | ----------------------------------------------------------------------------- |
| **Clicks**      | Number of times users clicked through to your post from Google search results |
| **Impressions** | Number of times your post appeared in search results                          |
| **CTR**         | Click-through rate — clicks divided by impressions                            |
| **Position**    | Average ranking position in Google search results                             |

<Info>
  GSC metrics are not available immediately after publishing. Google typically takes 2–5 days to accumulate enough data for a post to appear in Search Console reports.
</Info>
