Use AI to clean up an article
The Clean Up action is a quick proofread. It fixes typos, repairs broken grammar, smooths awkward sentences, and standardizes capitalization. It does not restructure, reorganize, or change the level of detail — only the surface gets polished.
Reach for this when you’ve finished a draft and want one more pass before clicking Publish.
1. Open the article
Go to Knowledge Base in the main navigation. Open the article you want to clean up. The editor takes the right pane.
2. (Optional) Select a section
If you only want to clean up part of the article, highlight that part in the editor. With nothing selected, Clean Up runs on the whole body.
A targeted selection is usually faster and more predictable — the AI has less to consider, and you can verify the change without scrolling through the whole article.
3. Open the AI Writing Assistant
Click the Sparkles icon below the editor body. A popover slides up with the AI Writing Assistant.
4. Click Clean Up
The button is on the left of the popover. Click it once.
The AI runs against your selection (or the whole body) and applies the cleanup. You’ll see the article update in place.
5. Review the change
The AI is good, not perfect. Scan the cleaned-up version:
- Are there sentences where the meaning shifted? Roll those back manually.
- Are there typo fixes you disagree with (e.g. a product term the AI didn’t recognize)? Fix them.
- Did the AI touch headings or links? It shouldn’t, but verify if you ran it on a large body.
If the result is worse than the original, use Undo (Ctrl/Cmd+Z) to revert. The cleanup applies as a single edit, so one undo reverses it.
6. Save
The editor saves automatically. No need to click anything.
When Clean Up isn’t enough
Clean Up is a surface pass. If you want the writing to actually flow better — sentences reordered, paragraphs split, weak phrasing replaced — use Improve instead.
If you want to add a section, change the structure, or rewrite for a different audience, use the free-form prompt input (Ask AI to write or edit content) — that one accepts natural-language instructions.
Common gotchas
- Product terms get “corrected” sometimes. If “Sidekick” becomes “side-kick” or “Capabilities” becomes “capabilities,” fix it back manually. Adding these terms to your article’s keywords doesn’t change AI behavior in the editor.
- Clean Up changes US/UK spelling inconsistently. If your house style is one or the other, do a quick scan for
color/colour,organize/organiseafter the cleanup. - Don’t run it on a published article without a draft step. The change auto-saves. If you want to verify before customers see it, set the article to
draftfirst, clean up, review, then re-publish.