M3U Technical Reference

tvg-name

tvg-name is an optional Extended M3U attribute used by some IPTV applications as an alternate channel name for display or guide matching.

tvg-name="Example News"

Definition

tvg-name is an optional Extended M3U attribute used by some IPTV applications as an alternate channel name for display or guide matching.

Syntax and example

tvg-name="Example News"

Practical notes

Treat tvg-name as descriptive metadata rather than the primary EPG key. Exact player behaviour varies, and name-based matching is less reliable than tvg-id.

Common mistakes

  • Using typographic quotation marks instead of straight quote characters.
  • Changing identifiers during bulk edits without updating related EPG data.
  • Assuming every IPTV player implements optional metadata in exactly the same way.

Related tools

M3U.co.uk toolkit

Learn the format. Inspect the playlist. Fix the problem.

Explore free tools