Skip to content

vertesela/devvit-flag-app

Repository files navigation

🚩 Flag App - Trusted user flagging made simple

Sometimes moderators aren’t the first to notice problematic content.
Often it’s trusted users – regulars, helpers, experts – who spot issues early and can provide valuable context.

Flag App is a Dev Platform app that lets moderators delegate limited flagging power to trusted users, while keeping full control and transparency.

Trusted users can flag posts or comments with a reason and optional context, triggering immediate moderation actions and notifications.


What Flag App does

  • Allows trusted users and moderators to flag posts and comments
  • Uses subreddit removal reasons as flag reasons
  • Can automatically remove flagged content
  • Allows flaggers to lock posts (optional)
  • Sends Modmail notifications to the reporting user
  • Supports Discord webhook notifications
  • Logs actions via mod notes for transparency and auditing

All features can be configured in the app settings.


How to use it

Trusted users and moderators

  1. Moderators add trusted users in the Dev Platform app settings
    (comma-separated list of usernames).
  2. Open a post or comment and select Flag from the menu.
  3. Choose a flag reason and optionally add context.
  4. Submit the form.

That’s all.


If you’re a regular user and want to use Flag App

  • Flag App is not available to everyone by default.
  • If you want access, contact the subreddit’s moderators.
  • Granting trusted status is entirely at the moderators’ discretion.

Optional features

Automatic removal

  • Flagged content can be automatically removed.
  • Useful for fast-moving threads or clear rule violations.
  • Can be disabled in the app settings.

Post locking

  • When flagging a post, trusted users can optionally lock the post.
  • Useful for preventing further escalation while mods review the situation.

Discord notifications

  • Moderators can configure a Discord webhook.
  • Each flag can trigger a Discord notification containing:
    • Subreddit
    • Reporter
    • Target user
    • Flag reason
    • Optional context
    • Content score
    • Lock status (for posts)

Ideal for moderation teams coordinating outside Reddit.


What the app does behind the scenes

When content is flagged, Flag App may:

  • Report the content with a structured reason
  • Remove the content (if enabled)
  • Lock the post (if selected)
  • Add a mod note to the target user
  • Notify the reporting user via Modmail
  • Send a Discord notification (if enabled)

Important note about Reddit API limitations

Due to current Reddit API limitations, Flag App cannot place flagged content into a “pending approval” or filtered state (i.e. it cannot move content into the mod queue to wait for manual approval).

As a result, flagged content can only be:

  • Reported (visible in the mod queue as a report), or
  • Removed immediately (if automatic removal is enabled)

This is a platform limitation, not a design choice, and applies to all Dev Platform apps.


Mod tools & moderation control

  • All configuration is handled via Dev Platform app settings
  • Trusted users are managed manually by moderators
  • Moderators can always revert or override actions
  • Flag actions integrate with Reddit’s native moderation tools

Flag App helps moderators act faster without giving up control.


Resources


Source code & license

The source code for Flag App is available on GitHub.

This project is licensed under the BSD 3-Clause License.

Flag App is developed in compliance with Reddit’s Developer Terms and adheres to Devvit platform guidelines.


Support

If you encounter issues or have questions:

  • Please do not message the bot or app account directly
  • The correct support channel is r/paskapps modmail

Thank you for using Flag App - built to help moderators act faster, stay informed, and share responsibility without losing control.

About

Devvit app which allows trusted users to easily flag the inappropriate content.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published