Spam filters
Use Bearsong's Twitch spam filters to remove links, capitals, symbols, repeats, emote spam and long messages, and time out repeat offenders.
Twitch botLast updated
Spam filters check every message in your Twitch chat and remove the ones that break your rules, such as unwanted links or messages in capitals. Repeat offenders can be timed out for longer each time. Filters help keep chat tidy; they will not catch everything, so keep your moderators involved.
Where to find it#
Open Safety > Moderation > Twitch and go to the Spam filters section. The page lists every filter with what it looks for and a switch to turn it on.
Before you start#
- Turn on the Twitch bot in Settings > Connections and connect your Twitch channel.
- Filters remove messages through your Twitch connection. If Twitch has not given Bearsong permission to delete messages or time people out, the section shows Twitch permission needed with an Update permissions button. Choose it and approve the permissions Twitch asks for.
Turn on a filter#
- Choose Edit on the filter you want.
- Check its settings. Each filter starts with sensible values, listed below.
- Under What happens, choose what the bot does at each offence.
- Choose who to skip in Never filter.
- Add a Reply in chat (optional) if you want the bot to explain why a message went.
- Switch on Filter on and choose Save filter.
You can also use the switch beside a filter in the list. If the filter needs something first, such as a word to block, the editor opens so you can add it.
The filters#
All filters start switched off.
| Filter | What it removes | Settings and starting values |
|---|---|---|
| Links | Links, unless the website is allowed | Allowed websites: one per line, like twitch.tv, up to 100. Pages and subdomains of an allowed website are allowed too. Permit time: 15 seconds to 10 minutes, starting at 1 minute. |
| Capital letters | Messages that are mostly capitals | Most capitals (%): 30 to 100, starting at 70. Fewest letters to check: 5 to 200, starting at 15, so short shouts like GG are left alone. |
| Symbols | Messages full of symbols and punctuation | Most symbols (%): 20 to 100, starting at 50. Fewest characters to check: 5 to 200, starting at 10. |
| Repeated messages | The same message sent again and again | Times the same message is sent: 2 to 20, starting at 3. It is removed when it reaches this number. Within (seconds): 10 to 600, starting at 60. |
| Repeated characters | Long runs of one character | Same character in a row: 5 to 100, starting at 15. |
| Emote spam | Messages with too many emotes or emoji | Most emotes in a message: 2 to 50, starting at 8. Twitch emotes and emoji count. Third party emotes do not. |
| Long messages | Messages that are too long | Longest message (characters): 20 to 500, starting at 300. |
| Blocked words and phrases | Messages that contain a word or phrase you block | Words and phrases: one per line, whole words only, up to 200 of up to 100 characters each. Use * for any letters, such as spam*, at most once inside a word. Add at least one to turn it on. |
Links and emotes are left out when the capital letters and symbols filters count. If a message breaks more than one filter, only the first one acts.
Let one viewer post a link#
With the links filter on, a moderator types !permit name in chat, for example !permit bearfan. That viewer can post one link within the Permit time, and the bot tells them so. !permit follows your command symbol if you change it.
What happens at each offence#
What happens is a ladder of up to six steps: First offence, Second offence and so on. Every step deletes the message. A step can also time the person out, from 10 seconds up to 2 weeks. Anyone past the last step stays on it.
| Filter | Starts as |
|---|---|
| Links | Delete, then 30 seconds, then 10 minutes |
| Blocked words and phrases | Delete, then 10 minutes, then 1 hour |
| Every other filter | Delete, then 30 seconds, then 5 minutes |
Choose Add a step to add a longer one, or remove a step with its remove button. Count offences for sets how long an offence counts against someone, from 1 minute to 1 day, starting at 10 minutes. Offences from any filter add up. After that time without breaking a filter, a viewer starts again at the first step.
Who is never filtered#
You and your moderators are never filtered. Never filter can also skip VIPs or subscribers for one filter:
- Moderators and broadcaster: everyone else is checked. This is the starting choice.
- VIPs and above: VIPs are skipped too.
- Subscribers and above: subscribers and VIPs are skipped too.
Messages that carry Bits, messages from another channel in a shared chat and the bot's own messages are never filtered.
#
Reply in chat (optional) is a short message the bot posts when it removes something, up to 200 characters. {user} becomes the person's name, for example {user}, ask a moderator before posting links. The bot replies to the same person at most once every 30 seconds, so a burst of spam does not flood chat with replies.
See what the filters did#
Every removal and timeout appears in the Mod log section on the same page, with the filter as the reason.
Spam filters and blocked phrases#
The Blocked words and phrases filter is run by the Bearsong bot. Blocked phrases, a separate section on the same page, is Twitch's own list of terms that Twitch hides. Use either or both. The blocked words editor has a Phrases Twitch should hide button that takes you to that section.
Common questions#
A filter is on but messages stay. Check the person is not a moderator or skipped by Never filter. Check for a Twitch permission needed notice at the top of the section and choose Update permissions. If Bearsong cannot time people out, it still deletes the message.
How do I test a filter? Ask a viewer or a second account without a moderator badge to post a test message. Your own messages are never filtered.
Is this the same as Twitch AutoMod? No. AutoMod is Twitch's own tool and holds messages for review; held messages appear in Chat. Spam filters are Bearsong's rules and remove messages straight away. For the other tools on the Moderation page, read the Twitch moderation guide.