Failover
Automatic Failover ensures your outgoing stream stays live, even if your primary video source encounters issues. It automatically switches to a backup stream or fallback image when the primary input disconnects.
You can also inform viewers about low bitrate conditions using an overlay image or text.
The failover element supports webhooks that are triggered when the input stream fails, the bitrate drops below a set threshold, or stream health recovers.
Each failover feature (switching to a backup stream, overlay on low bitrate, and webhooks) can be used independently. You don't need to enable all of them to use this element.
Settings
- Failover type. Select what should happen if the input goes offline:
- None: No failover action. Useful for triggering bitrate alerts or webhooks only
- Show PNG image: Display a static image when the input disconnects. Use a 1920×1080 PNG for horizontal streams or a 1080×1920 PNG for vertical streams
- Switch to another input: Connect a backup input to the Failover element. You can define how to handle recovery when the primary input becomes available again by selecting an appropriate Recovery type
- Low bitrate: Keep your viewers informed if you experience connection issues and your bitrate drops below a certain threshold.
- Don't inform viewers
- Show overlay text
- Show PNG overlay
- Webhooks
- Webhooks can be configured to notify external systems when interruptions occur. For example, they can be used to keep your chat informed by calling a webhook URL created with a chatbot. Each webhook is triggered at most once every 5 minutes.
It's recommended to use Failover element right after Input stream. If the Failover is behind a multi-input element like Switch, low-bitrate signal from any of the Switch's inputs trigger a failover.