Troubleshooting7 min read• Published: October 26, 2026

IPTV EPG Not Working? How the Guide Works and How to Fix It

The channels play, but the guide is blank, late or wrong. That is an EPG problem, and it is separate from stream quality. This guide explains where IPTV guide data comes from and how to work through each common fault.

Key idea

The guide is not part of the video stream. It is a separate data source that your player matches to channels, so most guide faults come down to matching, timing or refresh problems.

Xtream vs M3U

What Is an EPG?

An electronic program guide is a menu that shows schedule information for current and upcoming programmes. Wikipedia notes that modern guides usually cover about seven to 14 days, and that listings can be delivered over the internet. In IPTV, that internet route is how guide data normally reaches your player.

Where IPTV Guide Data Comes From

  • Your provider's login. With an Xtream-style login, guide data is often delivered through the same connection, though this depends on the provider and app. See Xtream Codes vs M3U.
  • An XMLTV file. XMLTV is an XML-based TV listings format introduced in 2002. Providers often give you a guide URL to paste into the player.
  • Channel IDs in a playlist. IPTV playlists commonly carry a tvg-id attribute on each channel, which players typically use to find the matching guide entry.

That last link explains most mismatches. In the XMLTV format description (its DTD file), each programme names its channel with a channel attribute, and a matching channel entry, where present, should carry the same ID. If a playlist channel's ID does not exist in the guide data, the player has nothing to show for it. Exactly how a given app does this matching is not standardised, so check your player's documentation.

Symptoms, Likely Causes and What to Try

These are likely causes, not diagnoses. Your player and provider decide which apply.

SymptomPossible causeWhat to try
Guide completely emptyNo guide source set, source unreachable or expired, or the refresh failedConfirm the guide URL or Xtream-style login, then force a refresh
Times off by whole hoursTime zone mismatch between guide data and playerCheck the time zone; use a guide time-shift option if your player has one
Wrong shows on one channelChannel matched to the wrong guide entryRe-map the channel if possible, or report it to the provider
Some channels have no dataThe guide source may not include themAsk the provider whether guide data exists for those channels
Guide loads very slowlyA large guide on a slow device is one possibilityWait for the refresh to finish; update the app; try fewer days or channels if your player allows
Old programmes shownStale stored dataClear the guide data or app cache and reload

Why Times Can Be Off

According to the XMLTV format description (its DTD file), times are written as YYYYMMDDhhmmss or a shorter prefix of that, and a time zone can be appended. If no explicit time zone is given, UTC is assumed. Its examples include 19880523083000 +0300. A guide that omits or mislabels its offset can therefore look shifted by whole hours until the player or a setting corrects it. That is why a consistent offset is a time zone clue, while random wrong shows on a single channel is a matching clue.

A Fix Order That Saves Time

  1. Refresh the guide inside the player and wait for it to finish; large guides can take a while on small devices.
  2. Confirm the source. If you use a separate guide URL, check it with your provider; if you use a login, re-enter it exactly.
  3. Check the time zone on the device and in the player.
  4. Clear the app cache or stored guide data, then reload.
  5. Re-map individual channels if the player supports manual guide matching.
  6. Contact the provider with the channel names that fail and the times you see. Our review checklist includes guide accuracy as a scoring item.

If streams also stall, treat that separately with the buffering checklist. App-specific steps are in the player app guide and the Smarters Pro guide.

Test the Guide Before You Pay

Guide quality varies between services, so check it during a trial: scan several channels across different days, compare a few programme times with an official source, and note any channel with no data. The free trial guide explains how, and you can see our plans when you are ready. Device steps are in the setup guides.

Frequently Asked Questions About IPTV EPG

What is an EPG in IPTV?

EPG stands for electronic program guide: the menu of current and upcoming programmes. In IPTV the guide data is usually supplied separately from the video streams and your player matches it to your channel list.

What is XMLTV?

XMLTV is an XML-based file format for TV listings, introduced in 2002 according to Wikipedia. Its published format description gives each programme a start time and a channel reference, and many IPTV setups use an XMLTV file, or something close to it, as their guide source.

Why is my IPTV guide empty?

Common causes are no guide source set, an expired or unreachable guide source, a refresh that never finished, a playlist-only setup with no guide URL, or channel IDs that do not match the guide data. Work through the fix order below.

Why are the programme times wrong?

A consistent offset of whole hours usually means a time zone mismatch. In the XMLTV format description, a time with no time zone is treated as UTC, so a guide file that omits its offset can appear shifted unless your player or settings correct it. Check your time zone setting and any guide time-shift option your player offers.

Why does one channel show the wrong programmes?

It is probably matched to the wrong guide entry. If your player lets you change a channel’s guide mapping, do that; otherwise report the channel name to your provider.

Check the Guide First

Test a Service on Your Own Devices

Review our plans, check the terms, and follow our setup tutorials to see the guide working in your player.