There are various reasons that your alerts/widgets could not be working. A widget is a source type that you can add to your stream to help make your stream more interactive. Widgets can be added as a widget source in Streamlabs Desktop, or as browser sources in other streaming software. This guide focuses on all of our widgets, which you can find here.
- The first step is always to log out of Streamlabs Desktop and Streamlabs.com, then log back in. If you are having issues with a particular streaming platform's alerts, be sure to sign back in with that platform on the sign in page.
- If you are editing your alerts/widgets on a web browser, be sure to disable any browser extensions. Certain browser extensions such as dark reader can interfere with the controls on our website.
General Troubleshooting
Check your profanity filters. You can check this on Streamlabs.com > Alert Box > General and check the profanity settings and custom bad words (your custom words may not be set correctly)
2. Check to ensure that Unlimited Alert Moderation Delay is disabled. Unlimited Alert Moderation delay forces you to press "accept" each time an event is received and to trigger the alert to come up on the screen. If you would like to use Unlimted Alert Moderation Delay, you will need to give a moderator or your channel shared access so they can accept the alerts for you, or accept every alert yourself before it will be displayed. Any unaccepted alerts will not play.
Go to Streamlabs.com > Alert Box > General Settings > Unlimited Moderation Delay
3. You may have misconfigured Alert Variations. Disable your alert variations or check to ensure that you do not have any missing information for each of the variations.
-Go to Streamlabs.com > Alert Box > Alert type (follows/bits/subs)> Manage Variations> Disable any alert variations. If you would like to delete the variation, you will need to press > Delete and confirm the action.
4. In your recent events list, at the top right, ensure that you do not have your alert sounds muted.
*Note that previewing from the settings page will not be affected by this setting.
Unmuted:
Muted:
5. Make sure that your alerts aren't paused in your recent events list at the top right.
*Note that previewing from the settings page will not be affected by this setting.
Unpaused:
Paused:
6. Check whether you have Custom CSS/HTML enabled. Please ensure you have this disabled unless you created the CSS/HTML yourself or you installed a premade theme. Note that custom code is required for some premade themes to function properly, and changing settings while custom code is enabled may not be reflected, as custom code takes priority.
7. Refresh your browser source by deleting all of your widget sources and re-adding one.
8. Relink your account. You can follow how to do that here.
9. Ensure your streaming software is allowed through your firewall/antivirus software. We have a guide on how to do this here for your Windows Firewall.
10. There may be an iPV6 issue. Please follow our guide here on how to rectify that.
11. Check your date & time settings. If your Windows Date/Time settings are incorrect this could cause an issue.
12.Clear your cache files in your streaming software. You can do that by:
- Closing Streamlabs Desktop/OBS Studio
- Hit the Windows key + R
- Paste the following and hit enter: %appdata%/slobs-client/plugin_config/obs-browser (Streamlabs Desktop) or %appdata%/obs-studio/plugin_config/obs-browser
- Delete the folder, then re-open the software and add your alerts
- Run a test alert
13. Reset your API Token. Please note that doing this will require you to update all of your Streamlabs Widget URLs in all of your sources.
- Remove all Streamlabs Widgets from your streaming software
- Go into your API Settings > API Tokens Tab
- Click Refresh (and confirm the popup)
Then in Streamlabs Desktop
- Log out & close the program
- Run as administrator & log back in
Other Software
- Re-add your new widget links
- Run a Test Alert
Additional Troubleshooting
Can't Hear Alert/Widget
- Click on the gear to the right of your Mixer to launch your Advanced Audio Settings. Monitor Only (Mute Output) should work for the majority of people. If your monitoring device is different than your desktop audio device, please select monitor and output.
- You will also want to ensure that your Alertbox audio is ticked for every track that you wish for it to sound for multitrack recording (for stream audio by default you would choose track 1).
- Right-click your alert box > properties > sources. Tick the "Route Audio to OBS" option
Visual Issues
- Sources are set in a layering system. You need to more the source up in the layers list if you cannot see it. https://i.gyazo.com/48e3b64b3baf8e916e1a122ae02396b6.gif
- Try turning on or off browser hardware acceleration (Settings > Advanced > Sources > Enable Browser Source Hardware Acceleration). Then restart Streamlabs Desktop or OBS Studio
- You have the wrong Widget Theme selected, or you have a different widget theme associated with your current scene collection in Streamlabs Desktop.
In Streamlabs.com > Alert Box > Widget Themes, ensure that the correct widget theme is selected in the dropdown for your scene collection.
Your currently active widget theme is shown in the top right of the Alert Box dashboard
You can view and manage all of your widget themes on the Widget themes management page. Here you can see both your currently active Widget theme, as well as which widget themes you have associated with which scene collections for Streamlabs Desktop. - Check to make sure you have alert animations. If you do not have an alert animation enabled for both "Show" and "Hide" an alert can get stuck (unless you have written this into your custom code). You can check that in Streamlabs Desktop or Streamlabs.com
Go to Streamlabs.com > Alert Box > Follows/Subscriptions/Donations/Etc. Note: an animation is not required if you have custom code that includes animations. Text animation can be set to "none". - Ensure your alert duration is set correctly. If you have a very short alert duration, then the alert would not populate for as long as you would like.
Go to Streamlabs.com > Alert Box > Follows/Subscriptions/Donations/Etc. > Alert Duration and use the slider to drag to the appropriate length.
Platform-Specific
Twitch
- If someone resubscribes and doesn't share the resub in chat on their end no alert/notification will be shown on our end, due to API limitations. Ask your subscribers to share their resubs in chat
YouTube
- If the person who is subscribing has their privacy settings enabled to not share their subs, then unfortunately no alert/notification will show on our end due to API limitations
- YouTube now has a delay for subscriber alerts, which can take up to 4 hours. Unfortunately, there is nothing we can do about this at this time.
- If a user has their Facebook sharing settings set to private, it may not trigger an alert.