Skip to content

Commands

Every command, explained.

Type / in Discord and Wattle Bot's commands show up with their options. Commands that need a permission only show for members who have it.

Draft: Command names and options may change before launchCommand names and options may still change before launch.

99 commands

Moderation15

/warn

Warn a member and add it to their case history.

/warn user:<user> reason:<string>

useruser
Required.The member to warn
reasonstring
Required.Why, for the case history and the member's message

Example: /warn user:@Alex reason:Spamming links

  • Needs Timeout Members

/timeout

Time out a member so they can't chat or join voice for a while.

/timeout user:<user> [duration:<string>] [reason:<string>]

useruser
Required.The member to time out
durationstring
Optional.How long, like 10m, 1h or 2d (up to 28 days). Empty uses the server's default
reasonstring
Optional.Why, for the case history and the member's message

Example: /timeout user:@Alex duration:1h

  • Needs Timeout Members

/untimeout

End a member's timeout early.

/untimeout user:<user> [reason:<string>]

useruser
Required.The member
reasonstring
Optional.Why, for the case history and the member's message
  • Needs Timeout Members

/kick

Remove a member from the server. They can rejoin with an invite.

/kick user:<user> [reason:<string>]

useruser
Required.The member to kick
reasonstring
Optional.Why, for the case history and the member's message
  • Needs Kick Members

/ban

Ban a member, for good or for a set time.

/ban user:<user> [reason:<string>] [duration:<string>] [delete_messages:<string>]

useruser
Required.The member to ban
reasonstring
Optional.Why, for the case history and the member's message
durationstring
Optional.Lift the ban after this long, like 7d. Leave empty to ban for good
delete_messagesstring
Optional.Delete their messages from the last few daysChoices: None, Last hour, Last day, Last 7 days

Example: /ban user:@Alex duration:7d

  • Needs Ban Members

/unban

Lift a ban.

/unban user:<user> [reason:<string>]

useruser
Required.The banned user
reasonstring
Optional.Why, for the case history and the member's message
  • Needs Ban Members

/softban

Ban and unban straight away, to clear a member's recent messages.

/softban user:<user> [reason:<string>]

useruser
Required.The member
reasonstring
Optional.Why, for the case history and the member's message
  • Needs Ban Members

/purge

Delete up to 100 recent messages in this channel.

/purge amount:<integer> [user:<user>] [contains:<string>]

amountinteger
Required.How many messages to check, from 1 to 100
useruser
Optional.Only delete messages from this member
containsstring
Optional.Only delete messages containing this text

Example: /purge amount:50 user:@Alex

  • Needs Manage Messages

/lock

Stop members sending messages in a channel.

/lock [channel:<channel>] [reason:<string>]

channelchannel
Optional.The channel to lock (this one if empty)
reasonstring
Optional.Why, for the case history and the member's message
  • Needs Manage Channels

/unlock

Let members send messages in a channel again.

/unlock [channel:<channel>]

channelchannel
Optional.The channel to unlock (this one if empty)
  • Needs Manage Channels

/slowmode

Set how long members wait between messages in a channel.

/slowmode duration:<string> [channel:<channel>]

durationstring
Required.Like 5s, 1m or off
channelchannel
Optional.The channel (this one if empty)

Example: /slowmode duration:10s

  • Needs Manage Channels

/cases

List a member's warnings, timeouts, kicks and bans.

/cases user:<user>

useruser
Required.The member
  • Needs Timeout Members

/case

Show the details of one case.

/case number:<integer>

numberinteger
Required.The case number
  • Needs Timeout Members

/reason

Change the reason on a case.

/reason case:<integer> reason:<string>

caseinteger
Required.The case number
reasonstring
Required.The new reason
  • Needs Timeout Members

/note

Add a private moderator note to a member's history.

/note user:<user> text:<string>

useruser
Required.The member
textstring
Required.The note. Only moderators can see it
  • Needs Timeout Members

Auto-mod5

/automod status

Show which auto-mod filters are on and what each one does.

/automod status

  • Needs Manage Server

/automod toggle

Turn an auto-mod filter on or off.

/automod toggle filter:<string> enabled:<boolean>

filterstring
Required.The filterChoices: Banned words, Invite links, Links, Spam, Repeated messages, Mass mentions, Capitals, Emoji, Zalgo text
enabledboolean
Required.On or off
  • Needs Manage Server

/automod words add

Add a word or phrase to the banned words list.

/automod words add word:<string>

wordstring
Required.The word or phrase
  • Needs Manage Server

/automod words remove

Remove a word or phrase from the banned words list.

/automod words remove word:<string>

wordstring
Required.The word or phrase
  • Needs Manage Server

/raidmode

Turn raid protection on or off by hand.

/raidmode enabled:<boolean>

enabledboolean
Required.On or off
  • Needs Manage Server

Welcome and goodbye2

/welcome test

Preview the welcome message as if you had just joined.

/welcome test

  • Needs Manage Server

/goodbye test

Preview the goodbye message.

/goodbye test

  • Needs Manage Server

Levels and XP6

/rank

Show your level card, or another member's.

/rank [user:<user>]

useruser
Optional.Whose card to show (yours if empty)

Example: /rank user:@Mia

/leaderboard

See the members with the most XP.

/leaderboard [page:<integer>]

pageinteger
Optional.Page number

/levels rewards

List the roles members earn at each level.

/levels rewards

/xp add

Give a member XP.

/xp add user:<user> amount:<integer>

useruser
Required.The member
amountinteger
Required.How much XP to add
  • Needs Manage Server

/xp remove

Take XP from a member.

/xp remove user:<user> amount:<integer>

useruser
Required.The member
amountinteger
Required.How much XP to remove
  • Needs Manage Server

/xp reset

Reset a member's XP and level to zero.

/xp reset user:<user>

useruser
Required.The member
  • Needs Manage Server

Role menus4

/role add

Give a member a role.

/role add user:<user> role:<role>

useruser
Required.The member
rolerole
Required.The role to give
  • Needs Manage Roles

/role remove

Take a role from a member.

/role remove user:<user> role:<role>

useruser
Required.The member
rolerole
Required.The role to take
  • Needs Manage Roles

/rolemenu list

List this server's role menus and where they're posted.

/rolemenu list

  • Needs Manage Roles

/rolemenu repost

Post a role menu again, for example after its message was deleted.

/rolemenu repost menu:<string> [channel:<channel>]

menustring
Required.The role menu
channelchannel
Optional.Where to post it (its usual channel if empty)
  • Needs Manage Roles

Custom commands3

/custom list

List this server's custom commands.

/custom list

/custom create

Create a quick text command. Use the dashboard for embeds and roles.

/custom create name:<string> response:<string>

namestring
Required.The command name, like rules
responsestring
Required.What it replies with

Example: /custom create name:rules response:Be kind.

  • Needs Manage Server

/custom delete

Delete a custom command.

/custom delete name:<string>

namestring
Required.The command to delete
  • Needs Manage Server

Embeds and announcements2

/announce

Post an announcement as Wattle Bot, with an optional role ping.

/announce channel:<channel> message:<string> [ping:<role>]

channelchannel
Required.Where to post it
messagestring
Required.The announcement
pingrole
Optional.A role to ping with it
  • Needs Manage Server

/schedule list

List the scheduled messages in this server.

/schedule list

  • Needs Manage Server

Social alerts2

/alerts list

List the stream, upload and feed alerts in this server.

/alerts list

  • Needs Manage Server

/alerts test

Post a test alert to check how it looks.

/alerts test alert:<string>

alertstring
Required.The alert to test
  • Needs Manage Server

Giveaways4

/giveaway start

Start a giveaway in this channel.

/giveaway start prize:<string> duration:<string> [winners:<integer>] [required_role:<role>] [min_level:<integer>]

prizestring
Required.What the winners get
durationstring
Required.How long it runs, like 1h or 3d
winnersinteger
Optional.How many winners (1 if empty)
required_rolerole
Optional.A role members need to enter
min_levelinteger
Optional.The lowest level that can enter

Example: /giveaway start prize:Desk microphone duration:3d winners:2

  • Needs Manage Server

/giveaway end

End a giveaway now and draw the winners.

/giveaway end giveaway:<string>

giveawaystring
Required.The giveaway
  • Needs Manage Server

/giveaway reroll

Draw a new winner for a finished giveaway.

/giveaway reroll giveaway:<string>

giveawaystring
Required.The giveaway
  • Needs Manage Server

/giveaway list

List the giveaways running in this server.

/giveaway list

Polls2

/poll create

Start a poll with up to 10 options.

/poll create question:<string> options:<string> [duration:<string>] [anonymous:<boolean>]

questionstring
Required.What you're asking
optionsstring
Required.The answers, separated by commas
durationstring
Optional.How long it stays open, like 1h (24h if empty)
anonymousboolean
Optional.Hide who voted for what

Example: /poll create question:Game night? options:Friday, Saturday, Sunday

/poll end

Close a poll and show the final results.

/poll end poll:<string>

pollstring
Required.The poll

Suggestions3

/suggest

Share an idea in the suggestions channel.

/suggest idea:<string>

ideastring
Required.Your suggestion

/suggestion approve

Approve a suggestion and let its author know.

/suggestion approve number:<integer> [reason:<string>]

numberinteger
Required.The suggestion number
reasonstring
Optional.A note for the author
  • Needs Manage Messages

/suggestion decline

Decline a suggestion, with a reason for its author.

/suggestion decline number:<integer> [reason:<string>]

numberinteger
Required.The suggestion number
reasonstring
Optional.Why it was declined
  • Needs Manage Messages

Birthdays3

/birthday set

Save your birthday (day and month, never the year).

/birthday set day:<integer> month:<string> [timezone:<string>]

dayinteger
Required.Day of the month
monthstring
Required.MonthChoices: January, February, March, April, May, June, July, August, September, October, November, December
timezonestring
Optional.Your time zone, like Australia/Brisbane

/birthday remove

Delete your saved birthday.

/birthday remove

/birthday upcoming

See whose birthday is coming up.

/birthday upcoming

Reminders3

/remind

Set a reminder. Use a time like 30m, 2h or 3d.

/remind in:<string> message:<string> [dm:<boolean>]

instring
Required.When, like 30m, 2h or 3d
messagestring
Required.What to remind you about
dmboolean
Optional.Send it by direct message

Example: /remind in:2h message:Book the courts

  • Works anywhere with the app on your account

/reminders list

List your reminders.

/reminders list

  • Works anywhere with the app on your account

/reminders delete

Delete one of your reminders.

/reminders delete reminder:<string>

reminderstring
Required.The reminder
  • Works anywhere with the app on your account

Music16

/play

Play a song or add it to the queue.

/play song:<string>

songstring
Required.A song name or link

Example: /play song:Wattle Season

/pause

Pause the music.

/pause

/resume

Carry on playing.

/resume

/skip

Skip the current song, or vote to skip it.

/skip

/stop

Stop the music and clear the queue.

/stop

/nowplaying

Show the current song and how far through it is.

/nowplaying

/volume

Set the volume, from 1 to 100.

/volume level:<integer>

levelinteger
Required.1 to 100

/loop

Repeat the current song or the whole queue.

/loop mode:<string>

modestring
Required.What to repeatChoices: Off, Song, Queue

/seek

Jump to a point in the current song, like 1:30.

/seek position:<string>

positionstring
Required.Where to jump to, like 1:30

/queue show

Show what's playing and what's next.

/queue show [page:<integer>]

pageinteger
Optional.Page number

/queue remove

Remove a song from the queue.

/queue remove position:<integer>

positioninteger
Required.Its place in the queue

/queue move

Move a song to a new place in the queue.

/queue move from:<integer> to:<integer>

frominteger
Required.Its place now
tointeger
Required.Its new place

/queue shuffle

Shuffle the queue.

/queue shuffle

/queue clear

Clear the queue but keep the current song.

/queue clear

/leave

Stop the music and leave the voice channel.

/leave

/247

Keep Wattle Bot in your voice channel around the clock.

/247 enabled:<boolean>

enabledboolean
Required.On or off
  • Needs Manage Server

Text to speech7

/tts join

Join your voice channel and read this channel aloud.

/tts join

/tts leave

Stop reading and leave the voice channel.

/tts leave

/tts say

Read one message aloud in your voice channel.

/tts say text:<string>

textstring
Required.What to say

/tts skip

Skip the message being read.

/tts skip

/tts voice

Choose the voice your messages are read in.

/tts voice voice:<string>

voicestring
Required.The voice

/tts speed

Choose how fast your messages are read.

/tts speed percent:<integer>

percentinteger
Required.50 to 200, where 100 is normal

/tts name

Set how your name is said aloud.

/tts name name:<string>

namestring
Required.Your name, spelt the way it sounds

Temporary voice channels6

/voice name

Rename your temporary voice channel.

/voice name name:<string>

namestring
Required.The new name

/voice limit

Set how many people can join your channel.

/voice limit number:<integer>

numberinteger
Required.0 for no limit, up to 99

/voice lock

Stop new people joining your channel.

/voice lock

/voice unlock

Let people join your channel again.

/voice unlock

/voice kick

Remove someone from your channel.

/voice kick user:<user>

useruser
Required.Who to remove

/voice transfer

Hand your channel over to someone else.

/voice transfer user:<user>

useruser
Required.The new owner

Tickets5

/ticket open

Open a private support ticket.

/ticket open [topic:<string>]

topicstring
Optional.What it's about

/ticket close

Close this ticket and save a transcript.

/ticket close [reason:<string>]

reasonstring
Optional.Why, for the case history and the member's message

/ticket add

Add someone to this ticket.

/ticket add user:<user>

useruser
Required.Who to add

/ticket remove

Remove someone from this ticket.

/ticket remove user:<user>

useruser
Required.Who to remove

/ticket claim

Mark this ticket as yours to handle.

/ticket claim

  • Needs Manage Messages

Utilities11

/help

List Wattle Bot's commands, or get help with one.

/help [command:<string>]

commandstring
Optional.A command to explain
  • Works anywhere with the app on your account

/setup

Get a checklist for setting up Wattle Bot in this server.

/setup

  • Needs Manage Server

/dashboard

Get a link to this server's dashboard.

/dashboard

  • Needs Manage Server

/serverinfo

Show details about this server.

/serverinfo

/userinfo

Show details about a member.

/userinfo [user:<user>]

useruser
Optional.Who to look up (you if empty)
  • Works anywhere with the app on your account

/roleinfo

Show details about a role.

/roleinfo role:<role>

rolerole
Required.The role

/avatar

Show someone's avatar in full size.

/avatar [user:<user>]

useruser
Optional.Whose avatar (yours if empty)
  • Works anywhere with the app on your account

/afk

Set an AFK message. People who mention you will see it.

/afk [message:<string>]

messagestring
Optional.What to tell people

/ping

Check that Wattle Bot is responding, and how quickly.

/ping

  • Works anywhere with the app on your account

/invite

Get the link to add Wattle Bot to another server.

/invite

  • Works anywhere with the app on your account

/premium

See this server's plan and what Premium adds.

/premium

Try them in your own server.

Add Wattle Bot in a minute, then set it up your way. Questions? The team is in our Discord server.

  • Free to add
  • Every permission explained
  • Set up from the dashboard