M3U Tags Decoded
Understanding M3U directives helps you troubleshoot your playlists and organize streams like a professional.
The #EXTM3U Header
Every valid M3U file must start with #EXTM3U on the first line. Without it, many media players will refuse to load the playlist.
Common attributes at a glance
| Attribute | Typical purpose | Editing caution |
|---|---|---|
tvg-id | Identifier used to match an external programme guide. | Changing it can break an otherwise correct EPG match. |
tvg-name | Alternate guide-facing name used by some players. | It is not always the same as the display name after the comma. |
tvg-logo | URL of an image that the player may request. | M3U Studio does not currently provide bulk editing specifically for logo URLs. |
group-title | Category shown in the player's navigation. | An absent value is treated as Ungrouped by several M3U Studio views. |
tvg-country / tvg-language | Optional descriptive metadata. | Support varies by player. |
Parser edge cases
M3U Studio reads quoted attributes on #EXTINF lines with names made of letters, numbers, and hyphens. The display name is taken from the text after the last comma. That makes commas inside an unescaped display name significant. Comments and vendor directives outside the parsed channel pair are not guaranteed to survive an export.
For a complete explanation of duration, delimiters, and malformed entries, read #EXTINF explained. For the relationship between header, metadata, and URL lines, use the M3U structure guide.
The #EXTINF Directive
This directive holds channel details. The duration is set to -1 for live streams, followed by attributes like tvg-logo and group-title.
Organize your tags
Use M3U Studio to automatically parse and clean these tags in your files.
Launch Editor