OverlayThing Docs
Home
Login / Request Access
01 Get started
Introduction Quickstart Add to your stream
02 Overlays
Overlays The editor Overlay URLs Alert queue Share, export & import
02.1 Widgets
Widgets overview Alerts Variations Hype Train Text to speech Goals Countdown & subathon Chat box Data labels Counter Text, image & video
03 Chatbot
Chatbot overview Getting started Commands Variables Conditionals Recipes API commands Integrations Command API & Copy-URL Chat moderation Bot settings
03.1 Chatbot modules
Modules overview Timers Counters Quotes Chat alerts Welcome Giveaways Queue Song requests Loyalty
04 Remote Control
Overview Connect OBS Studio Connect Meld Studio Bindings & triggers Security & access
05 Monetize
Tip page Tip settings Merch with Fourthwall
06 Build your own
AI Magic Builder Custom widgets Widget SDK
07 Your data
Dashboard Stream data Chat log Moderation
08 Account
Settings & connections Export your data Import from StreamElements
09 Reference
Label tokens Keyboard shortcuts Troubleshooting
Your data/Moderation
Your data

Moderation.

Every chat message, tip note and alert message runs through a moderation pipeline before it reaches your overlay or gets read aloud. You add your own banned words and decide where moderation applies; OverlayThing handles the heavier filtering automatically.

What happens to a message

When text comes in, it is checked layer by layer and ends in one of three outcomes:

OutcomeWhat it means
AllowedNothing matched. The message shows and is read aloud normally.
RedactedSpecific words were replaced (with [redacted] on your overlay, or *** on the tip page). The rest of the message still shows.
BlockedThe whole message is hidden. Viewers see nothing, and it is never read aloud.

What you control

Banned words

In Settings, under Moderation, keep your own list of banned words and phrases (type them comma or line separated). Matching is case-insensitive, and your words are redacted rather than blocking the whole message. They apply across your chat box, alert text, text to speech, and tip page messages. Banned words imported from StreamElements land in this same list.

Chat box filtering

Your chat box widget has its own switches: turn moderation on or off for that widget, include or hide your own messages, and exclude bot accounts. These are per widget, so two chat boxes can behave differently.

What runs automatically

On top of your banned words, OverlayThing applies platform-wide protection you do not have to configure:

  • A global blocklist of known-bad content.
  • Link filtering, so raw URLs do not get read aloud or splashed on screen.
  • Spam guards for things like all-caps walls and emoji floods.
  • AI moderation that catches hateful, harassing or explicit content even when no specific word is on a list.

You cannot tune these yourself, but you always see when they fire.

Reviewing what was caught

Moderated events are not silent. On your dashboard activity feed, anything redacted or blocked carries a badge you can expand to see what triggered it, the original text, and exactly what your viewers saw. Your chat log also keeps a moderation record you can search.

Get pinged in Discord

In Settings, under Moderation, add a Discord webhook and OverlayThing will post there whenever something is caught, with the original message, the cleaned version, and the reason. Handy for catching what slipped past on a busy stream.

For custom widgets

If you build a custom widget that shows viewer text, run it through the same pipeline with the SDK sanitize call before displaying it, so your custom code respects the same rules as everything else.

What you see vs what viewers see

You always see the original text in your own tools so you know what happened. Viewers only ever get the cleaned or blocked result.

Previous Chat log Next Settings & connections
On this page
Ask the docs
Have a question?
Thinking it through...
Answer
Get an answer instantly; our model is trained on every feature of our streaming suite.
ESC
Get started
More than overlaysOverlayThing is an all-in-one toolkit for your Twitch channel: a visual overlay … Get started From zero to liveThe fastest path to a working overlay on your stream. Sign in, build something, … Get started Add to your streamOne overlay, one URL, one browser source. OverlayThing works with any streaming … Get started
Overlays
OverlaysYour overlays live on the Overlays page, a gallery of every canvas you have buil… Overlays The editorWhere overlays are built. A canvas in the middle, your layer stack on the left, … Overlays Overlay URLsEach overlay has its own private URL. Add it to your streaming software once and… Overlays Alert queueWhen events pile up (a gifted-sub train, a hype raid), you usually want alerts t… Overlays Share, export & importMove overlays and individual widgets between your own overlays, back them up as … Overlays
Widgets
Widgets overviewWidgets are the building blocks of an overlay. Some fire on an event and leave (… Widgets AlertsThe moment something happens, an alert fires on screen with motion, sound and yo… Widgets VariationsOne event, different reactions. Variations let a single alert play a bigger vers… Widgets Hype TrainWhen a Hype Train rolls on your channel, OverlayThing can fire an on-screen aler… Widgets Text to speechHave alerts read messages aloud: a tip note, a resub message, a redemption. Text… Widgets GoalsA progress bar with a target. It fills itself as events come in, and you can cel… Widgets Countdown & subathonTwo timer widgets. A countdown runs down to a time or for a set duration. A suba… Widgets Chat boxPut your Twitch chat on stream, great for handheld, IRL or face-cam layouts wher… Widgets Data labelsSmall live readouts that keep your channel numbers on screen: latest follower, l… Widgets CounterPut a live number on your overlay: deaths, wins, fails, anything you keep a runn… Widgets Text, image & videoThe plain building blocks. Use them for backgrounds, frames, logos, panels and l… Widgets
Chatbot
The chatbotA Twitch chat bot built into OverlayThing: custom commands, timers, counters, qu… Chatbot Getting startedTurn the bot on, make it a moderator, and pick your command prefix. Three small … Chatbot CommandsCommands are the heart of the bot. A viewer types a trigger, the bot replies wit… Chatbot VariablesVariables are $( … ) tokens you drop into a command response. They fill in with … Chatbot ConditionalsConditionals let one command react differently to different viewers and situatio… Chatbot RecipesCopy-ready command responses for the trickier variables: shoutouts, weather, dic… Chatbot API commandsPower-user territory. Wire a command to an external API and pull a live value in… Chatbot IntegrationsBuilt-in connections to outside services that add ready-made variables. Today th… Chatbot Command API & Copy-URLFire bot commands and module actions from outside chat: a Stream Deck button, a … Chatbot Chat moderationWhen the bot is a moderator it can keep chat clean automatically: tunable spam f… Chatbot Bot settingsThe channel-wide behavior of the bot: your prefix, how it replies, how cooldowns… Chatbot
Chatbot modules
ModulesThe bot is built from modules you switch on one at a time. Turn on only what you… Chatbot modules TimersPost recurring messages on a schedule: rules, your socials, a sponsor plug. Time… Chatbot modules CountersTrack a number from chat: deaths, wins, fails, anything you want to tally live.… Chatbot modules QuotesA searchable quote book your chat builds with you, one memorable line at a time.… Chatbot modules Chat alertsPost a chat message when someone follows, subscribes, resubs, gifts, cheers or r… Chatbot modules WelcomeGreet people automatically: first-time chatters, returning regulars, and incomin… Chatbot modules GiveawaysRun a giveaway and draw a winner from chat, by keyword entry or passive presence… Chatbot modules QueueLet viewers line up to play with you. They join, you pull people up in order.… Chatbot modules Song requestsViewers request YouTube songs by name or link and the bot builds a play queue, w… Chatbot modules LoyaltyTrack how long your viewers watch, so you can spot and reward your most loyal re… Chatbot modules
Remote Control
Remote ControlDrive your local OBS Studio or Meld Studio straight from OverlayThing. Switch sc… Remote Control Connect OBS StudioAdd the Remote Control URL as a dock or browser source, enable the OBS WebSocket… Remote Control Connect Meld StudioAdd the blank Remote Control source to every Meld scene. There is no password to… Remote Control Bindings & triggersA binding is one or more actions plus the trigger that fires them. Build them on… Remote Control Security & accessThe Remote Control URL is a key to your streaming software, and your OBS passwor… Remote Control
Monetize
Your tip pageA branded donation page viewers can reach from a single link in your panels or c… Monetize Tip settingsEverything behind your tip page: the payment connection, your branding, the amou… Monetize Merch with FourthwallConnect your Fourthwall shop and merch sales fire alerts on stream, the same way… Monetize
Build your own
AI Magic BuilderDescribe the widget you want in plain language and OverlayThing builds a styled,… Build your own Custom widgetsFor when you want to break the mold. Write your own HTML, CSS and JavaScript, re… Build your own Widget SDKThe API your custom widgets use to receive live events and persist state. It is … Build your own
Your data
DashboardYour home base. The numbers that matter at a glance, a chart to spot trends, and… Your data Stream dataThe numbers behind your overlay. Labels, goals and leaderboards all read from he… Your data Chat logA searchable archive of your chat, events and moderation actions. Look up what a… Your data ModerationEvery chat message, tip note and alert message runs through a moderation pipelin… Your data
Account
Settings & connectionsYour account, your connected services, and the controls that protect your access… Account Export your dataYour data is yours. From Settings, under Data and privacy, you can take it with … Account Import from StreamElementsAlready set up elsewhere? Bring your overlays, alert settings, goals and history… Account
Reference
Label tokensTokens are {placeholders} you drop into alert text, label templates and goal lab… Reference Keyboard shortcutsThe editor is built for the keyboard. These are the ones worth learning.… Reference TroubleshootingQuick fixes for the things that trip people up most.… Reference
↑↓ navigate ⏎ open esc close