Get a review before you publish

Want someone to check your changes before they go live? Ask them to review. It's optional: if you never ask, publishing works exactly as it always has.

When review is optional, the arrow beside Publish or Update offers Ask for review… and Review changes…. If the page requires approval, Ask for review is the single main action. Select it to ask the named approvers; use Unpublished changes below the title to inspect your draft.

Ask for a review

1. Open the page and select Unpublished changes below the title. The main action sits beside the title.
2. Below the list of changes, select Ask someone to review.
3. Choose one or more people who can edit the page. Reviews are included on every plan.
4. Add a note if it helps, for example which part you're unsure about.
5. Select Send.

The breadcrumb now says In review, and Review changes appears below the title. You can keep editing the same draft. An edit pauses review until you select Re-submit for review. You can still publish yourself when the submitted draft is unchanged; publishing closes the request. Dana's review link opens this specific draft read-only; the published page stays separate.

To take the request back, open Review changes and select Withdraw request. Your draft is kept.

When someone asks you

You'll see it in For you under Home: John Park asked you to review Onboarding checklist, with their note. The Home section and the bell beside Search show the same request indicators: a purple dot for new requests, and a softer orange dot for requests you have seen that still need review. Opening either list clears the new indicator without approving anything. See For you and Activity.

Select Review to open the page. You'll see:

• the page itself, read-only, with every change marked where it happens: new text highlighted, removed text struck through;
• the list of changes beside it; select one to jump to it;
• Approve where Publish usually is.

In participating workspaces, Knit may add a short explanation above the marked changes. The same explanation follows an unchanged draft from its author to its reviewer. Opening the comparison requests the explanation; editing alone does not. Knit waits for editing to settle and active assistant writing to finish. A frozen change-set proposal can also show an explanation of the proposal against the version it was prepared from. Always check the actual marked changes before approving or publishing.

Not ready? Select Send John a note instead. The request stays open and John sees your note on the page and in For you.

Good to know

• Any editor who can access the page can approve an open review. You can't approve your own changes. On a page with required approvers, only their approvals satisfy that requirement.
• Each editor has a separate draft and review request. Another editor can ask for a review of the same page without replacing yours.
• If the page changes after you open it, Approve won't publish anything. The review reloads so you can look at the latest changes.
• If Knit can't show the changes, Approve is unavailable. Reload the page to try again, or resolve an unsent local draft first. Nothing is published while the review is unavailable.
• An approval covers exactly what you saw. If the author edits the page after you approve, your approval no longer counts, and you'll be asked to take another look.
• Each round starts fresh. After the changes are published, the next edits need a new review if you want one.
• Page history credits the editor. It shows who changed a version and who approved that exact edit separately.
• People who can only view the page can read it but can't approve.

Review several drafts

From For you, select Review drafts. Home groups exact repeated wording edits so you can inspect each real occurrence without losing your filters. Occurrences labeled with other changes need full-draft review: the repeated edit does not cover those additional changes.

Selecting a file shows compact formatted evidence. View full page opens the existing page and complete Changes panel. After checking the complete comparison, select Mark reviewed to save your own progress. This does not approve or publish the draft. Approving an individual page also records your review progress, including while another approver is still needed. Your progress follows the same exact draft across Home views; an edit or a changed published page clears progress saved for the older version. Opening a summary or compact inspection never marks a draft reviewed.

Checking accuracy and keeping a page current

Your review can include checking whether the changes are accurate. Today, approval records the exact draft you approved. Freshness checks and reminders are planned: explicitly confirm the published page is still current during approval, or check an unchanged page later, and optionally set a recheck date. Ordinary approval will not automatically create that freshness record.