Troubleshooting the player


About

When something goes wrong with video playback, the Kaltura Player displays clear error messages to help identify the issue. This article lists the most common error messages and what they mean, so you can understand what’s happening and how to respond.

Common error messages and what they mean

  • Text stream error - The caption or subtitle file couldn’t be loaded.
  • Media stream error  - One or more media streams have failed. 
  • Play manifest error  - The player had trouble loading the media playlist.
  • Cannot load stream - A streaming protocol error occurred.
  • Media unavailable  - You don’t have the correct permissions to view this media.
  • Media casting error - An error occurred while trying to cast, please try again. 
  • VR experience error - The VR-360 plugin ran into an error, please try again later.
  • Media is being processed - Media is processing. Try again in a few minutes.
  • Geo location unavailable - This content is unavailable in your region. 
  • Media unavailable  - This media has been restricted. Please obtain relevant permissions to access content. Check with your administrator if you think this is incorrect.
  • There’s a problem with your network - The player couldn't connect. Check your internet connection and try again.

Need help troubleshooting?

If you're not sure what’s causing the issue, you can copy technical details from the player and share them with Kaltura Support.

To copy debug info:

On desktop: Right-click the player and select Copy Debug Info.

On mobile: Long-press the player and select Copy Debug Info.

This will copy a set of technical details in JSON format, such as player version, media ID, browser, and embed code, to your clipboard. Paste this info into your support request to help speed up resolution.

Here's an example of the copied debug info:

The Copy Debug Info option is enabled by default.

Was this article helpful?
Thank you for your feedback!
User Icon

Thank you! Your comment has been submitted.

In this article
Related articles
Back to top

Never miss a thing!

Subscribe to our customer newsletter and our release notes updates, so you always get the best out of Kaltura.
Newsletter