Command reference

Every moderation command, in one place

203 commands and aliases across 26 areas — the same names and syntax you already use, so nothing has to be relearned. Bring an existing setup across with /export and /import.

RestrictionsWarningsAdminsApprovalsPurgesPinsLocksBlocklistsAntifloodAntiRaidCAPTCHAGreetingsRulesNotesFiltersCleaningReportsInfoEchoLog channelsCommand disablingFederationsTopicsImport & exportConnectionsMiscLock typesFormatting

And then there’s the part a moderation bot can’t do

The commands below are table stakes. What makes Knowa one bot instead of two is that the same bot reads your documentation and answers the questions your members actually came to ask.

  • Answers members' questions from your documentationAdd a GitBook link, text or files — answers come only from what you gave it.
  • Hands off to a human when it doesn't knowForwards the exact message to your admin with a tap-to-answer button.
  • Reads screenshots and error messagesMembers can attach an image with the question.
  • Replies in 100+ languages automaticallyOr pin a chat to one language with /setlang.
  • Fully white-label — your name, avatar and voiceMembers never see another brand in your group.
  • Answers on your website tooA drop-in chat widget and a REST API share the same knowledge base.

Restrictions

Bans, kicks and mutes, each with a silent variant that leaves no message in the chat and a delete variant that removes the offending message first. Durations accept minutes, hours, days and weeks.

CommandWhat it does
/banBan a user. /ban <reply|@user|id> [reason]
/sbanBan silently, with no message in the chat.
/dbanDelete the replied-to message and ban its sender.
/tbanBan for a while. /tban <user> <2h|3d|1w> [reason]
/unbanLift a ban so the user can rejoin.
/kick/punchRemove a user. They can rejoin.
/skickKick silently.
/dkickDelete the replied-to message and kick its sender.
/muteStop a user speaking until you unmute them.
/smuteMute silently.
/dmuteDelete the replied-to message and mute its sender.
/tmuteMute for a while. /tmute <user> <10m|2h|1d> [reason]
/unmuteLet a muted user speak again.
/kickmeRemoves you from the chat.

Warnings

Warnings stack up to a limit you set, then trigger whatever punishment you choose. They can expire on their own so an old strike doesn't follow someone forever.

CommandWhat it does
/warnWarn a user. /warn <reply|@user|id> [reason]
/swarnWarn silently.
/dwarnDelete the replied-to message and warn its sender.
/warns/warningsSee your warnings, or someone else's.
/rmwarnRemove a user's most recent warning.
/resetwarn/resetwarnsClear all of a user's warnings.
/resetallwarnsClear every warning in the chat. Owner only.
/setwarnlimitHow many warnings before the punishment. /setwarnlimit 5
/setwarnmodeWhat happens at the limit. /setwarnmode tmute 1w
/setwarntime/warntimeHow long warnings last. /setwarntime 12w or off

Admins

Admin lists come from Telegram itself and are cached, so /admincache is there for the moment after you change someone's rights.

CommandWhat it does
/adminlist/adminsList the chat's admins.
/admincacheRe-read the admin list after you've changed someone's rights.
/promoteMake a user an admin. /promote <reply|@user|id>
/demoteRemove a user's admin rights.
/adminerrorWhether I tell members off for using admin commands. /adminerror off
/anonadminAllow anonymous admins to run commands. /anonadmin on

Approvals

Approved users skip locks, blocklists, antiflood and CAPTCHA without becoming admins — useful for long-standing members and your own team.

CommandWhat it does
/approveExempt a user from the automated filters.
/unapproveRemove a user's approval.
/approvalCheck whether a user is approved.
/approvedList every approved user.
/unapproveallClear every approval. Owner only.

Purges

Delete one message, a run of messages from a reply onwards, a fixed count, or an exact range marked with /purgefrom and /purgeto.

CommandWhat it does
/delDelete the message you're replying to.
/purgeDelete everything from the replied-to message onwards, or /purge 15.
/spurgePurge without leaving a confirmation.
/purgefromMark the start of a purge. Then use /purgeto at the end.
/purgetoDelete everything between /purgefrom and here.

Pins

Pin quietly or loudly, post a formatted message and pin it in one step, and stop the linked channel hijacking your pin.

CommandWhat it does
/pinPin the message you're replying to. Add loud to notify everyone.
/permapinPost a message as me and pin it. Supports formatting and buttons.
/unpinUnpin the current pin, or the message you're replying to.
/unpinallUnpin every pinned message. Owner only.
/antichannelpinStop the linked channel's posts auto-pinning. /antichannelpin on
/cleanlinkedDelete posts forwarded in from the linked channel. /cleanlinked on

Locks

48 content types you can switch off, individually or in a batch. Each lock can carry its own reason and punishment using the ### syntax, and nine of them take allowlists.

CommandWhat it does
/locktypesList everything that can be locked.
/locksShow what's locked. /locks list shows every type's status.
/lockLock content types. /lock gif video sticker or /lock url ### No links {ban}
/unlockUnlock content types. /unlock gif sticker
/lockwarnsTell members off when a lock deletes their message. /lockwarns on
/allowlist/whitelistExempt something from a lock. /allowlist wikipedia.org @pic /website
/rmallowlist/rmwhitelistRemove allowlist entries. /rmallowlist wikipedia.org
/rmallowlistall/rmwhitelistallClear the whole allowlist. Owner only.

Blocklists

Block words and phrases with * and ? wildcards, several triggers at once with (a, b, "c"), and prefixed matchers for filenames, forwards, inline bots, names, usernames and sticker packs.

CommandWhat it does
/addblocklist/addblacklistBlock words or phrases. /addblocklist (spam, "buy now") Not here {tban 2w}
/rmblocklist/unblocklist · /rmblacklistUnblock a trigger. /rmblocklist spam
/blocklist/blacklistShow the chat's blocklist.
/rmblocklistall/rmblacklistallClear the whole blocklist. Owner only.
/blocklistmode/blacklistmodeWhat happens on a match. /blocklistmode tban 2w
/blocklistdelete/blacklistdeleteWhether matching messages get deleted. /blocklistdelete off
/setblocklistreason/blocklistreason · /setblacklistreasonDefault message shown when something is blocked.

Antiflood

Two counters: messages in a row, and messages inside a time window. Either one can trigger a warn, mute, kick or ban, and the whole burst can be deleted rather than just the last message.

CommandWhat it does
/floodShow the chat's flood settings.
/setfloodLimit messages in a row. /setflood 10 or off
/setfloodtimerLimit messages per time window. /setfloodtimer 10 30s or off
/setfloodmode/floodmodeWhat happens on a flood. /setfloodmode tmute 30m
/clearfloodDelete the whole flood, not just the last message. /clearflood on
/resetfloodForget a user's flood counters.

AntiRaid

Temporarily ban everyone who joins while a raid is in progress. Turn it on by hand, or let it arm itself once joins cross a threshold you set.

CommandWhat it does
/antiraidTemporarily ban everyone who joins. /antiraid on, /antiraid 2h, /antiraid off
/autoantiraidTurn antiraid on automatically after a burst of joins. /autoantiraid 15
/raidtimeHow long antiraid stays on. /raidtime 6h
/raidactiontimeHow long raid joiners are banned for. /raidactiontime 1h

CAPTCHA

New members are muted until they prove they're human. Four challenge types: a single button, an emoji to pick, a word to read, or simple arithmetic.

CommandWhat it does
/captchaMake new members prove they're human. /captcha on, /captcha math
/captchamodePick the challenge type. /captchamode math
/captchakickKick members who never solve the CAPTCHA. /captchakick on
/captchakicktimeHow long before an unsolved CAPTCHA is kicked. /captchakicktime 30m
/captchamutetimeAuto-unmute after a while even if unsolved. /captchamutetime 1d or off
/captcharulesShow a rules button with the CAPTCHA. /captcharules on
/setcaptchatext/captchatextCustom text for the CAPTCHA button. /setcaptchatext Let me in

Greetings

Welcomes and goodbyes with the full markdown dialect, buttons, %%% random variants and every filling — plus punishments you can attach to a join.

CommandWhat it does
/welcomeShow or toggle the welcome message. /welcome on|off|noformat
/setwelcomeSet the welcome message. Supports formatting, buttons and fillings.
/resetwelcomeGo back to the default welcome message.
/goodbyeShow or toggle the goodbye message. /goodbye on|off|noformat
/setgoodbyeSet the goodbye message.
/resetgoodbyeGo back to the default goodbye message.
/cleanwelcomeDelete the previous welcome when someone new joins. /cleanwelcome on
/greetingsList the fillings you can use in greetings, rules, notes and filters.

Rules

One set of rules per chat, shown inline or by DM, reachable from a {rules} button anywhere you can put a message.

CommandWhat it does
/rulesShow the chat's rules.
/setrulesSet the chat's rules. Supports formatting and buttons.
/resetrules/clearrulesDelete the chat's rules.
/privaterulesSend rules by DM instead of in the chat. /privaterules off
/setrulesbutton/rulesbuttonCustom text for the {rules} button. /setrulesbutton Read the rules

Notes

Saved messages recalled with /get or a #hashtag. Notes keep media, buttons and formatting, and can be admin-only, DM-only, or set to repeat on a timer.

CommandWhat it does
/save/addnoteSave a note. /save rules Be nice or reply to a message.
/getShow a saved note. /get rules
/notes/savedList the chat's notes.
/clear/rmnote · /delnoteDelete a note. /clear rules
/clearallDelete every note. Owner only.
/privatenotesSend every note by DM instead of in the chat. /privatenotes on

Filters

Auto-replies triggered by a word, a prefix or an exact match. Add {command} and the filter registers as a real slash command in the chat's menu.

CommandWhat it does
/filter/addfilterAuto-reply to a word. /filter hello Hi there! or /filter (hi, hey) Hello!
/stop/rmfilter · /stopfilterRemove a filter. /stop hello
/stopallRemove every filter. Owner only.
/filtersList the chat's filters.

Cleaning

Three separate sweepers: Telegram's own service notices, members' command messages, and the bot's own replies once they've been read.

CommandWhat it does
/cleanserviceDelete Telegram's join/leave/pin notices. /cleanservice all
/keepserviceStop cleaning specific service messages. /keepservice pin
/cleanservicetypes/servicetypesList the service messages I can clean.
/cleancommandDelete command messages after running them. /cleancommand admin
/keepcommandStop cleaning specific command messages. /keepcommand user
/cleancommandtypes/commandtypesList the command messages I can clean.
/cleanmsgTidy away my own messages after a minute. /cleanmsg action notes
/keepmsgStop cleaning specific messages of mine. /keepmsg error
/cleanmsgtypes/msgtypesList my own messages I can clean.

Reports

Members can flag a message for the admins, and admins get it with the context attached.

CommandWhat it does
/reportReply to a message to bring it to the admins' attention.
/reportsTurn member reports on or off. /reports off

Info

The IDs and history you need before deciding what to do about someone.

CommandWhat it does
/idGroups and DMsShow your ID, or a replied-to user's.
/infoGroups and DMsShow what I know about a user.

Echo

Speak as the bot, with the same formatting and buttons available everywhere else.

CommandWhat it does
/echoSay something as me, with formatting and buttons.
/saySame as /echo, but leaves your command in place.
/broadcastIn DMsSend a message to every group I'm in. Bot owner only.

Log channels

Mirror what happens in the chat into a channel, split across six categories so the log stays readable.

CommandWhat it does
/setlogPoint this chat's logs at a channel. /setlog @mychannel
/unsetlogStop logging this chat.
/logchannelShow where this chat's logs go.
/logTurn log categories on. /log admin automated
/nologTurn log categories off. /nolog settings
/logcategoriesList the log categories.

Command disabling

Turn off any command you don't want used in a particular chat, optionally for admins too, and optionally deleting the attempt.

CommandWhat it does
/disableTurn a command off for members. /disable kickme
/enableTurn a disabled command back on. /enable kickme
/disabledList the commands currently disabled here.
/disableableList the commands that can be disabled.
/disableadminApply disabled commands to admins too. /disableadmin on
/disabledelDelete messages that use a disabled command. /disabledel on

Federations

A shared ban list across every chat you run. Fed admins can ban from any member chat, you can subscribe to up to five allied federations, and ban lists export and import as CSV or JSON.

CommandWhat it does
/newfedIn DMsCreate a federation. /newfed My Network
/delfedIn DMsDelete a federation you own. /delfed <fed id>
/renamefedIn DMsRename a federation. /renamefed <fed id> New Name
/myfedsIn DMsList the federations you own.
/joinfedAdd this chat to a federation. /joinfed <fed id>
/leavefedRemove this chat from its federation.
/chatfedShow which federation this chat is in.
/fedinfoGroups and DMsShow a federation's details. /fedinfo <fed id>
/fbanBan a user across the whole federation. /fban <user> <reason>
/unfbanLift a federation ban. /unfban <user>
/fedadminsGroups and DMsList a federation's admins.
/fedpromoteMake someone a federation admin. Fed owner only.
/feddemoteRemove someone's federation admin rights. Fed owner only.
/feddemotemeGroups and DMsStep down as a federation admin. /feddemoteme <fed id>
/fedreasonRequire a reason for every fed ban. /fedreason on
/fednotifDM the fed owner on every fed action. /fednotif off
/setfedlogLog fed actions to this chat. Run it in the chat you want the logs in.
/unsetfedlogGroups and DMsStop logging fed actions. /unsetfedlog <fed id>
/fbanlistGroups and DMsExport the federation's bans. /fbanlist [fed id] csv|minicsv|json
/importfbansGroups and DMsImport bans from a file. Reply to a CSV or JSON export.
/subfedAlso enforce another federation's bans. /subfed <fed id>
/unsubfedStop enforcing another federation's bans. /unsubfed <fed id>
/fedsubsGroups and DMsList the federations yours is subscribed to.

Topics

Full forum support, including a dedicated topic that every moderation message gets sent to so the main feed stays clean.

CommandWhat it does
/newtopicCreate a topic. /newtopic Announcements
/renametopicRename the current topic. /renametopic New Name
/closetopicClose a topic so nobody can post in it.
/reopentopicReopen a closed topic.
/deletetopicDelete a topic and every message in it.
/actiontopicShow which topic gets action messages.
/setactiontopicSend action messages to this topic. /setactiontopic off to undo.

Import & export

Move a whole configuration — settings, notes, filters, blocklists, locks, welcomes and rules — between chats in one file.

CommandWhat it does
/exportDownload this chat's whole setup as a file.
/importRestore a backup. Reply to a file from /export.
/resetWipe every setting, note, filter and lock. /reset confirm

Connections

Run admin commands against a group from your DMs, so you're not configuring a chat in front of its members.

CommandWhat it does
/connectGroups and DMsManage a group from this chat. /connect <chat ID or @username>
/reconnectIn DMsReconnect to the last chat you managed.
/disconnectIn DMsStop managing the connected chat.
/connectionIn DMsShow which chat you're connected to.

Misc

Per-chat language, bot-to-bot behaviour, silent operation, and what the bot stores about you.

CommandWhat it does
/setlangSet the language the bot replies in. /setlang es
/bot2botLet other bots trigger my commands. /bot2bot off|admin|all
/bot2botskipreviewSkip moderation checks on bot messages. /bot2botskipreview on
/silentactionsDelete admin commands and stay quiet. /silentactions on
/privacyGroups and DMsWhat this bot stores about you.
/helpGroups and DMsList what I can do. /help locks for one area.

All 48 lock types

Lock them one at a time or several at once. Each lock can carry its own reason and punishment: /lock url ### No links here {tban 2w}. Nine of them — urls, buttons, invite links, inline bots, anonymous channels, commands, stickers, custom emoji and forwards — also take an allowlist.

all

Locks everything in this list

album

Media albums (groups of photos or documents)

anonchannel

Messages sent by users as anonymous channels

audio

Messages containing audio files

bot

Users adding new bots to the group

botlink

Messages containing links to Telegram bots

button

Users and inline bots sending button links

cashtag

Messages containing cashtags, e.g. $CASH

checklist

Native Telegram checklists

cjk

Messages containing Chinese, Japanese or Korean characters

command

Bot commands starting with /

comment

Comments on the linked channel from non-members

contact

Shared contacts (vCards)

cyrillic

Messages containing Cyrillic characters

document

Shared files

email

Email addresses

emoji

All messages containing emoji

emojicustom

Messages containing custom Telegram emoji

emojigame

Emoji games such as dice, football and darts

emojionly

Messages made up of nothing but emoji

externalreply

Replies to messages in other chats

forward

Any forwarded message

forwardbot

Forwards originally sent by a bot

forwardchannel

Forwards originally sent by a channel

forwardstory

Forwarded Telegram stories

forwarduser

Forwards originally sent by a user

game

Telegram games

gif

GIF images

guestbot

Bots replying in chats they aren't a member of

inline

Inline bots (@pic, @vid, @gif and friends)

invitelink

Messages containing links to other Telegram groups

location

Shared locations

outsidereaction

Reactions from users who aren't members

phone

Phone numbers

photo

Images

poll

Voting polls

reaction

Message reactions

rtl

Messages containing right-to-left text (Arabic, Hebrew…)

spoiler

Messages containing spoiler formatting

sticker

All stickers

stickeranimated

Animated stickers

stickerpremium

Premium stickers

text

All text messages

url

Messages containing URLs or links

video

Videos

videonote

Telegram video messages

voice

Telegram voice messages

zalgo

Text mangled with excessive combining characters

Formatting, fillings and punishments

Welcomes, goodbyes, rules, notes, filters and /echo all share the same dialect: *bold*, _italic_, __underline__, ~strike~, ||spoiler||, `code`, >quote, links, and buttons written as [Text](buttonurl://https://example.com) — add :same to put the next button on the same row.

Fillings

Replaced when the message is sent.

  • {first}The member's first name
  • {last}Their last name
  • {fullname}First and last name together
  • {username}Their @username, or their name if they don't have one
  • {mention}Their first name, as a link to their profile
  • {id}Their numeric user ID
  • {chatname}The chat's title
  • {rules}A button linking to the chat's rules
  • {preview}Allow the link preview Telegram would otherwise hide
  • {nonotif}Send without a notification
  • {protect}Stop the message being forwarded or saved
  • {mediaspoiler}Hide the attached media behind a spoiler
  • %%%Split variants onto their own lines and one is picked at random

Behaviour flags

Change how a note or filter works, not how it reads.

  • {private}Send this note by DM instead of in the chat
  • {noprivate}Always send in the chat, even with /privatenotes on
  • {admin}Only admins can trigger it
  • {user}Only non-admins can trigger it
  • {allow_bot}Other bots may trigger it
  • {replytag}Address the replied-to user instead of the sender
  • {repeat 6h}Post it again on a timer
  • {command}Register the filter as a real slash command in the chat

Punishments

Attach to a lock, a blocklist entry, a flood limit or a warn limit.

  • {warn}Add a warning, escalating at your limit
  • {kick}Remove the member; they can rejoin
  • {ban}Ban permanently
  • {tban 2w}Ban for a set time
  • {mute}Mute indefinitely
  • {tmute 1h}Mute for a set time
  • {skick} {sban} {smute}The same, without announcing it in the chat
  • {nothing}Delete the message and take it no further

Durations are written the way you’d say them: 30s, 10m, 2h, 3d, 1w.

Same commands. One fewer bot. Answers included.

Point us at your docs, run /import with your existing setup, and your group is moderated and answered by the same bot.

Enquire Now See Pricing