How to add chat to OBS
How to add chat on OBS: a Twitch chat dock only you can see, or a chat box overlay viewers see on stream, with sizes, settings and fixes for blank chat.
By Soulstack · Stream production · 6 min read · Published , updated · How we check our guides
In this guide
There are two ways to add chat to OBS Studio, and they do different jobs. To see chat yourself while you stream, connect your Twitch account in Settings > Stream and turn on the Chat dock from the Docks menu, or add any chat page as a custom browser dock. To show chat on stream for viewers, add a chat box widget from an overlay service as a Browser source in your scene.
Decide which one you want first. A dock is part of the OBS window and viewers never see it. A browser source is part of your scene and everyone sees it.
Which one do you need?
| You want to | Use | Viewers see it? |
|---|---|---|
| Read chat without alt-tabbing | A chat dock in OBS | No |
| Moderate quickly while you play | A chat dock with moderation tools | No |
| Show chat reactions in the video, for clips, recordings and full-screen viewers | A chat box browser source | Yes |
| Both | A dock for you and a small chat box for viewers | The chat box only |
Option 1: OBS's built-in Twitch chat dock
This is the fastest way to get chat into OBS.
- Open Settings > Stream, set Service to Twitch and click Connect Account (recommended). Sign in to Twitch.
- Click OK. OBS adds Twitch docks, including Chat and Stream Information.
- If chat does not appear, open the Docks menu and tick Chat.
- Drag the dock where you want it. Docks snap to the edges of the OBS window, or you can float one on a second monitor.
The dock is your normal Twitch chat, signed in as you, so you can reply and use Twitch's own moderation actions from it. If you want chat to run the full height of the window, turn on Docks > Full-Height Docks.
If you stream with a stream key instead of a connected account, these Twitch docks are not added. Use Option 2 instead.
Option 2: a custom browser dock
A custom browser dock shows any web page as a panel in OBS. Use it for Twitch's popout chat or a chat tool with more features.
- Get the address of the chat page. For Twitch's own chat, open your channel, click the chat settings gear, choose the popout option and copy the address of the window that opens.
- In OBS, open Docks > Custom Browser Docks.
- Type a Dock Name, such as Chat, and paste the address into URL.
- Click Apply, then close the window. The dock appears and you can place it like any other.
- If it asks you to sign in, sign in inside the dock. OBS keeps that session separate from your normal browser.
If you want moderation in the same panel, Bearsong has OBS docks for exactly this: a chat dock with moderation tools, and a held messages dock for anything AutoMod is holding, ready to allow or deny. You copy each dock's address from Stream > Overlay studio > OBS docks and add it the same way. The Chat guide explains the moderation actions, such as timeouts, bans, warnings and pins.
Docks need a screen you can see while you play. On a single monitor, keep the dock narrow at one side of the OBS window, or use your phone with the Twitch app as a second screen.
Option 3: chat on stream for viewers
To put chat in the video itself, you need a page built to be shown on stream: a transparent background, large text and old messages that fade out. Most overlay services offer a chat box widget like this.
- In your overlay service, set up the chat box widget and copy its browser source link.
- In OBS, select your Live scene, click + in Sources and choose Browser.
- Paste the link into URL and set Width and Height to the size you want on screen. 400 by 600 suits a corner on a 1920 by 1080 canvas.
- Leave Shutdown source when not visible off, so the chat box keeps up while you are on another scene.
- Drag it into place and drag it above your game in the Sources list so it is drawn on top.
Settings worth getting right in the widget:
- Text size: test against your actual game on a phone screen. Text that looks large on your monitor shrinks a lot on a phone.
- Background: a semi-transparent dark backing behind each message reads better over busy games than no backing at all.
- Message fade: have messages hide after 30 to 60 seconds, so old chat does not sit on screen through a quiet spell.
- Hide bot messages and commands, if your widget allows it, so viewers see conversation, not
!commandsand replies.
Bearsong's Overlay studio has a chat box widget that works this way. It can hide messages that start with ! and messages from bot names you list, fade each message after a number of seconds you choose, and show 5 to 30 messages. Messages that moderators delete also leave the chat box. You add the scene to OBS as one browser source at 1920 by 1080.
Avoid putting Twitch's popout chat page straight into a scene. It shows Twitch's buttons and input box and is not designed for broadcast.
Where to place on-stream chat
- Keep it clear of the game's interface: minimap, health, ammo, subtitles.
- Keep it away from your webcam, so you are not talking over a wall of text.
- In a Just Chatting or IRL scene, chat can be larger and more central, because the conversation is the content.
- In a fast game, a smaller box, or none, is often better. Viewers already have chat beside the player.
On-stream chat earns its space most in clips, highlights and recordings, where chat beside the player is not shown. A small box in the corner keeps the reactions in the video.
Should moderation tools ever be on stream?
No. Anything with moderation actions, viewer details or held messages belongs in a dock, not a scene. Bearsong's own guidance for its docks is the same: docks are for you, so keep them out of the scenes your viewers see. If you have moderators, they can handle chat while you read a plain chat dock, and a Twitch bot can take the repetitive replies and spam filters off everyone's plate. How to moderate Twitch chat covers setting that up.
Common problems
- The dock is blank. Open the page address in a normal browser to check it works, then right-click inside the dock and reload. If it needs a sign-in, sign in inside the dock.
- The Chat dock disappeared. Reconnect your Twitch account in Settings > Stream, then tick Chat in the Docks menu.
- On-stream chat stopped updating. The widget lost its connection. Open the source's properties and press Refresh cache of current page.
- On-stream chat is cut off. The source's width and height do not match the widget. Adjust the size in the source properties, not by stretching it in the scene.
- Custom Browser Docks is missing on Linux. Browser docks are not available in every Linux setup. Check the OBS forums for your distribution and display server.
For every browser source setting, see how to use browser sources in OBS.