What tvg-id, group-title, and tvg-logo Mean in M3U

The M3U fields tvg-id, group-title, and tvg-logo describe a channel, but they do different jobs. tvg-id can help match a playlist item with programme data, group-title names a category, and tvg-logo points to an image URL. These are metadata beside the stream address; they do not create a channel or guarantee that every IPTV player will show a guide or logo.

A typical M3U entry has an #EXTINF line followed by the stream address. Attribute order can vary. This fictional example shows the structure only:

#EXTINF:-1 tvg-id="example-news" group-title="News" tvg-logo="https://example.invalid/logo.png",Example News
https://example.invalid/stream

Where these fields appear

In a common M3U playlist, each item has an #EXTINF line with information about the entry and a following line containing the source address. The part before the comma may include attributes; the text after the comma is the item name shown in the playlist. The exact formatting depends on how the provider generated the file.

Keep three things separate: the channel name, its metadata, and the stream address. The name helps identify the item. Attributes add labels about it. The URL points to playback. Changing one does not necessarily fix the others.

tvg-id: an identifier used with programme data

tvg-id is a text identifier assigned to a playlist item. It is often used to associate a channel with an entry in an XMLTV guide. An XMLTV feed can identify channels with its own IDs; the closer the playlist ID is to the corresponding guide ID, the easier it is for a system to associate the programme with the right item.

It is not enough for the two identifiers to look similar. The data supplied by the source needs to match. Regional variants, different channel versions, or a provider-side change can break the match even when playback works. On the other hand, missing tvg-id does not automatically mean a channel cannot play. It depends on the player and whether another matching method is available.

If a channel plays but its guide is empty or shows another station’s schedule, diagnose playback separately from EPG matching. The exact behavior depends on the playlist, guide feed, and player.

group-title: the channel category

group-title names the group a provider assigns to a playlist item, for example “Sports,” “News,” or “Documentaries.” It is a category within the playlist, not a separate source and not part of the channel’s stream URL. Groups can make a long list easier to browse.

The provider chooses the group labels. They may be abbreviated, written in another language, or formatted differently across similar categories. An empty or unexpected group can therefore come from the playlist metadata rather than a playback error. Do not change the stream URL just because the category label looks unusual.

tvg-logo: the channel image address

tvg-logo points to a URL for an image associated with the item. It is a reference to a graphic, not the image itself. If the address is outdated, unavailable, or malformed, the logo may not appear even while the channel plays. Players can also handle missing or invalid images differently.

A logo does not control stream availability or supply programme data. If the image is missing but playback works, first check whether the provider still supplies a current image URL. Do not confuse a missing logo with a broken channel.

A quick reference

Field

What it is for

What it does not guarantee

tvg-id

Identifies a channel for matching programme data

That every XMLTV feed will match

group-title

Labels a playlist category

That the channel will play

tvg-logo

Gives the address of a channel image

That the image is available or valid

This distinction helps narrow down a problem. If the channel works but the guide does not, check the source and matching data rather than changing the stream. DaddyTV supports M3U sources and an optional XMLTV guide; the exact handling of metadata still depends on the playlist, the EPG feed, and the player.

How to inspect an M3U entry safely

If your provider gives you a file, open it locally in a text editor you trust. Do not paste a complete playlist into a public online analyser: its URLs may contain access details. You can compare the attributes in a few #EXTINF lines without exposing the real stream URL to anyone else.

Check whether tvg-id is present, whether group-title has a sensible value, and whether the tvg-logo URL appears complete. Then compare the identifier with the provider’s documentation or XMLTV example. Do not edit values across the whole playlist unless you know how the player uses them. Keep an original copy and ask the provider for correct metadata if something is missing.

Three common misunderstandings

First, tvg-id is not a channel address; it is a label. Second, group-title does not create a TV schedule; it names a category but contains no programme listings. Third, tvg-logo is not a required image file. It can point to a stale or unavailable URL. In all three cases, the stream may play normally even when metadata is incomplete.

Check each layer separately: first the channel, then its group, image, and guide. tvg-id describes an identifier, group-title a category, and tvg-logo an image address. None replaces the stream URL or a complete XMLTV feed. If the picture plays but the guide is missing, focus on the guide match; if the channel itself will not play, investigate its source separately.

For setup, start with the M3U player page; if you need separate guide data, see the XMLTV EPG player page.

For an overview of supported app platforms, see DaddyTV platforms.