Streamlabs Chat Box Widget: Desktop & OBS Setup
This guide walks you through setting up the Streamlabs chat box widget so your stream can display live chat on-screen. You’ll learn how to get the widget URL from Streamlabs Desktop or the website, add it as a browser source in OBS Studio or Streamlabs Desktop, and customize it to match your stream’s look. No prior experience with browser sources is needed.
What You’ll Need
- A Streamlabs account (free) and access to the Streamlabs website or Streamlabs Desktop app.
- OBS Studio (free) or Streamlabs Desktop (free) installed on your streaming PC.
- Your streaming platform (Twitch, YouTube, etc.) linked to your Streamlabs account.
Step-by-Step
- Open Streamlabs and go to the Chat Box widget. If you use Streamlabs Desktop, click the gear icon (Settings) in the left sidebar, then select “Chat Box” under the “Overlays” section. If you prefer the website, go to streamlabs.com, log in, and click “Dashboard” → “All Widgets” → “Chat Box”.
- Copy the widget URL. On the Chat Box settings page, you’ll see a “Widget URL” field (often labeled “Copy” with a clipboard icon). Click it to copy the full URL to your clipboard. This URL is unique to your account and will pull your chat into the browser source.
- Customize the appearance (optional but recommended). Scroll down on the same page to adjust settings like text color, font, background, and whether to show badges or avatars. You can also set a custom CSS to fully style the chat. Changes save automatically.
- Open OBS Studio or Streamlabs Desktop. In OBS Studio, go to your scene (the one where you want chat visible) and click the “+” under “Sources”. In Streamlabs Desktop, the same “+” is in the Sources box. Choose “Browser” (OBS) or “Browser Source” (Streamlabs).
- Create a new browser source. Name it something like “Chat Box” and click “OK”. In the properties window, paste the widget URL into the “URL” field.
- Set the width and height. Enter a resolution that fits your stream layout—common values are 400×600 for a side chat, or 1920×1080 for a full-screen overlay. You can also check “Custom CSS” and leave it blank for now.
- Adjust advanced settings. Check “Shutdown source when not visible” if you want to save resources when the chat is hidden. Keep “Refresh browser when scene becomes active” unchecked unless you need it. Click “OK” to add the source.
- Position and resize the chat. In the canvas, drag the chat box to your preferred location. Use the red bounding box to resize it. Hold Shift to keep aspect ratio if needed. Test by sending a message in your chat—it should appear in the source.
- Test and go live. Send a few test messages (you can use a second account or a friend) to confirm the chat updates in real time. If it works, you’re done. If not, see Troubleshooting below.
Common Mistakes
- Using the wrong URL. Some users copy the “Stream URL” or “Overlay URL” from other widgets. Make sure it’s the Chat Box widget URL specifically.
- Forgetting to set a custom CSS. If you want to hide the background or change fonts, you must add CSS. Without it, the chat may have a solid background that blocks your game.
- Setting the browser source to a tiny size. A 200×200 chat box will be hard to read. Use at least 400×600 for a side panel.
- Not refreshing after changing widget settings. If you change colors or fonts in Streamlabs, the browser source may not update immediately. Refresh it (see Troubleshooting).
Tips
- Use a transparent background. In the Chat Box settings, set “Background” to “Transparent” or add CSS like
body { background: transparent; }to overlay chat directly on your game. - Add a delay for safety. In the Chat Box widget settings, you can set a “Delay” (in seconds) to prevent spoilers or inappropriate messages from showing instantly. A 5–10 second delay is common.
- Use “Text to Speech” sparingly. If you enable TTS, test it first—it can be annoying if every message is read aloud. Use the “TTS” toggle only for specific events.
- Combine with a chat overlay theme. Streamlabs offers pre-made themes (like “Minimalist” or “Neon”) that you can apply to the chat box to match your stream branding.
Troubleshooting
- Chat is not showing at all. First, confirm the widget URL is correct by opening it in a browser—you should see your chat. If it shows a blank page, your Streamlabs account may not be linked to your streaming platform. Re-link it in Streamlabs settings. In OBS, check that the browser source is visible (eye icon) and not hidden behind other sources.
- Chat shows but doesn’t update. This usually means the browser source is cached. Right-click the source → “Refresh” (OBS) or “Refresh Browser Source” (Streamlabs). Also, make sure your streaming platform is connected to Streamlabs and that you’re actually receiving chat (test with a message).
- Chat has a white or black background. You need to set the background to transparent. In the Chat Box widget settings, set “Background” to “Transparent” or add CSS:
body { background: rgba(0,0,0,0); }. Then refresh the browser source. - Chat is too small or blurry. Increase the browser source resolution (e.g., 800×600) and use a higher “Custom CSS” font size. Also, make sure you’re not scaling the source up too much in the canvas—that causes blur.
- Widget URL shows an error. If you see “404” or “Access Denied”, your Streamlabs session may have expired. Log out and log back in on the website, then copy the URL again. Also, ensure you’re not using a URL that includes “localhost” or a preview link.
Frequently Asked Questions
Can I use the chat box widget without Streamlabs Desktop?
Yes. The widget URL works in any browser source, including OBS Studio, Streamlabs Desktop, or even a web browser for testing.
How do I make the chat box transparent?
In the Chat Box widget settings, set “Background” to “Transparent”. If that doesn’t work, add custom CSS: body { background: transparent; }.
Why does my chat box show old messages?
The widget shows recent chat history by default. You can clear it by refreshing the browser source or by adding ?m=1 to the end of the widget URL to only show new messages.
Can I have multiple chat boxes for different platforms?
Yes, you can create multiple browser sources, each with a different widget URL (one for Twitch, one for YouTube, etc.). Just make sure each URL is from the correct platform’s chat box.
Does the chat box work with mobile streaming?
No, the chat box widget is designed for desktop streaming software. For mobile, you’d need a separate app or overlay.
How do I remove the chat box from my stream?
Simply delete the browser source from your scene in OBS or Streamlabs Desktop. You can also hide it by clicking the eye icon next to the source.
Related
Method: the standard formula for this calculation, rounded as each result states. See how the calculators work or report an error.