HLS master playlist has only one rendition
With a single variant there is nothing to adapt to, so viewers on poor connections rebuffer instead of dropping quality.
What it means
The master playlist declares one EXT-X-STREAM-INF, or none. Adaptive bitrate streaming needs several so a player can move between them as bandwidth changes.
Why it matters
A single rendition turns every bandwidth dip into a rebuffer. The player has nowhere to go: it cannot drop to a smaller rendition, so it stalls and waits. On mobile networks this is the difference between a brief softening of the picture and a stream that stops.
How to fix it
- Publish at least three renditions spanning the range of connections you expect.
- A common starting ladder is 360p at roughly 800 kbps, 540p at 1.6 Mbps, 720p at 3 Mbps and 1080p at 5 Mbps.
- If you deliberately serve one rendition — for an internal feed on a known network — this warning is safe to ignore.
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 master playlist has only one rendition" mean?
- The master playlist declares one EXT-X-STREAM-INF, or none. Adaptive bitrate streaming needs several so a player can move between them as bandwidth changes.
- Why does it matter?
- A single rendition turns every bandwidth dip into a rebuffer. The player has nowhere to go: it cannot drop to a smaller rendition, so it stalls and waits. On mobile networks this is the difference between a brief softening of the picture and a stream that stops.
- How do I fix it?
- 1. Publish at least three renditions spanning the range of connections you expect. 2. A common starting ladder is 360p at roughly 800 kbps, 540p at 1.6 Mbps, 720p at 3 Mbps and 1080p at 5 Mbps. 3. If you deliberately serve one rendition — for an internal feed on a known network — this warning is safe to ignore.
- 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.