HLS ladder has an oversized bitrate gap
Adjacent renditions are too far apart, so switching between them is a visible jump in quality.
What it means
Two neighbouring rungs differ by more than about two and a half times in bandwidth. A player forced to move between them changes quality dramatically in one step.
Why it matters
ABR works by making small corrections. With a large gap the player has only a bad choice and a worse one: stay too high and rebuffer, or drop far below what the connection could carry and waste it. Viewers see the picture lurch between sharp and soft.
How to fix it
- Add a rung in the middle of the gap.
- As a rule of thumb keep each step between 1.5x and 2x the one below it.
- Very large gaps at the top of the ladder matter less than gaps at the bottom, where connections are least stable.
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 ladder has an oversized bitrate gap" mean?
- Two neighbouring rungs differ by more than about two and a half times in bandwidth. A player forced to move between them changes quality dramatically in one step.
- Why does it matter?
- ABR works by making small corrections. With a large gap the player has only a bad choice and a worse one: stay too high and rebuffer, or drop far below what the connection could carry and waste it. Viewers see the picture lurch between sharp and soft.
- How do I fix it?
- 1. Add a rung in the middle of the gap. 2. As a rule of thumb keep each step between 1.5x and 2x the one below it. 3. Very large gaps at the top of the ladder matter less than gaps at the bottom, where connections are least stable.
- How can I detect this automatically?
- Paste your HLS streaming URL into StreamTest's free HLS analyzer. It runs this check on every analysis, flags the finding, and links straight back to this page — no sign-up required.
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.