Skip to main content

⚠️ Warns

The Warns feature allows moderators to issue warnings to users who break community rules. It serves as an escalating disciplinary system, with configurable actions triggered when a user exceeds a set warning limit.

Configuration​

In the webapp​

Open your workspace, select the Telegram group under Channels in the sidebar, then select Moderation, then the Warns tab. Changes save with the Save bar at the bottom of the page.

In Telegram (bot menu)​

To access Warn Settings:

  1. Use the /settings command in your chat
  2. Navigate to 🛡️ Moderation → ⚠️ Warns
  3. Use the Toggle Warns option to turn the feature 🟢 Enabled or 🔴 Disabled
Shortcut

Admins can jump straight to this panel with /warn_settings or /warns_settings.

Configuring Warn Settings​

Notifications​

Define the message sent by the bot when the !warn command is issued by an admin or a user with permission to issue warnings via Fren One.

Customization options:

  • Create a custom warning message that fits your community's tone
  • Include information about the warning and consequences
  • Reference community rules or guidelines
  • Available warning message variables: {name}, {warns}, {limit}.
Custom Warning Message

Make your warning message informative but not harsh. Include what rule was broken and how users can avoid future warnings.

Warn Limit​

Define how many warnings a user can receive before an automatic action is taken.

Warn Actions​

Choose what happens when a user reaches the warn limit.

Available actions:

  • Mute: Restricts the user from sending messages in the group
  • Kick: Temporarily removes the user, allowing them to rejoin later
  • Ban: Permanently removes the user from the group

Expiry​

Define the time period after which a user's warns will expire automatically. 📝 Note: If set to 0, warns will not expire.

Issuing Warnings​

Moderators can issue warnings in two ways:

By Replying to a Message​

Respond to the offending user's message with the !warn command.

By Mentioning the User​

Use the !warn @username command to warn a specific user.

Who Can Issue Warnings​

Warnings can be issued by:

  • Group Admins: Always have permission to warn users
  • Users with Warn Permission: Assigned through the Fren One Roles system
Role-Based Permissions

Learn more about assigning warn permissions in the Roles documentation.

Admin Commands​

CommandDescription
/warn [username/id/reply]Issue a warning to a user
/swarn [username/id/reply]Silently warn a user without posting a public notice
/warns [username/id/reply]Show the number of warnings a user currently has
/acquit [username/id]Clear all of a user's warnings. It doesn't lift mutes or bans.
/clearwarns [username/id]Same as /acquit

Troubleshooting​

!warn command not working?

  • Verify the Warns feature is toggled 🟢 Enabled
  • Ensure the bot has admin privileges
  • Check if the user issuing the warning has permissions to do it
  • Verify you're using the correct command syntax: !warn

Warnings not triggering actions?

  • Confirm the warn limit is set correctly
  • Check if the warn action is properly configured
  • Ensure bot has permissions for the action (mute/kick/ban)
  • Verify the warned user isn't an admin

Users not receiving warning notifications?

  • Verify notification messages are configured
  • Check if in-chat notifications are enabled
  • Ensure the bot has permission to send messages

On this page