| Summary | Adds a warning button to the composer so staff don’t accidentally post publicly when they meant to whisper | |
| Preview | ||
| Repository | GitHub - discourse/discourse-whisper-warning: This component better distinguishes a public reply from a whisper. · GitHub | |
| Install Guide | How to install a theme or theme component | |
| New to Discourse Themes? | Beginner’s guide to using Discourse Themes |
Install this theme component
Adds a toggle button to the composer that shows whether your reply will be a whisper (staff-only) or a public reply. Clicking the button toggles whisper mode, making it easy to catch mistakes before posting.
By default the warning appears in read_restricted categories, and in PMs. Setting can be used to customize the scope to your use-case.
Settings
| Setting | Default | Description |
|---|---|---|
| Whisper only | off | Only show the button when actively composing a whisper. Hides it for public replies. |
| Show in read-restricted categories | on | Automatically show the warning in categories that aren’t publicly visible. |
| Show in group PMs | on | Automatically show the warning in PMs where you’re a member of one of the allowed groups. |
| Restrict to groups | empty | Limit the warning to members of specific groups. Leave empty to show for all users who can whisper. |
| Restrict to categories | empty | Only show the warning in specific categories. Works alongside the read-restricted setting. |
When show in read-restricted categories, show in group PMs, or restrict to categories are configured, they act as context filters — the warning appears if any of them match. When none are configured, the warning shows everywhere.
Restrict to groups and whisper only are global filters that narrow visibility further.

