Troubleshooting
This page is organized by symptoms, so you can quickly decide whether something is related to Sudden and what to try next.
Video plays, but we see no savings
- Check that Sudden is loaded on the pages where you play video.
- Make sure Sudden is initialized exactly once per page load.
- Confirm that there are enough concurrent viewers for the same content.
- Look at your browser console on a test page for any obvious initialization errors.
If everything looks healthy but savings remain low, sparse traffic is one possible reason.
Our player broke after adding Sudden
- Temporarily disable Sudden and redeploy. If the issue remains, it is likely unrelated to Sudden.
- If disabling Sudden fixes the issue, check for:
- JavaScript errors in the browser console.
- Sudden being initialized more than once.
- Any custom logic you added around Sudden that might interfere with your player.
It works for some users, not others
- Compare browsers and devices: some older setups might not support Sudden and will quietly fall back to your CDN.
- Check whether affected users are on corporate networks, VPNs, or very restrictive environments.
- Confirm that the affected pages use the expected Sudden integration and client ID.
We see unexpected errors in the console
- Note the exact error message and on which page it appears.
- Confirm that you are using the recommended integration pattern from Getting started.
- Confirm that the
clientIdin your Sudden config is correct. - Try on a clean browser profile or incognito window to rule out extensions.
- If your site enforces CSP, make sure all required Sudden sources are allowed. See the CSP requirements.
If you still see errors, gather:
- The page URL.
- A screenshot or copy of the error.
- Browser and device information.
and share them with your Sudden contact or support channel.
When in doubt
If you are unsure whether an issue is related to Sudden:
- Disable Sudden on the affected page or property.
- Compare behavior before and after.
If the issue disappears when Sudden is disabled, reach out with the details above and we will help you work through it.
Last updated on