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

# Content Generation

> Content Generation turns the prompts you are losing and the sources AI assistants cite into a content brief and a blog post draft you review and publish.

**Available to all AI Commerce Visibility customers.** Any user with access to AI Commerce Visibility can generate, approve and publish content.

## Summary

Content Generation turns AI visibility gaps into content. You select the prompts where competitors are more visible than you, ground the piece in the sources AI assistants already cite for those prompts, review and edit a generated content brief, and then generate a full blog post draft that you edit and export to the channel where you publish. Nothing is written until you approve the brief.

## Who it’s for

Marketing and content teams who know where they are losing in AI answers and want to act on it without exporting data and briefing a writer who never saw it. The brief-first flow gives brand-sensitive teams a review gate before any article exists.

## Key benefits

* **Prompts are ranked by gap, not guessed.** Step 1 lists your prompts with your Visibility, its month-over-month change, your best competitor's Visibility and the gap between them, so the biggest losses sort to the top.
* **Content is grounded in what the assistants cite.** Step 2 lists the sources most often cited for the selected prompts, filterable by AI model. You pick up to five as grounding.
* **A brief comes before the article.** The generated content brief, with target topic, prompts, platforms, top cited pages and proposed structure, is editable and must be regenerated to commit changes before the article is written.
* **Every piece is traceable.** The Input tab records the prompts, citations, markets and personas that produced it, with clickable citation links.
* **It fits where you publish.** Export as Markdown, plain text or HTML. Published is a status you set, not an integration.

## How it works

### The flow

**Content Library** > **Generate** (prompts > citations > style) > **Content brief review** > **Full content** > **Approve** > **Published**.

### Content Library

The library is the record of every generated piece. Status tabs mirror the lifecycle, with live title search, sort, pagination and bulk actions for approve, publish and archive that apply to the current tab.

### Step 1: Target prompts

Select a product category (required) and optionally narrow by market and persona. The table lists eligible prompts with your Visibility and its month-over-month change, your best competitor's Visibility, and the gap, colour banded so the largest gaps stand out. Sort by gap to see where you are losing most, then select the prompts to write for.

Only active prompts of type Brand, Product or Merchant are eligible. Paused and draft prompts are left out of the list.

### Step 2: Ground in sources

The step lists the sources most frequently cited by AI assistants for the selected prompts, filterable by model. Select up to five; the cap applies to select all as well. These sources ground the generated content. When you start from the Sources or Citations tab, this step opens with the citation already selected.

### Step 3: Format and language

Blog Post format and English are available.

### Content brief review

Instead of an article, the first output is an editable content brief: target topic, target prompts, target platforms, top cited pages and the proposed structure. Review and edit it, then select **Regenerate Content Brief** to commit the changes.

> [!WARNING]
>
> Brief edits are only committed when you select **Regenerate Content Brief**. Editing and navigating away discards them.

The status Content Brief Review is set by the system when a brief is generated and cannot be selected manually.

### Full content, review and export

Once the brief is approved, the full article is generated from it. You can:

* edit inline in the rich text editor;
* select **Regenerate Content** to re-run generation from the approved brief, which replaces the current draft;
* open Version History to preview and restore an earlier version, which is appended as a new current version rather than overwriting history;
* open the Input tab to see every input that produced the piece, with citation links;
* export: copy as Markdown or plain text, or download as `.md`, `.txt` or `.html`.

Brief generation and content generation each take a few minutes.

### Lifecycle

| Status | Set by |
| - | - |
| Content Brief Review | The system, when a brief is generated |
| Final Content Review | After the brief is approved and the article is generated |
| Approved | You |
| Published | You, once the content is live on your own channel |
| Archived | You, at any point |

### Limits

| Topic | What to know |
| - | - |
| Publishing | Published is a status you manage, not an integration. Nothing is pushed to your website; export is the handoff. |
| Refinement | There is no free-text instruction such as "make this more casual". Use **Regenerate Content** and inline editing. |
| Brand tone | Brand Kit and Knowledge Base appear in the portal but are not configurable. Content is grounded in your visibility data and cited sources and is expected to be edited before publication. |
| Roles | Any user with AI Commerce Visibility access can generate, approve and publish. There is no separate approver role. |
| Images | Text only. |
| Volume | No enforced limit on the number of pieces. |
| Outcome | Generating content improves the chances of being cited; it does not guarantee it. Citation depends on the assistant, the publishing domain and competitive dynamics. Use the Insights tabs to measure whether it worked. |

## Set up in the portal

Go to **AI Commerce Visibility** > **Content**.

1. Select **Generate Content**.
2. In Step 1, select a product category, optionally a market and persona, sort by gap and select the prompts to target. Select **Next**.
3. In Step 2, select up to five sources to ground the content. Select **Next**.
4. In Step 3, choose Blog Post and English, then generate the brief.
5. Review the brief, edit it, and select **Regenerate Content Brief** to commit your edits. Approve the brief to generate the article.
6. Edit the article inline or regenerate it from the brief. Check the Input tab for the prompts and citations behind it.
7. Approve the piece, export it, publish it on your own channel, then set its status to Published in the library.

> [!TIP]
>
> To start from a source instead, select **Create content** on a source in the Sources tab or **Generate content** on a page in the Citations tab. The flow opens with the citation already selected. See [Sources](https://developers.perform.ai/products/ai-commerce-visibility/sources.md).

## FAQ

### Can it publish directly to my CMS?

No. Published is a status you set. Export the piece as Markdown, plain text or an HTML file and publish it where you already publish.

### Will the content match my brand tone of voice?

Not yet. Brand Kit is visible but not configurable. The content is grounded in your visibility data and the cited sources, and you should edit it before publishing.

### Can I tell it to rewrite a section a certain way?

Not with a free-text instruction. Use inline editing, or **Regenerate Content** to re-run generation from the approved brief.

### Does regenerating lose my edits?

Regenerating replaces the current draft, but Version History lets you preview and restore any earlier version. Restoring appends a new current version rather than overwriting history.

### Is the content unique?

The content is generated, not copied. Citations are used as grounding and reference, not as text to reproduce. Run your normal editorial review before publishing.

### A prompt I expected is not in Step 1. Why?

Only active prompts of type Brand, Product or Merchant are eligible. Check the prompt's status under **Configuration** > **Prompts**.

## Troubleshooting

| Symptom | Cause | Fix |
| - | - | - |
| Your brief edits disappeared | You navigated away without regenerating | Edit the brief again and select **Regenerate Content Brief** before leaving the page. |
| You cannot select a sixth source | Citation selection is capped at five, including through select all | Deselect one source before adding another. |
| You cannot set the status to Content Brief Review | That status is set by the system on brief generation | Generate or regenerate the brief; the status is set automatically. |
| A prompt is missing from Step 1 | The prompt is paused, in Draft, or not of type Brand, Product or Merchant | Activate the prompt under **Configuration** > **Prompts** if it should be eligible. |
| Generation seems slow | Brief and content generation each take a few minutes | Wait for the generation to complete; the piece appears in the library when ready. |

## Related

* [Sources](https://developers.perform.ai/products/ai-commerce-visibility/sources.md)
* [Prompts](https://developers.perform.ai/products/ai-commerce-visibility/prompts.md)
* [Personas](https://developers.perform.ai/products/ai-commerce-visibility/personas.md)
* [AI Commerce Visibility overview](https://developers.perform.ai/products/ai-commerce-visibility/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.