HLS variant references an undeclared rendition group
A variant points at an AUDIO or SUBTITLES group that has no matching EXT-X-MEDIA entry, which breaks playback on strict players.
What it means
An EXT-X-STREAM-INF tag names a rendition group in its AUDIO or SUBTITLES attribute, but no EXT-X-MEDIA tag declares that GROUP-ID.
Why it matters
The variant is unplayable as written: the player is told to pair the video with an audio group that does not exist. Lenient players may fall back to muxed audio if there is any; strict ones error out. It is a common result of hand-editing or of stitching two master playlists together.
How to fix it
- Add the missing EXT-X-MEDIA declaration, or correct the GROUP-ID on the variant to match an existing group.
- Check for case mismatches — group ids are compared exactly.
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 variant references an undeclared rendition group" mean?
- An EXT-X-STREAM-INF tag names a rendition group in its AUDIO or SUBTITLES attribute, but no EXT-X-MEDIA tag declares that GROUP-ID.
- Why does it matter?
- The variant is unplayable as written: the player is told to pair the video with an audio group that does not exist. Lenient players may fall back to muxed audio if there is any; strict ones error out. It is a common result of hand-editing or of stitching two master playlists together.
- How do I fix it?
- 1. Add the missing EXT-X-MEDIA declaration, or correct the GROUP-ID on the variant to match an existing group. 2. Check for case mismatches — group ids are compared exactly.
- 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 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.
- HLS live edge has drifted from wall-clock timeThe newest segment’s program date-time is far from the current time, meaning the playlist is stale or the clocks disagree.