Start with quick checks
- Test several channels. If only one channel fails, the problem is likely that channel, not your setup.
- Restart everything. Turn off the TV or device and the router, wait 30 seconds, and turn them back on.
- Check other devices. Make sure no other device is streaming with the same login.
- Update. Install updates for the device software and the player app.
- Check your subscription dates. Plans don't renew automatically, so an expired plan stops working.
Find where the problem is
Work through these questions in order. The first “yes” usually points to the cause.
| Step | Check | If yes, the problem is likely… | Go to |
|---|---|---|---|
| 1 | Do other apps or websites fail on this device too? | The internet connection or Wi-Fi | Network and Wi-Fi |
| 2 | Does only one channel or title fail? | That stream | Tell WhatsApp Support which one |
| 3 | Is another device streaming with the same login? | The connection limit | Stop the other stream |
| 4 | Does the player show a login or authorization error? | Login details or plan dates | Login and authentication errors |
| 5 | Does it work on another device with the same login? | This device or player | App cache and player settings |
| 6 | Does it only buffer at busy times or on Wi-Fi? | Network congestion or signal | IPTV internet speed guide |
Common error messages
Every player words its errors differently, so look for the closest match below. These are typical meanings, not guaranteed diagnoses; if the suggested fix doesn't help, move on to the detailed section.
| Message (wording varies) | What it usually means | What to try |
|---|---|---|
| “Invalid username or password”, “Authorization failed” | The login details don’t match, or the account isn’t active | Re-type the details by hand; confirm your trial or plan is active |
| “Account expired” | The trial or plan has ended (plans don’t renew automatically) | Check your plan dates; renew through WhatsApp Support |
| “Too many connections”, “Max connections reached” | Another device is streaming with the same login | Stop the other stream; one subscription streams on one device at a time |
| “Can’t connect to server”, “Server not responding” | The server address is wrong or unreachable from your network | Check the full address and port; restart the router; try another network |
| “Invalid playlist”, “Playlist could not be loaded” | The M3U link is incomplete, mistyped or the wrong login type was chosen | Re-enter the full link; check you chose M3U, not Xtream Codes |
| “No EPG data”, “No program information” | Guide data hasn’t loaded, or the channel has none | Update the EPG in settings; see EPG not loading below |
| “Playback error”, “Stream error”, “Source not available” | This stream can’t play right now, or the device can’t decode it | Try other channels, switch the decoder, update the player |
| “Device not activated”, “Please activate” | A device-key player needs activation on the developer’s website | Follow the activation steps the app shows |
Some players also show standard web status codes. In general, 401 or 403 means access was refused (often login or account status), 404 means the link wasn’t found (often a mistyped playlist link), and codes starting with 5 point to a server-side problem. If a code persists, send a photo of it to WhatsApp Support. Device-key activation is explained in MAC address and device-key activation.
Buffering and freezing
Simple fixes
- Pause the stream for a few seconds to let the buffer fill.
- Close other apps and stop large downloads or other streams on your network.
- Move the router closer to the TV, or use the 5 GHz Wi-Fi band.
Stronger fixes
- Use Ethernet. A wired connection is the most reliable fix for TVs and streaming sticks.
- Clear the player's cache and free up device storage.
- Change the player's buffer or decoder setting if your player offers one; try the alternatives one at a time.
- Test your speed on the device itself at the time buffering happens.
If buffering happens on every channel at every time of day, even on a good wired connection, contact WhatsApp Support with your device, player and connection type.
Login and authentication errors
- Re-type your username and password by hand instead of pasting them; check capital letters and remove extra spaces.
- Check the server address is complete, including
http://orhttps://and any port number, if your details include them. - Make sure you selected the right login type in the player (Xtream Codes vs M3U playlist) — see M3U vs Xtream Codes.
- Confirm your trial or subscription is active.
- Sign out on other devices if the error mentions too many connections.
Playlist won't load
- Give large playlists a few minutes on first load; don't close the app midway.
- For M3U links, check the full link was entered, with nothing cut off at the end.
- Delete the playlist from the player and add it again.
- If your player uses a device ID or MAC activation, confirm the playlist was added to the correct device on the developer's page.
EPG not loading
A missing or wrong program guide usually has one of these causes. For a full explanation of guide links, channel matching and catch-up, see the IPTV EPG and catch-up guide. Guide times follow your device's time zone — see the program guide and time zones.
| What you see | Likely cause | Fix |
|---|---|---|
| Guide is empty | Guide data has not downloaded yet | Use "Update EPG" in the player settings and wait a few minutes |
| Times are hours off | Time zone mismatch | Check the device time zone and the player’s EPG time shift |
| Guide on some channels only | Some channels have no guide data | Normal for some channels; check others |
| No guide with an M3U playlist | EPG link not added | Add the EPG (XMLTV) link from your login details |
| Guide stopped updating | Cached data is stale | Clear the player cache, then update the EPG |
Black screen
- Try another channel. If others play, the channel may be temporarily unavailable.
- Switch the player's video decoder (hardware/software) if it has the option.
- Check the TV's input and HDMI cable, and try another HDMI port for streaming sticks.
- Restart the player app, then the device.
Sound but no picture
This usually means the device can't decode that stream's video format. Change the decoder setting in the player, update the player, or try a different player app. If it happens only on 4K channels, your device may not support that format; try the HD version of the channel.
App crashes
- Force-close and reopen the app.
- Clear the app's cache (not its data) and free up storage.
- Update the app and the device software.
- Uninstall and reinstall from the official app store. Re-enter your login afterwards.
- If crashes continue on an older device, try another player — some are lighter on memory.
Movies and series won't play
- Make sure you signed in with a login type that loads VOD in your player (Xtream Codes logins usually do).
- Refresh the movies or series list in the player.
- Try another title to see whether the problem is one title or all of them.
- Switch the decoder setting if titles start but show no picture.
Catch-up not available
Catch-up works only on channels that offer it and only in players that support it. Look for the catch-up or archive icon next to a channel in the guide. If a channel has no icon, catch-up isn't available for it. If no channel shows catch-up at all, check your player supports the feature — see player features.
Device-specific errors
- Fire TV: player missing from the Appstore, "app not installed" and Vega OS limits are covered in Firestick fixes.
- Samsung and LG TVs: missing apps, activation and frozen apps are covered in Smart TV troubleshooting.
- Android TV and Google TV: see Android TV troubleshooting.
- Apple TV: see Apple TV troubleshooting.
- Phones, tablets and computers: see phones and tablets and Windows and Mac.
- MAG boxes: portal errors are covered in MAG troubleshooting.
- Other devices: check the install route and limits on compatible devices.
Network and Wi-Fi
- Wired beats wireless: use an Ethernet cable or a streaming-stick Ethernet adapter where possible.
- Router placement: keep the router central and away from thick walls and other electronics.
- 5 GHz Wi-Fi is faster at short range; 2.4 GHz reaches further but is slower.
- Router restart: restart it regularly, and update its firmware.
- Busy networks: large downloads, cloud backups and game updates compete with your stream.
- Mesh or extenders: a mesh system can help in large homes where the TV is far from the router.
How much speed you need, and how to test it properly, is explained in the IPTV internet speed guide.
Ethernet problems
- Check the cable clicks in at both ends and try a different cable and router port.
- Look for link lights on the router port; no light usually means a cable or port problem.
- On streaming sticks, use an Ethernet adapter made for that device, and power it as the maker recommends.
- Turn Wi-Fi off on the device while testing, so you know it is really using the cable.
- If the wired connection is slower than Wi-Fi, the cable, adapter or port may be limited — try another.
DNS and router settings
DNS turns web addresses into the numbers devices use to connect. If streams fail to start but some apps or websites also fail to open, the problem may be DNS or the router rather than the stream.
- Restart the router; this renews its connection and DNS settings from your internet provider.
- Set the device’s network settings back to automatic (DHCP) if they were changed by hand.
- Check for router firmware updates.
- Turn off router features that filter or block traffic one at a time to see whether one of them is the cause.
- If websites are slow everywhere in the home, contact your internet provider.
VPNs and streaming performance
A VPN sends your traffic through another server first. That extra step often adds delay and can reduce speed, which may cause buffering. If you use a VPN and streams buffer or fail to start, turn it off and test again. A VPN is not a fix for IPTV problems, and we don’t recommend one to improve streaming.
App cache and player settings
- Clear the cache (not the data) in the device’s app settings to fix slow menus and stale lists.
- Refresh the playlist and guide in the player after changes to your login.
- Change the video decoder (hardware or software) if channels freeze or show no picture.
- Buffer size: some players let you increase it; a larger buffer can smooth short drops at the cost of a slower start.
- Reset the player to default settings if you changed many options and can’t find which one broke playback.
Player-specific settings are in each IPTV player app guide.
When to contact WhatsApp Support
Contact us if a problem continues after the quick checks, or straight away if:
- Your login is rejected even when typed correctly.
- No channels load at all on a working internet connection.
- Every channel buffers, even on a wired connection.
- You need the right login details or EPG link for a new player.
