Allows community members to suggest edits to posts, giving reviewers granular control over which changes to accept — without granting full editing permissions.
Plugin is experimental and subject to lots of change at the moment, not for production usage yet.
GitHub - discourse/discourse-suggested-edits: EXPERIMENTAL suggested edits plugin · GitHub
Installation
Follow the standard plugin installation guide using the repository URL:
https://github.com/discourse/discourse-suggested-edits.git
Why Suggested Edits?
Many communities want members to help keep content accurate and up to date, but granting edit access to everyone isn’t always practical. Suggested Edits bridges this gap — members can propose improvements to posts, and trusted reviewers decide what gets applied. Think of it as bringing a Wikipedia-style contribution model to your Discourse community.
This is especially useful for:
- Knowledge base and documentation categories where accuracy matters and many eyes help
- Communities with newer members who have good contributions but haven’t earned full edit trust yet
- Collaborative content like FAQs, guides, or community-maintained references
- Automated edits sometimes AI systems may suggest typo and voicing fixes, and you need a human in the loop approving
How It Works
Suggesting an edit
Members in the configured suggest group see a “Suggest Edit” button on eligible posts. Clicking it opens the composer pre-filled with the post content. They make their changes, optionally add a reason, and submit.
Reviewing suggestions
Reviewers see a count badge on posts with pending suggestions. Clicking “Review” opens a modal that breaks the suggestion into individual changes — each shown as a highlighted diff with surrounding context.
Reviewers can:
- Accept or reject each change independently — no need to take all or nothing
- Edit the suggested text before applying — tweak wording while preserving the intent
- Switch between inline and side-by-side diff views
- Navigate between multiple suggestions if more than one is pending
Applying changes
When the reviewer clicks “Apply Accepted,” the selected changes are applied to the post as a revision attributed to the suggester, with an edit reason noting who approved it. The suggester and any other affected users are notified.
Staleness handling
If the original post is edited after a suggestion is created, the suggestion is automatically marked as stale and cannot be applied. This prevents conflicts and ensures suggestions are always based on current content. Suggesters are notified so they can re-submit if needed.
Configuration
Enable the plugin and configure access under Admin > Settings, searching for “suggested edits”:
| Setting | Description |
|---|---|
suggested_edits_enabled |
Master toggle for the plugin |
suggested_edits_suggest_groups |
Groups whose members can suggest edits |
suggested_edits_review_groups |
Groups whose members can review and apply suggestions. Post authors can always review suggestions on their own posts. |
suggested_edits_included_categories |
Categories where suggested edits are enabled |
suggested_edits_included_tags |
Tags on topics where suggested edits are enabled |
suggested_edits_max_creates_per_minute |
Rate limit for creating suggestions (default: 5) |
suggested_edits_max_revisions_per_minute |
Rate limit for revising suggestions (default: 10) |
A typical setup
- Enable the plugin
- Set suggest groups to the trust level or group that should be able to propose edits (e.g.
trust_level_1) - Set review groups to your moderators or curators (e.g.
staff) - Pick the categories or tags where you want this enabled — you don’t have to turn it on everywhere
Post authors can always review suggestions on their own posts, regardless of the review group setting.
Scope and Limitations
- First posts only — Suggested edits currently apply to topic first posts (OPs), not replies
- One pending suggestion per user per post — A member must wait for their current suggestion to be resolved before submitting another on the same post
- Suggestions are text-based — The diff is computed on the raw Markdown content of the post
Search
Reviewers can use the search filter with:suggested-edits to find topics with pending suggestions across the forum.
