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

# Articles: Generate and Manage AI-Optimized Content

> Use Mentionpath's article feature to generate, upload, or import content that improves your AI visibility and feeds your knowledge base.

Articles are the content layer of your AI visibility strategy. When you publish high-quality, well-structured content on topics AI models are asked about, you increase the chance that those models cite or mention your brand in their answers. Mentionpath's article feature lets you create that content three ways — generate it from a brief using AI, upload an existing document, or import from a URL — and organizes everything in one place so you can track progress from idea to published.

## How articles connect to your visibility

Every article you create is scoped to your active domain and can be linked to topics. Once published, articles contribute to your knowledge base and help Mentionpath's AI understand what your brand covers. The more relevant, authoritative content you produce on queries where AI models are active, the stronger your training signal becomes for future generation.

## Creating an article

<Tabs>
  <Tab title="Generate with AI">
    The fastest path to new content. Describe what you want to write, pick an article type and word count, and Mentionpath's AI handles the rest — titles, outline, research, and draft.

    <Steps>
      <Step title="Open Articles and describe your topic">
        Navigate to **Content → Articles**. In the writing box at the top of the page, type a description of what you want to write. This can be a target query (e.g. "best practices for onboarding SaaS users"), a topic brief, or a specific angle you want to cover. The description needs to be at least three characters.
      </Step>

      <Step title="Choose an article type and word count">
        Use the dropdowns next to the writing box to select the article type and target length that fit your goal. Mentionpath supports 16 article types across informational, evaluative, and deep-dive formats — including Explainer, How-To, Comparison, FAQ, Ranked List, Buyer's Guide, Alternatives Guide, Review, Case Study, Checklist, Best Practices, Troubleshooting, Myths & Misconceptions, Glossary, Industry Playbook, and Topic Guide.

        Word count options range from Quick answer (400–800 words) to Pillar (6,000+). The article type you select automatically suggests a sensible default — for example, a Case Study defaults to Deep Dive length.
      </Step>

      <Step title="Optionally attach reference files">
        Click the paperclip icon to attach files, URLs, or pasted text as reference material. Attached content is uploaded to your knowledge base as a domain document and linked to the article project so the AI uses it during generation.
      </Step>

      <Step title="Click Write">
        Mentionpath creates the article project and opens the article wizard. Title generation starts automatically — the AI produces five unique title options based on your Domain DNA profile and your target query.
      </Step>

      <Step title="Select a title">
        Pick one of the AI-generated titles, or type your own in the custom title field and press Enter. Selecting a title triggers outline generation immediately.
      </Step>

      <Step title="Review and approve the outline">
        Once the outline is ready, you can edit section headings before approving. When you're happy with the structure, click **Generate Draft** to start the full article generation pipeline.

        <Note>
          You can leave the page while the article generates — the job runs in the background. Come back at any time and your draft will be ready.
        </Note>
      </Step>

      <Step title="Edit your draft">
        The finished draft opens in the rich text editor. Format freely using the toolbar, insert FAQ sections from the Review sidebar, add a Sources block, and run quality critique or AEO analysis at any time. The draft saves automatically every two seconds as you type.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Upload a file">
    If you have an existing document — a whitepaper, research report, case study, or any other content — you can upload it and use it as the basis for a new article.

    <Steps>
      <Step title="Open the upload panel">
        On the Articles page, click the paperclip icon in the writing box. In the panel that opens, select **File** and choose your document.
      </Step>

      <Step title="Add a description and click Write">
        Add a brief description in the writing box so Mentionpath understands the article's purpose and target angle, then click **Write**. The uploaded file is attached to the project and processed during generation.
      </Step>
    </Steps>

    <Note>
      Uploaded files are also saved as domain documents in your knowledge base, contributing to your AI training quality score.
    </Note>
  </Tab>

  <Tab title="Import from URL">
    Import content from a live web page — useful for bringing in competitor pages, industry articles, or your own published content for revision or expansion.

    <Steps>
      <Step title="Open the upload panel">
        Click the paperclip icon in the writing box and select **URL**.
      </Step>

      <Step title="Paste the URL">
        Enter the full URL of the page you want to import. Mentionpath scrapes the page content and attaches it to the article project as reference material.
      </Step>

      <Step title="Describe your intent and click Write">
        Add context in the writing box explaining what you want to do with this content, then click **Write** to start generation.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Editing in the article wizard

Once your draft is ready, you work in the article wizard — a full-page editor with a collapsible Review sidebar on the right.

The editor supports rich text formatting and the underlying format is Markdown. Any H1 heading you write becomes the article's title and syncs to the articles list automatically. Word count, heading count, and paragraph count update in real time as you write.

The Review sidebar gives you access to:

* **AEO score card** — an AI evaluation of how well the article is positioned to appear in AI-generated answers, based on answer-engine optimization signals
* **Quality critique** — a rubric-based critique followed by a focused AI revision pass
* **Metadata** — meta title, description, URL slug, Open Graph fields, and JSON-LD schemas (Article, FAQPage, HowTo, Organization) that you can edit, save, and regenerate field by field
* **FAQ panel** — extracted FAQ pairs you can edit and insert directly into the article body
* **Internal links** — suggested internal linking opportunities discovered from your domain
* **Social preview** — preview the Open Graph card and upload a custom OG image

When your draft is ready to export, use the **Export** button in the header to copy or download the article as plain text, Markdown, HTML, rich text, DOCX, or PDF.

## Article statuses

As an article moves through generation and editing, its status updates automatically. Once a draft exists, you can also set the status manually.

<AccordionGroup>
  <Accordion title="Generation statuses (automatic)">
    These statuses appear while the AI is working. Generation runs in the background — you can leave the page and return at any time.

    | Status                | What's happening                                                  |
    | --------------------- | ----------------------------------------------------------------- |
    | Draft Config          | Project created, about to start title generation                  |
    | Generating Titles     | AI is producing five title options                                |
    | Titles Ready          | Waiting for you to select a title                                 |
    | Generating Outline    | AI is building the section structure                              |
    | Outline Ready         | Waiting for you to approve the outline                            |
    | Researching           | Fetching SERP data, internal documents, and LLM answer benchmarks |
    | Drafting              | AI is writing the full article                                    |
    | Critiquing / Revising | AI is running quality checks and revising the draft               |
    | Analysing AEO         | Running answer-engine optimization analysis                       |
    | Generating Metadata   | Producing SEO metadata and structured schemas                     |
  </Accordion>

  <Accordion title="Editable statuses (user-controlled)">
    Once a draft exists, you can change the status using the dropdown in the article header or directly in the articles list table. These phases map to your editorial workflow.

    | Phase         | Meaning                           |
    | ------------- | --------------------------------- |
    | **Draft**     | In progress; not ready for review |
    | **Review**    | Ready for a team member to review |
    | **Published** | Live or approved for publishing   |
  </Accordion>

  <Accordion title="Failed status">
    If generation fails at any stage, the article is marked **Failed**. Open the article wizard to see the error message and retry.
  </Accordion>
</AccordionGroup>

## Organizing articles with topics

Tag any article with one or more topics using the **Topics** column in the articles list. Topics let you group articles by theme, filter the list, and align content with your prompt tracking strategy. Click the topic chip in any row — or the **Add Topic** placeholder if none are set — to open the topic editor.

## Filtering and searching the list

The articles list supports full-text search across article titles and target queries. You can also filter by article type using the **All types** dropdown, and filter by topic or status using the column header filters. All filters can be combined and cleared independently.

<Tip>
  Keep your Domain DNA profile complete before generating articles. The AI uses your domain's positioning, tone of voice, and brand context when crafting titles and drafts — the more complete your profile, the stronger the output.
</Tip>
