How to edit and publish AI-written articles
Documents is where you and your agents write. Edit with the AI chat, check the SEO and AI score, leave comments and publish to your CMS.
Documents is where you edit and publish AI-written articles in Orchly, along with anything you write yourself. You edit them with AI chat, check an SEO and AI search score against the pages ranking today, discuss them with your team in comments, and publish straight to your CMS.
Switch the sidebar to Agent and click Documents.
The Documents list
The list shows every document with its Source, Status, Words and when it was last Updated.
- Source tells you where it came from: Agent, Task (a card on the Content Agent board) or Manual.
- Status is Draft, Review, Published or Archived. Draft and Review still need work. Archived keeps a document without showing it as outstanding.
Use Search documents to find one by title, Export to download the list, and Columns to choose what to show. Tick rows to delete several at once.
Create a document or let an agent write one
Click New document to start a blank one.
More often, an agent writes it. When the Content Agent finishes a draft, or you ask Ask Orchly to write something, the result is saved here. Documents an agent creates in chat also open right in the chat’s side panel, so you can review without leaving the conversation.
Writing and formatting
The editor keeps things simple. The toolbar covers headings (H2 and H3), bold, italic, underline, strikethrough, inline code, lists, alignment, quotes, links, highlight, images and tables.
Type / on an empty line for the slash menu: Text, Heading 2, Heading 3, Bulleted list, Numbered list, Quote, Code block, Table, Image and Divider.
Select any text and a floating toolbar appears with the same formatting, plus Comment and Ask AI. The document saves as you type, and Saved shows how long ago.
Documents have a cover image at the top. Hover it to Replace or download it.
Check the SEO and AI score
Click Score to open the SEO & AI score panel. Pick the keyword you want to rank for with Optimize for a keyword, then Analyze & score. Orchly pulls the pages ranking in Google for that keyword today and scores your draft against them.
The panel has four tabs:
- Signals: the checks behind the score, split into SEO (term coverage, length, sections, images, primary keyword) and AEO / GEO (citations, statistics, question coverage, structure, key takeaways, quotes, readability).
- Terms: the terms ranking pages use, and how often you use each.
- Q&A: the questions your draft should answer.
- Reference: the competitor articles you’re scored against.
Aim for the suggested range shown under the score (70 or higher). When the search results change, Rebuild from a fresh SERP.
A labeled TL;DR near the top, direct quotes, sourced statistics and answer-first sections are what ChatGPT, Perplexity and Google AI Overviews lift into answers. They’re often the quickest points to gain.
Edit with AI
Click Chat to open Edit with AI. Ask for a change in plain words, or start from a suggestion like “Write a TLDR summary and place it at the top of the post” or “Fact-check the claims and flag anything inaccurate”.
The AI proposes edits inline in the document. Review them, then Accept all or Reject all.
To edit one passage, select it and click Ask AI in the floating toolbar. The selection goes to the chat so you can say what to change.
Comment and collaborate
Select text and click Comment, or open Comments to comment on the whole document. Type @ to mention a teammate.
Comments can be replied to, resolved and reopened. Open and resolved threads are listed separately. On any comment, Resolve with AI hands the note to the AI to fix, which is handy for editorial feedback like “this section is too long”.
Copy or publish the article
- Copy content copies the document to paste anywhere.
- Publish opens publish options. Publish to platform sends the document to a connected CMS. Once it’s live, Re-publish or update pushes your latest edits.
Connect a CMS first: WordPress, Webflow, Framer, Ghost or Sanity. For agents that publish on their own, see publish agent output.
Documents holds what you’re producing. Reference material that agents read from, like product sheets and research, belongs in Brand Brain → Files & links.