Skip to main content
Watch “Content optimization walkthrough” on YouTube. Content optimization turns an Action for one of your pages into an editable draft you can work on directly in Peec AI. It highlights areas that could be improved and suggests changes to help optimize your content. Open a Content optimization Action and click Optimize content to review the suggestions and edit your page directly in the workspace.

Working through the workspace

Your page content appears on the left, with Peec AI’s suggestions on the right.
  1. Review the Suggestions tab: Suggestions are grouped by passage. Click one to jump to the relevant part of your article and review the recommended change.
  2. Apply or dismiss a rewrite: Use Apply to add a drafted change to your article, or Dismiss to keep the existing content. Suggestions that need new text can be worked through individually.
  3. Edit the content directly: You can also rewrite a passage yourself using the rich-text editor. Select text to access the available formatting options.
  4. Check the Outline tab: Review your article’s headings and click a heading to jump to that section. The outline reflects headings you add or change in the article.
  5. Review SEO checks when available: The SEO tab shows checks from the source page, including which passed and which need attention. It only appears when the page has check results. Editing the article doesn’t update these results.
Content Optimization uses two colors to distinguish between different types of suggested edits:
  • Blue edits: Suggested rewrites that are ready to review and can be accepted directly.
  • Orange edits: Suggestions that require additional information from you. Since Peec doesn’t have all the necessary details, you can provide the missing information and use the AI Agent to generate a suitable rewrite.
Click a suggestion in the panel to jump to and highlight the relevant passage in the article. You can also click a highlighted passage in the article to open its corresponding suggestion in the panel.

The suggestions panel

  • Filter: Switch between To review, Applied, and Dismissed to review suggestions based on their status. The heading above the list shows which set you’re viewing and how many suggestions it contains.
  • Apply: Adds the suggested change to your article. Dismiss keeps your existing content instead.
  • Revert: Appears after you’ve applied or dismissed a suggestion and lets you undo that decision, returning the suggestion to To review.
  • Coverage gaps: Below the suggested edits, topics your page doesn’t cover yet. Open Evidence on a gap to see why it’s there, such as what AI platforms searched for, what your tracked prompt asks, or what competitors and social posts answer.
Apply all and Dismiss all appear at the bottom of the Suggestions panel while you’re viewing To review, drafted rewrites remain. These controls handle the remaining drafted rewrites together. To dismiss every suggestion on one passage, open the passage’s menu and choose Dismiss all.

Work with the Agent

The Chat below the suggestions works on the article you have open. Ask for a change in plain language, or give the Agent a specific starting point:
  • Add to context: On a suggestion, a passage’s menu, or a coverage gap, this adds it to your chat message as a reference. If the message is empty, Peec AI also writes a starting request.
  • Ask AI: Select text in the article and click Ask AI in the formatting toolbar to ask about that passage.
Peec AI fills in the message but doesn’t send it, so review the request, add any instructions, and send it. The Agent edits the draft in the workspace. Review its changes before you export.
Editing with the Agent needs project owner or company owner access.

Add a page yourself

You don’t need to wait for Peec AI to suggest a page for optimization. If you already have a page in mind, click the Create action dropdown in the Actions header and select Analyze content to create a Content Optimization action for that page. To create the Action, provide:
  • A URL or a document: Add the URL of a live page, such as yoursite.com/page, or upload a Markdown (.md or .markdown) file for content that hasn’t been published yet.
  • Page type: Tell Peec AI what type of page it’s optimizing.
  • Topic and Prompt: Choose the topic, then the prompt you want to optimize the page for. Only topics that already contain prompts can be selected.
Click Generate action to create it. Once it’s ready, the Action will appear under New, where you can open it and start optimizing your content.

Work with your AI assistant

If you’ve connected your AI assistant through the Peec AI MCP Server, it can work through a Content optimization Action for you. It can read the article and its suggestions, apply or dismiss Peec’s rewrites, and write the passages that suggestions only describe. Ask it in plain language, such as “Apply the pricing suggestions on our pricing page optimization”, or run the peec_optimize_content prompt to work through everything that’s pending. Your assistant’s changes appear in the workspace as tracked edits under your name, and you can revert them like your own.
Reading an article works for any project member. Editing it needs project owner or company owner access. See the MCP tools reference for details.

Export your content

When you’re ready to take your draft out of Peec AI, click Export above the article:
  • Copy the text: Copies the article as plain text to your clipboard.
  • Download: Exports the article as HTML (.html) or Plain text (.txt).
Apply the rewrites you want to keep before exporting. Suggestions you haven’t applied retain the original wording in the exported article.