How to Add EPG to IPTV

If your IPTV player shows No Information, No EPG, or an empty guide grid, you usually need to add a valid XMLTV EPG URL.

This guide explains how to add an EPG to IPTV apps, how XMLTV setup normally works, and what to check when the guide still does not load after you paste the URL.

Step-by-step setup • XMLTV guide • IPTV apps • Internal guide + troubleshooting

Before you add the guide

You need a working EPG URL first. If you do not already have one, create it here:

If your channels do not play at all, solve that separately using IPTV Playlist Not Working?. An EPG improves guide data only.

What “adding an EPG” means

Most IPTV players separate the playlist from the guide data. Your playlist provides channels and stream URLs. The EPG provides programme schedules.

Adding an EPG normally means going into your player settings, finding the EPG, TV Guide, or XMLTV section, and pasting in the guide URL.

Once refreshed, your app can show:

  • programme titles
  • now / next information
  • future guide rows
  • better browsing inside the player

General steps that work in many IPTV apps

  1. Open your IPTV player
  2. Open the playlist, source, or account settings
  3. Find the section called EPG, TV Guide, or XMLTV
  4. Paste your XMLTV EPG URL
  5. Save the settings
  6. Refresh or update the guide
  7. Wait for the guide import to finish

The wording varies between apps, but the setup logic is usually the same.


If the guide still does not appear

A blank guide after setup usually points to one of these issues:

  • the EPG URL was pasted incorrectly
  • the player has cached old guide data
  • channel names were not matched properly before the EPG was built
  • the guide has not finished refreshing yet
  • the player timezone or offset is wrong

Recommended route: create the guide first

If you do not already have a reliable guide source, start with our EPG Builder.

It is built for the common real-world workflow:

  • import your M3U, TXT, or Xtream Codes source
  • match the channels
  • build the guide
  • copy the generated XMLTV URL into your player

Common players and what to look for

Different IPTV apps label the EPG menu differently, but you are usually looking for one of these:

  • EPG
  • TV Guide
  • Guide Source
  • XMLTV URL
  • Playlist / Account settings

In many apps, the guide source is attached to the playlist or profile rather than the whole app.


Why correct matching matters

Adding an XMLTV URL is only half the job. The channel names in your playlist still need to line up with the guide data.

Problems often happen when playlists use names such as:

  • provider-specific naming
  • extra labels like HD / 4K / FHD
  • regional or language variants
  • +1 and timeshift channels

If matching is weak, some channels may show the wrong listings or no listings at all.


What an EPG will not fix

  • dead or removed stream links
  • 403 / 401 access problems
  • constant buffering caused by the stream source or network
  • unsupported codecs in the player

For those cases, use: M3U Checker, M3U Editor, or IPTV Buffering Test.


Step-by-step example setup

1) Get your EPG URL

Build or obtain a valid XMLTV EPG URL. If you do not have one yet, use the EPG Builder.

2) Open your IPTV player settings

Find the profile, playlist, or source you want to update. In many IPTV apps, the EPG source is configured per playlist.

3) Find the EPG / XMLTV field

Look for a label such as EPG URL, TV Guide, or XMLTV source.

4) Paste the URL and save

Paste the full guide URL carefully and save the change. Avoid extra spaces and check that the URL is complete.

5) Refresh the guide

Most apps need a manual guide refresh after setup. Give the app time to import the data.

6) Check channel alignment

If some channels still show blank or incorrect guide data, the issue is usually matching rather than the player setting itself.


Setup notes for popular app styles

App menus vary, but most follow one of these patterns:

Playlist-based apps

These apps attach an EPG source to a specific playlist, account, or profile. You add the XMLTV URL inside that source's settings.

Guide refresh apps

Some apps keep a separate guide refresh option. After adding the URL, you must trigger an update before programme rows appear.

Apps with cached EPG data

If the old guide remains visible, try clearing or refreshing the EPG cache, then reload the playlist.

Apps with timezone or offset settings

If the listings appear shifted by one or more hours, check the player timezone and any EPG time offset option.


Common EPG setup problems and fixes

The app still says “No Information”

Re-check the EPG URL, refresh the guide manually, and confirm the channels were matched correctly before the guide was built.

Only some channels show guide data

Partial coverage usually means some channels matched well and others did not. Improve the channel matches and rebuild the guide.

The guide is there but the programmes are wrong

This usually points to incorrect channel mapping rather than a player issue. Review the matched channels and generate a fresh guide.

The guide is offset by time

Check the player timezone, guide offset, and any local time settings before rebuilding the guide.

The playlist works in one app but not another

Different IPTV players handle XMLTV imports differently. One app may refresh immediately while another needs a manual guide update or stricter URL formatting.


Best route if you do not already have an XMLTV guide

If you are still at the starting point and simply need a guide that works with your playlist, go here first:

Related help: IPTV Playlist Not Working?M3U CheckerM3U URL → TXT file