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

# Blog posts

> Draft, refine, and publish posts with the agent.

Your Showcase (your company's website) includes a blog. Posts are regular pages — they show up in the page list like any other — but the assist bar and a guided brief give the agent enough context to draft a full post from a one-line idea.

## Draft a new post

<Steps>
  <Step title="Open the assist bar">
    In the website editor, type something like *"write a post about pool opening checklist"*. The agent recognizes a blog intent and opens the draft flow.
  </Step>

  <Step title="Fill the brief (optional)">
    The agent may suggest a brief — a primary keyword, a customer question to answer, and proof points. Accept the suggestions, edit them, or skip the brief entirely and let the agent draft from your message alone.
  </Step>

  <Step title="Review the draft">
    The agent returns a complete draft as a proposal card: a blog index page (if one doesn't exist yet) and the post itself. Accept to stage it in the draft, or reject to start over.
  </Step>
</Steps>

**Success:** the post appears in the preview. It's in your draft — not live until you publish.

<Accordion title="The draft went to the wrong page">
  If the agent created a new page when you wanted to edit an existing post, dismiss the proposal. Open the post you want to edit in the canvas, then ask the assist bar to *"rewrite this page"* — it will target the page you have open.
</Accordion>

## Refine a draft

Once a draft is staged, you can ask the agent to revise it:

<Steps>
  <Step title="Ask for a revision">
    With the post open in the canvas, type a refinement in the assist bar — *"make the intro shorter"*, *"add a section about salt systems"*, *"use a more casual tone"*.
  </Step>

  <Step title="Review the revised draft">
    The agent rewrites the post, keeping the same slug and page id so the URL doesn't change. The proposal card shows the new version. Accept to replace the current draft, or reject to keep what you have.
  </Step>

  <Step title="Edit manually">
    Click any paragraph on the canvas to edit it inline. Manual edits and agent edits coexist — both land in the same draft and both are undoable.
  </Step>
</Steps>

**Success:** the revised post reflects your changes in the preview. The **Publish** button shows unpublished changes.

<Accordion title="I lost my edits after a revision">
  Agent revisions replace the entire post content in one undo entry. If you had manual edits you want back, press **Cmd+Z** immediately after accepting the revision. To combine manual and agent edits, make manual edits after the agent's revision is accepted — not before.
</Accordion>

## Publish a post

Posts follow the same publish flow as every other page change:

<Steps>
  <Step title="Review in the preview">
    Switch to mobile view to check formatting. Posts tend to have longer content — make sure headings and images read well on a narrow screen.
  </Step>

  <Step title="Click Publish">
    The post goes live with every other staged change in a single publish. A version snapshot is created so you can restore the prior version if needed.
  </Step>
</Steps>

**Success:** the post is live on your site. The blog index (if one was created) lists it automatically.

## SEO fields

Each post page has its own SEO fields in the **Pages** drawer — a title tag and meta description. The agent drafts these as part of the post, but you can edit them. Keep the title under 60 characters and the description under 160 for the best search-engine display.

## Next steps

<CardGroup cols={2}>
  <Card title="Editor and publishing" icon="pencil" href="/pool-spa/website/editor-and-publishing">
    The visual editor, assist bar, publish flow, and version history.
  </Card>

  <Card title="Reviews showcase" icon="star" href="/pool-spa/website/reviews">
    Put your best Google reviews on your site and keep them there.
  </Card>
</CardGroup>