Add Custom Widgets in Streamlabs Desktop
Streamlabs Desktop lets you overlay custom widgets—like alerts, chat boxes, or donation goals—onto your live stream. This guide walks you through adding a widget from the built-in library, a custom URL, or a locally saved file, and covers common setup pitfalls.
What You’ll Need
- Streamlabs Desktop installed and logged in (free account is fine).
- For custom URL widgets: a hosted webpage (e.g., from Streamlabs, StreamElements, or your own site) that provides the widget’s HTML/JS.
- For local file widgets: an HTML file (with associated CSS/JS) saved on your computer.
Step-by-Step
- Open Streamlabs Desktop and go to the Editor tab (the default view when you launch).
- In the Sources box (bottom left), click the + button to add a new source.
- From the list, choose Custom Widget and click Add Source, or drag it into your scene.
- Name your widget (e.g., “Chat Box”) and click Add Source.
- A properties window opens. Here you have three main options:
- Widget URL: Paste the full URL of the widget you want to load (e.g., from Streamlabs’ own widget library or a third-party service).
- Local File: Click Browse and select an HTML file from your computer.
- Custom Widget (if available): Some versions allow you to paste raw HTML/CSS/JS directly into the editor.
- After entering the URL or selecting the file, click Done.
- The widget appears in your scene. Drag it to position it, and resize it using the red handles.
- To adjust settings (like size, opacity, or refresh rate), double-click the source in the Sources list to reopen its properties.
- For widgets that need interaction (e.g., alerts), test by triggering a test event (click the Test button in the widget’s settings if available) or by visiting the widget’s URL in a browser.
Common Mistakes
- Using a non-HTTPS URL: Streamlabs requires secure connections. If your URL is HTTP, it may fail to load. Always use HTTPS.
- Forgetting to enable the source: If the widget isn’t visible, check that the eye icon next to the source is open (not crossed out).
- Placing the widget behind other sources: In the sources list, sources higher up appear on top. Drag your widget up if it’s hidden behind a webcam or overlay.
- Not refreshing after editing: If you edit the widget’s code or URL, click the Refresh button (circular arrow) in the properties window to reload it.
Tips
- Use a test stream (private or unlisted) to verify widgets work before going live.
- For local files, keep all associated files (CSS, JS, images) in the same folder as the HTML file, and reference them with relative paths.
- If you’re using a custom widget from a service like StreamElements, copy the exact URL they provide—it often includes a unique ID.
- Set a reasonable Width and Height in the widget properties to match your stream’s resolution (e.g., 1920×1080).
- Use the Preview button (play icon) in the source properties to see how the widget behaves without going live.
Troubleshooting
Widget not showing up at all
- Check that the source is enabled (eye icon open).
- Verify the URL is correct and accessible in a browser. If it’s a local file, ensure the path has no special characters.
- Restart Streamlabs Desktop. Sometimes the widget fails to load due to a temporary glitch.
Widget shows a blank white box
- This often means the widget’s code failed to load. Open the widget’s URL in a browser and check for errors (F12 console).
- If it’s a local file, make sure all linked files are present and the HTML is valid.
Widget is there but not interactive (e.g., alerts don’t pop)
- Many widgets require you to connect them to your streaming account (Twitch, YouTube) within the widget’s own settings. Look for a settings gear icon on the widget source.
- Test the widget by triggering a test event from the widget’s dashboard (e.g., send a test alert).
Widget loads but is misaligned or too small
- Adjust the source’s Width and Height in properties. Some widgets have a fixed aspect ratio—resize carefully.
- Use the Fit to Screen button (if available) in the properties to auto-size.
Frequently Asked Questions
Can I add a widget from Streamlabs’ own library?
Yes, Streamlabs offers a library of pre-made widgets (alerts, chat, goals) that you can add via the same Custom Widget source—just paste the provided URL.
Do I need to be a Streamlabs Prime member?
No, basic custom widgets work with a free account. Some advanced features or premium widgets may require Prime.
Can I use a widget from a different platform like StreamElements?
Yes, as long as the widget is served via HTTPS and is designed to be embedded, you can paste its URL into the Custom Widget source.
How do I update a widget’s code after adding it?
For URL-based widgets, edit the code on the hosting platform and refresh the widget in Streamlabs (click the refresh icon). For local files, edit the HTML file and refresh.
Why is my widget not showing up in OBS?
Streamlabs Desktop and OBS are separate programs. If you’re using OBS, you need to add the widget as a Browser Source, not a Custom Widget. The steps are similar but not identical.
Can I add multiple custom widgets to one scene?
Absolutely. Add as many Custom Widget sources as you need, and arrange them as you like.
Related
Method: the standard formula for this calculation, rounded as each result states. See how the calculators work or report an error.