Troubleshooting

IPTV not working? Work through this

Six specific failure modes, each with a distinct cause. Identify which one you have, then apply the fix that matches it.

Published 28 July 2026 · Updated 4 August 2026 · 4 min read

"IPTV isn't working" covers at least six different faults with six different fixes. Identify which one you have first — guessing wastes an evening.

Start here: which failure is it?

Symptom	Likely cause	Section
Nothing loads at all	Credentials, or provider down	1
App opens, channel list empty	Playlist URL or subscription	2
Some channels play, others don't	Individual dead streams	3
Guide/EPG blank	EPG source not configured	4
"Connection limit reached"	Sessions still open	5
Audio out of sync	Decoder or buffer	6

1. Nothing loads at all

First, confirm it's not your internet. Open a website on the same device. If nothing loads, fix the network first.

If the internet is fine:

Re-enter your credentials carefully. Xtream Codes fields are case-sensitive and the server address needs its port number (:8080 or similar). One wrong character fails silently.
Check whether your subscription expired. The most common cause, and the least suspected.
Test the M3U in a browser. Paste it into a URL bar — if you get text starting #EXTM3U, the line works and the problem is your app. If you get an error page, the line is dead.
Try a second app. If both fail, it's the account or the server.

2. App loads but the channel list is empty

The app is working; it received nothing to display.

Your provider's server is temporarily down — wait 10 minutes.
The playlist URL has a typo. Re-paste it rather than retyping.
The subscription lapsed — the account authenticates but returns no content.
The app cached an empty response. Clear the cache and reload.

3. Some channels work, others don't

This is normal and rarely a fault. Individual streams die constantly, particularly on free playlists.

Try another channel in the same group. If the whole group is dead, that source has gone.
Try a different feed of the same channel — our web player exposes a feed switcher in the control strip.
Check a whole playlist at once with the M3U playlist checker to see what proportion is still alive.

If more than about 30% of a paid playlist is dead, that's a provider quality problem, not bad luck.

4. The EPG (TV guide) is empty

The EPG is a separate data source from the streams. An empty guide almost never means the streams are broken.

On M3U: you must supply an XMLTV URL separately. Add it in your app's EPG settings.
On Xtream Codes: the EPG comes automatically — if it's blank, force a refresh in settings.
Wrong programmes shown: channel IDs aren't matching. The tvg-id in the playlist must match the ID in the XMLTV file. Most apps let you remap manually.
Guides can take several minutes to populate on first load. Wait before troubleshooting.

Our EPG viewer will tell you whether an XMLTV file is valid and what channel IDs it contains.

5. "Connection limit reached"

Your plan permits a set number of simultaneous streams, and they're all in use.

Devices left open. Closing an app without exiting cleanly can leave the session alive. Usually clears in 5–10 minutes.
Genuinely watching on too many devices. Close one.
Credentials leaked. If you've ever posted your M3U line anywhere public, assume it's in use by strangers. Ask your provider to reset it.
Restart the router — this forces a new IP and drops stale sessions.

6. Audio out of sync or missing

Change the decoder in your app's settings — hardware to software, or vice versa. This fixes it most of the time.
Increase the buffer size.
Check your TV's audio output format. Some streams carry AC3/EAC3 that certain devices won't decode; switching the TV to PCM/stereo often resolves it.
If it's one channel only, the source itself has a bad audio track.

The pattern that means "change provider"

Everything above assumes a fixable fault. This pattern isn't:

Your connection tests fine and other services play perfectly
Multiple apps and devices behave identically
It degrades predictably at peak time or during live sport
Support is slow, scripted, or unreachable

That's oversold server capacity. Nothing you do at home will fix it.

How to test a replacement properly

Don't judge a provider at 2pm on a Tuesday — anything works then. Test at peak time, during live sport, on the device you actually use.

The GuardianTV free 12-hour trial takes no card details, so there's nothing to cancel if it doesn't hold up. Twelve hours is deliberately enough to cover a full match plus an evening's viewing — the only test that tells you anything real.

Frequently asked questions

Why is my IPTV not working?

The six common causes are an expired or mistyped subscription, the provider's server being down, exceeding your connection limit, a network or DNS problem, an app cache issue, or a dead individual stream. Identify which by checking whether the failure affects everything or just one channel, and whether other internet services work normally.

What does 'connection limit reached' mean?

Your subscription allows a set number of simultaneous streams, and that number is already in use. It is often caused by devices that were closed improperly still holding a session open, which usually clears within 5–10 minutes. If it persists, your credentials may have been shared or leaked.