Docs
← Back to site

Doc Review Workflow States

2 min readUpdated November 21, 2026

Beyond WordPress’s own Draft/Published status, a doc can carry an editorial review status, useful for tracking where a doc stands in your team’s own review process.

The four statuses#

StatusMeaning
Needs reviewReady for someone to read and give feedback.
Changes neededReviewer has requested edits before approval.
ApprovedSigned off. Safe to publish or schedule.
ScheduledApproved and queued for a specific publish date.

These are purely labels your team assigns and interprets; there’s no separate approval workflow, permission gate, or actual scheduling mechanism behind any of them. “Scheduled,” for instance, doesn’t control WordPress’s own post-scheduling, it’s just a status you set to communicate that a doc is done and waiting on its planned publish date, which you’d still set the normal WordPress way in the Publish panel.

Setting a status#

While editing a doc, find the Review Status panel in the sidebar:

  1. Choose a status from the dropdown.
  2. Optionally add a note, for example explaining what changes are needed.
  3. Update or save the doc.
The Review Status panel in the editor with Changes needed selected and a note.

Once set, the panel shows who last changed the status and when, right above the dropdown.

Seeing status at a glance#

The WP Super Docs → All Docs list has a Review column showing each doc’s current status as a colored badge, and it’s sortable, click the column header to sort docs by review status.

The docs list with the Review column showing Needs review, Approved, Changes needed and Scheduled badges.

Notifications#

Go to Settings → Workflow to set up notifications for status changes:

  • Notification emails: a comma-separated list, notified on every status change.
  • Slack webhook URL: create an incoming webhook at api.slack.com/apps and paste the URL here.
The Review Workflow settings: notification emails and Slack webhook URL.

Leave both blank to disable notifications entirely. When configured, a status change sends a message showing the doc title, who changed it, the old and new status, and any note left, with a direct link back to edit the doc.

If neither is set up, the Review Status panel in the editor shows a small “No notifications configured” note with a Set up link straight to Settings → Workflow.

Was this helpful?

This website uses cookies to enhance your browsing experience and ensure the site functions properly. By continuing to use this site, you acknowledge and accept our use of cookies.

Accept All Accept Required Only