¶ Welcome!
Welcome to the Circle Documentation. These docs should answer all of your questions, if they don't, please visit us on our support server.
¶ Latest Release - v2.1
Howdy! We've been hard at work on the following updates!
¶ New Features
Core Settings Updates:
- You can now add globally ignored channels and roles. Circle will completely ignore any commands inside ignored channels and commands from users with an ignored role.
Automod Updates:
- Updated banned words to utilize wildcard and exact cases!
- Duplicated text no longer stands a chance with our duplicated text filter!
- Don't want links? No problem, we have a setting for that!
- Mass mention prevention is here! Fight off those pesky raiders or trolls!
- You now have the ability to have Circle DM users when they're moderated!
Moderation Updates:
- You can now select the number of days to delete on member ban.
Reaction Roles Updates:
- Custom emojis can now be used for Reaction roles!
- You can now supply a message ID for your reaction roles instead of having Circle send one!
- The emoji picker is now dark theme! (Your eyes have been saved.)
- You now have the ability to have Circle DM users when they react!
Welcome Plugin Updates:
- If you have membership screening enabled, you can have Circle wait to give them roles until they're finished!
Autoreply Updates:
- Circle can now use Discord's built-in reply feature to auto-reply to messages!
Logging Updates:
- Circle will now show you the permissions that a role was given/removed upon the role being updated!
- When a role is created Circle will display the permissions it has.
- Circle will now show who gave or removed a role from the user!
Internal Fixes
- Circle Production will no longer 'race with premium' while managing timed moderation actions!
- Made the
pickcommand require more than 1 choice to work - Improved how the
lockandunlockcommands function - Changed the colour of the
unlockmodlog embed to green, rather than red - Permission names across the bot have been changed to match Discord
¶ Previous Release - v2
We know it's been a long day... without you my friend... and we're overjoyed to tell you all about what we did while we were gone! We're very sorry for the extremely long wait for v2, our developers worked extraordinarily hard to make this happen. We promise to begin releasing smaller but more frequent updates from now on. Oh, and Circle Premium is finally here! Read about it and how to get it here.
¶ New Plugins:
- The new, long-awaited Automod plugin, to give your server moderators a well-deserved break! You can read about it in-depth here.
- Circle will be able to automatically mute or ban (depending on how you decide to set it up) when a user continuously triggers your automod.
- This plugin includes various useful filters such as "anti text/image spam", "banned words", "emote spam" and "invite links".
- We can't wait to add even more planned filters for you, such as "zalgo text", "text walls", "spoilers" and many more!
- You can also make Circle automatically respond to text triggers with the new Auto Reply plugin. You can read about it in-depth here.
- Auto-replies have many advanced variables so you can make your Auto Reply extremely advanced, and even change it based on what the user has said!
- You can now make your own commands with the Custom Commands plugin. You can read about it in-depth here.
- Custom Commands also have many advanced variables (and even command variables!) which you can use. We tried our best to ensure you can explore many possibilities with this plugin.
- The new Reaction Roles plugin will allow your members to make Circle give them roles at the click of a button. You can read about it in-depth here.
¶ New Commands:
catfact- Get a random fact about catscoinflip- Flip a coindiagnose- Check if there are any issues with the bot or one of her plugins/commandsdogfact- Get a random fact about dogsenlarge- Enlarge an emojijoke- Get a random jokepanda- Get a picture of a pandapick- Make Circle pick an option out of a set of choicesrating- Make Circle rate you or a mentioned userremindme- Set a reminder, list your current ones, or remove a current oneroles- List all roles in the server, roles with names matching an input search, or roles that a user hasshard- Get information about your servers shardstatus- Get the current status for Circle, Discord, Cloudflare, or Reddityomama- Get a random yo mama joke
Plus one new easter egg command. This command will not be listed anywhere, but anybody may use it.
¶ Command Changes & Improvements:
- The help information for all commands has been updated to be more informative
- Commands which use numbers (such as
membercountorinfo) now have commas separating the numbers (if the number is over 1,000) - Circle's direct message to banned or muted users will now show the duration.
- Rewritten all Moderation commands. They are all faster and consistent with one another. The reasons for all of the commands should also no longer have a ton of special characters within the reason inside of your Audit Log
- The
addrolecommand now has additional checks to make sure Discord will allow you to create the role. It will give detailed error messages if you cannot - Removed the
flatbirdalias for thebirdcommand
- The
casecommand now displays the moderation action date - The
cleancommand has been rewritten so that it doesn't miss a message from Circle - The
delrolecommand now gives more detailed error messages if Circle cannot delete the role for some reason - The
emotescommand can now be used to search for emotes, rather than just list all of them - The
emotescommand now displays how many emotes your server has, and how many your server can currently have - The
emotescommand can now be used to get information about a specific emote - The
emotescommand now has afullsub-command, which allows you to view a full list of emotes with their names - You can now use the
c!help [command]command to check whether you have permissions to run a command or not - The
helpcommand now allows you to search by command category. Sayingc!helpon its own will list all command categories - The
infocommand response has been redesigned - The
inviteinfocommand response has been redesigned & now supports GIF icons - The
lockedcommand is now a Moderation command - The
lockandunlockcommands are now Moderation commands - The
lockandunlockcommands now use different emotes when responding with a success message (
and 
) - The
lockandunlockcommands allow you to simply sayc!lockorc!unlockto immediately lock down the current channel - Added a
notsub-command to thememberscommand. You can use this to specify a role of members that should not be included in the command output - The
modlogscommand now displays the moderation action date - The
modscommand will now list all of your moderator roles, no matter how many you have - The moderator roles listed inside of the
modscommand are now sorted by role positions - The
nickcommand now gives more detailed error messages if Circle cannot change the user's nickname for some reason - The
pluginscommand now allows you to filter through the plugins by filtering out enabled or disabled plugins - The
purgecommand is now a Moderation command - The
purgecommand now has "filters", meaning you can add filters to the messages which you want Circle to delete - The
quotecommand now sees discord.com as a valid message URL - The
quotecommand now allows users to quote messages from an Announcement channel - The
quotecommand now deletes your message when it's run, if it finds a message with your search query - The
quotecommand will give you the same response when the channel doesn't exist/you can't see it, even if the channel does or doesn't exist. That way it isn't suggesting that hidden channels exist - The
roleinfocommand response has been redesigned - The
roleinfocommand now displays whether the role is a Server Moderator or Server Administrator role - The
saycommand now allows you to send a message into a specified channel. You can usec!say #channel [message]to send a message to that channel - The
saycommand no longer requires theManage Messagespermission. If it doesn't have that permission, it just won't delete your message - The
serverinfocommand now lists guild features - The
serverinfocommand now displays the server region in a clean format - The
serverinfocommand now displays the server description at the top of the response (if the server has a description set) - You can now use
m(for minutes) orh(for hours) in theslowmodecommand. You are no longer forced to use seconds - The
slowmodecommand will now display the current slowmode in the specified channel if you don't provide a time - The
statscommand has been deleted - The
uptimecommand now has correctly pluralized words - The
whoiscommand response has been redesigned - The
whoiscommand now displays profile badges - The
whoiscommand now displays whether the user is a Server Moderator or Server Administrator - Added the
whodatalias for thewhoiscommand
¶ New Utility Features:
- You can now enable and disable commands
- Added a global ignored roles and channels for all commands
- We have also added a new reminders system to this update, which you can use with the
remindmecommand. This will allow you to set up a reminder and Circle will then send you a DM once it expires! - You can now find users via their user tag (username#discrim)
¶ Plugin Changes & Improvements:
We've tried our best to listen to suggestions and make huge changes to our current plugins. We have added a plethora of new changes and improvements to our plugins in an attempt to make them easier to use and understand, and make the features stretch even further, giving users different possibilities when using them!
¶ Logging:
- All logging messages have been redesigned
- You can now choose to separate logging channels
- All logging events have been rewritten. They will all now handle Discord errors properly, escape markdown where necessary and work more efficiently
- All channel log events now specify what type of channel it is
- The "Member Join" event now displays the server member count with compact logging
- The "Member Join" event now checks whether the joining member is a bot or not. If they are a bot, it says that the user "was invited" rather than "joined". Additionally, it shows who invited the bot (if it has permissions to view your Audit Log)
- The "Member Update" event now logs multiple role changes in a single message
- The "Member Update" event now supports nickname resets
- Made the "Message Delete" event display the original message send date
- Added support for multiple images to the "Message Delete" event (5 max per message)
- Added a check to the "Message Delete" event in an attempt to make the "Message deleted by..." feature more accurate
- Made the "Message Delete" event more compact friendly. Any deleted images will be sent as attachments now, rather than inside embeds
- Improved caching for the "Message Delete" and "Message Edit" events. Messages will now be cached internally for a longer amount of time, even after bot restarts, making it easier to track any message edit/deletion, even if the messages are really old
- The "Channel Update" event now logs when the bitrate of a voice channel changes
- Added a new emoji parser to the "Message Delete" and "Message Edit" events. When somebody deletes a message with emojis inside of it, Circle will check if she can possibly display the emojis properly. If she can, she'll display them like normal. If she can't, she will hyperlink the name of the emoji with the link to the emoji, meaning moderators will always be able to view it
The "Bulk Message Delete" event has been globally disabled until further notice. It will soon return and will be more user-friendly and easier to understand!
¶ Other:
- You can now select how many reactions are required for the Starboard plugin
- The modlog embed colours have been changed a little bit so it's easier to tell moderations apart from simply scrolling down your modlog channel
¶ Bug Fixes:
With this update, we found a few bugs that needed to be squashed, thanks to a few lovely people who reported sightings! We fixed (and even made major improvements) to some issues that have been found.
- The commands that use a 3rd party API have been rewritten to catch any possible error sent back from the API
- All inconsistent error messages across the bot were changed so they are now all consistent with each other
- Users could only use one of each variable in their Welcome/Leave Messages
- Users could not enable the "Member Update" logging event (this fix was pushed earlier)
- Circle wouldn't log the "Member Leave" event if the user which was leaving had too many roles for Circle to be able to list
- Improved the Starboard module so it works a lot faster and more efficiently. Also fixed a minor bug where it wouldn't ignore the author's reaction from the total reaction count if another user reacts to the message
- Circle would sometimes respond to the
cleancommand with an error, if she tried deleting her messages too quickly - The
emotescommand wouldn't respond if there were too many emotes to list. It now splits into separate embeds - The
lockandunlockcommands wouldn't work properly on a channel with synced permissions - The
mentioncommand would try to mention everyone if the server ID was provided (due to how Discord parses the everyone mention, theeveryonemention still wouldn't work) - The
nickcommand would requestManage Nicknamespermissions, even when Circle is trying to change her own nickname - The
purgecommand didn't ask you forManage Messagespermissions when it needed it - If you ran the
reason lastsub command and you've never moderated anyone, Circle would respond with an error - The
roleinfocommand always said "No" in the "Hoisted" field, even when the role was actually hoisted - The
serverinfochannel count didn't include Announcement/Store channels - The usage for the
whoiscommand said "whois" twice - When running
whoison a user who is not in the server, the embed footer would not appear
Please note that some of these fixes were pushed prior to v2, but were still meant to be part of this update.
¶ Web Updates:
- The website has been completely rewritten!!
- It should be much faster and more enjoyable to use.
- An updated Terms of Service and Privacy Policy.
- A revamped navigation bar, dashboard and verification page for the website.
- Fixed all the pesky mobile bugs when choosing from dropdown menus.
¶ Premium 
That's right! Premium is finally here, here are the new features that you get starting now! Again, we have a separate article on premium that you can read here.
- Fewer limits for Custom Commands, Auto Replies and Reaction Roles.
- A fashionable Premium tag on c!whois.
- A cool Premium role in our community Discord server.
- We left our girlfriends for this update, hopefully your kindness can help us get those back!
- We promise even more, very soon!
Thank you so much for using Circle, we could never have imagined this to be as big as it is. On another note, with everything going on around the world right now, we wish the best for you and your loved ones; stay safe, stay healthy
¶ Credits
These docs wouldn't be possible without the following amazing people.
- Aaaaaron#5115
- pink,#0414
- Sköll#0009
- iiFDCT#0001
- Joe