If you have set up IPTV, you have probably seen the term M3U. It is a simple playlist format that almost every IPTV player understands. Knowing what is inside an M3U playlist helps you set up players, troubleshoot problems and understand why some features — such as the programme guide — work the way they do.
What an M3U playlist is
An M3U playlist is a plain text file that lists media sources, one after another. The format originated with desktop music players and is documented, along with its variants, in the M3U article on Wikipedia. IPTV services use it to list channels: each entry has a name, some optional details and the address of the stream.
You usually receive M3U access as a URL (a web link). Your player downloads the playlist from that URL and turns the entries into a channel list. Some players also accept an M3U file saved on your device.
What is inside an M3U file
A simple extended M3U playlist looks like this in structure:
- A header line:
#EXTM3U - For each channel, an information line beginning with
#EXTINF - Followed by the stream address on the next line
The #EXTINF line can carry extra attributes that IPTV players use:
| Attribute | What it does |
|---|---|
tvg-id | Links the channel to its entry in the programme guide (EPG) |
tvg-name | An alternative channel name used for guide matching |
tvg-logo | The address of a channel logo image |
group-title | The category the channel belongs to |
| Text after the comma | The channel name shown in the player |
These attributes are conventions used by IPTV players rather than part of a single formal standard, so support varies from player to player.
How players use the playlist
When you add an M3U URL, the player:
- Downloads the playlist.
- Reads each entry and groups channels using
group-title. - Shows logos from
tvg-logo, where available. - Matches channels to programme guide data using
tvg-id, if you have added an EPG source. See what is an EPG?. - Plays the stream address when you select a channel.
Because the whole list is downloaded at once, very large playlists can take a while to load, especially on low-powered devices.
M3U vs. other login types
Many services offer both an M3U URL and an Xtream Codes login (server URL, username and password). Both give access to the same subscription. Xtream Codes lets players load categories and guide data more efficiently; M3U is supported more widely, including by general media players such as VLC. Our comparison M3U vs. Xtream Codes explains when to choose which.
You may also see M3U8 — the same idea, encoded as UTF-8 and commonly used for HLS streaming. See M3U vs. M3U8.
Using M3U links safely
An M3U URL often contains your personal login details. Treat it like a password:
- Do not share it publicly or post it in screenshots.
- Store it in a password manager.
- Copy and paste it rather than retyping.
- If you think it has been exposed, contact your provider.
More advice is in how to keep your streaming account secure.
Editing an M3U file
Because it is plain text, you can open an M3U file in any text editor. Most people never need to, as players let you hide categories, reorder channels and create favourites without touching the file. See organising channels and favourites. If you do edit a file, save it as plain text with UTF-8 encoding to keep special characters intact.
Troubleshooting M3U playlists
If your playlist will not load or channels do not play, the cause is usually a mistyped URL, the wrong login type in the player, or a player that does not handle large lists well. Our step-by-step guide M3U playlist not working? covers each case.
Frequently asked questions
What does M3U stand for?
M3U is commonly described as short for "MP3 URL", reflecting its origins as a music playlist format. Today it is used for all kinds of media, including video streams.
Can I open an M3U file on my computer?
Yes. Media players such as VLC can play M3U links and files. A text editor shows the playlist's contents.
Why are some channels missing logos?
Logos depend on the tvg-logo attribute in the playlist and on the player supporting it. If the attribute is missing or the image cannot be reached, no logo appears.
Why does the programme guide not match my channels?
Guide matching relies on tvg-id values matching the channel IDs in the EPG data. If they do not match, the guide may be empty or wrong. See EPG not working?.
M3U in a nutshell
An M3U playlist is a plain text list of channels with names, optional attributes and stream addresses. Players read it to build your channel list, group categories, show logos and link the programme guide. Keep your M3U link private, and use the articles in this cluster when something needs fixing. Unfamiliar with a term? Check the streaming glossary.
More in this guide
- IPTV Favorites: How to Organise Channels in Your PlayerA long channel list is easier to live with once it is organised. These player features save time every day.
- M3U Playlist Not Working? How to Troubleshoot It Step by StepMost M3U problems come from the URL, the player's settings or the device. Work through these checks in order.
- M3U Playlist vs. Xtream Codes Login: What's the Difference?Your access details can come as an M3U link or as an Xtream Codes login. Here is what each one means and when to use it.
- M3U vs. M3U8: What's the Difference?The difference comes down to text encoding and how the files are used. Here is what M3U8 means and why it matters for streaming.