HLS playlist has many discontinuities
Frequent EXT-X-DISCONTINUITY tags mean the timeline resets constantly, which many players handle poorly.
What it means
A discontinuity tells the player that timestamps, and possibly encoding parameters, change at that point. A few are normal for ad insertion; here they make up a large share of the playlist.
Why it matters
Every discontinuity forces the player to reset its decoder and re-establish timing. Frequent resets produce audible gaps, visible stutters and drifting subtitles, and some devices leak memory across them badly enough to fail on a long session.
How to fix it
- If the discontinuities come from ad insertion, consider conditioning the ads to match the main content so no reset is needed.
- If they come from the encoder restarting, fix that — a healthy encoder should not restart every few segments.
- Confirm each one is genuinely needed: some packagers emit them defensively on every segment boundary.
Check your own stream
The free HLS analyzer runs this check on every analysis and links each finding straight back here.
Open the HLS analyzer →Frequently asked questions
- What does "HLS playlist has many discontinuities" mean?
- A discontinuity tells the player that timestamps, and possibly encoding parameters, change at that point. A few are normal for ad insertion; here they make up a large share of the playlist.
- Why does it matter?
- Every discontinuity forces the player to reset its decoder and re-establish timing. Frequent resets produce audible gaps, visible stutters and drifting subtitles, and some devices leak memory across them badly enough to fail on a long session.
- How do I fix it?
- 1. If the discontinuities come from ad insertion, consider conditioning the ads to match the main content so no reset is needed. 2. If they come from the encoder restarting, fix that — a healthy encoder should not restart every few segments. 3. Confirm each one is genuinely needed: some packagers emit them defensively on every segment boundary.
- How do I check an HLS playlist for this automatically?
- Paste the master or media playlist URL into the free HLS analyzer. It runs this check on every analysis alongside the ladder, timing and live-edge audits, and links each finding back to the page that explains it.
- What is the first thing to try?
- If the discontinuities come from ad insertion, consider conditioning the ads to match the main content so no reset is needed.
Related HLS checks
- HLS ladder has a bitrate inversionA lower-resolution variant is allocated more bandwidth than a higher-resolution one, so adaptive switching picks the wrong rendition.
- HLS variant is missing the CODECS attributeWithout CODECS, players must download a segment before they can tell whether they can play the rendition at all.
- HLS variant references an undeclared rendition groupA variant points at an AUDIO or SUBTITLES group that has no matching EXT-X-MEDIA entry, which breaks playback on strict players.
- HLS segment is longer than EXT-X-TARGETDURATIONA segment rounds to more than the declared target duration, which violates the HLS specification.
- HLS live window is shorter than three target durationsThe playlist holds too little content, so any player that falls slightly behind runs off the end of the window.
- HLS playlist has no EXT-X-PROGRAM-DATE-TIMEWithout program date-time the stream cannot be mapped to wall-clock time, which breaks DVR seeking and multi-stream alignment.