Table of Contents
Overview
If something isn’t quite right with your LG webOS player, you’re in the right place. This guide walks through the most common issues in plain language. Let’s get your screens back up and running.
1. What is the LG webOS Player?
With a compatible LG commercial display, you don’t need extra hardware to run Yodeck. The Yodeck app installs directly onto your display, turning it into a digital signage player.
- The app installs once and updates itself automatically as long as the display stays online
- You manage everything remotely from the Yodeck Portal
Supported webOS versions: 4.0, 4.1, 6.x, and 8.x (webOS 8 support was added in April 2026). Not supported: webOS 3.x, 5.x, and 7.x.
⚠️ Heads up: Only LG commercial displays (not home TVs) running a supported version of webOS are compatible. Check Section 14 before getting started.
ℹ️ Some webOS 8 displays report their OS version as “9”. That’s an LG quirk. You’re still on webOS 8 and supported.
2. Things the LG webOS Player Cannot Do
Before troubleshooting, here’s what the LG webOS player doesn’t support. These aren’t bugs. They’re platform limitations.
| Feature | Supported? | What Happens Instead |
|---|---|---|
| Turn the screen on/off remotely | ⚠️ Partial | “Turn Screen Off” shows a black screen with no backlight. It doesn’t fully power down the display |
| 4K resolution | ❌ No | Content plays at 1080p max |
| Screen rotation | ⚠️ Partial | 90° and 270° (portrait) work. 180° is not supported. |
| YouTube Live Streams | ❌ No | Pre-recorded YouTube videos work fine |
| Interactive apps (Interactive Library, Playlist, Kiosk) | ❌ No | Not available on webOS |
| Apps that use custom script code | ❌ No | See the App Compatibility Table |
| Custom scripts on web pages | ❌ No | Standard web pages display normally |
| Web page zoom (Zoom Factor / Auto-Adjust Zoom) | ⚠️ Limited | Zoom may not behave as expected. See Section 11. |
| Sound output selection (HDMI / Analog / Muted) | ❌ No | Audio plays through the display’s default output |
| Network configuration from the Portal | ❌ No | Configure network settings on the display |
| Security configurations | ❌ No | Not available on this platform |
| USB to HDMI Video Capture | ❌ No | Not available on this platform |
| Images higher than the display’s native resolution | ⚠️ Caution | Images aren’t resized. Anything above native resolution gets cropped. You can check the resolution in the Portal’s Status tab. |
3. What Do the On-Screen Messages Mean?
| Message | What It Means | What To Do |
|---|---|---|
| Loading | The player is starting up | Wait a minute. This is normal on boot |
| Registering Screen… | A pre-provisioned player is registering automatically | Wait for it to finish |
| Registration Code | The player needs to be linked to your account | Enter the 9-digit code in the Portal under Screens > +Add Screen > webOS Player |
| Downloading | The player is receiving new content | Wait for it to finish. If it takes more than 5 minutes, check your internet |
| Configuring / Loading | New configuration is being applied | Wait briefly |
| Internet Access Required | The player can’t reach Yodeck servers. Usually one of three things: (a) offline more than 30 days, (b) the screen was deleted and re-registered elsewhere, or (c) the schedule file expired and couldn’t refresh | Reconnect to the internet, check the “Last Online” date in the Portal, and click Push to Players |
| Apply Needed | Your schedule file is about to expire (within 3 days). Shown in the bottom-right | Click Push to Players in the Portal right away |
| Player Already Registered | The display is linked to another Yodeck account | Deregister from the other account, then re-register here |
| Device Deactivated | Your account’s screen limit was reduced, and this screen was disabled | Upgrade your plan or delete unused screens to free up a slot |
| No Content Assigned to Player | Nothing is assigned to this screen yet | In the Portal, select the screen, assign content, and Save + Push |
| No Space Left | Storage is full | Reduce the number or size of media files assigned, then push again |
| Turning Off | The screen is shutting down | Expected. You can hide this message in the Portal settings |
4. Registration Code Not Appearing?
Work through these in order, from lightest to heaviest:
- Check your internet. The code needs internet access to appear. Try Ethernet if possible. Wait 30–60 seconds after connecting.
- Reboot the display. On webOS, the Yodeck app launches automatically on boot, so a reboot is the relaunch.
- Check that the LG tutorial wasn’t skipped. If it was, the display may lack valid time, date, or network settings. Factory-reset the display via Settings > General > Reset to Initial Settings (this is an LG operation, not Yodeck), re-run the tutorial, then reinstall the Yodeck app.
- Repeat the app installation steps above only if nothing else works.
5. Blank or Black Screen Issues
A black screen is usually something simple. Work through these:
- Check the display input. The remote may have switched to another HDMI input or a TV channel. Switch back.
- Is “Turn Screen Off” active? If so, the display shows a black screen with no backlight (Section 2). Use Turn Screen On in the Portal or reboot to restore the image.
- Check the player status in the Portal. Go to Screens:
- Online: Wait up to 3 minutes for a screenshot. If it looks outdated, click Push Again to this Screen.
- Offline: See Section 6.
- Check the “Last Seen Online” date. After over 30 days, the player may have been disabled. You need to reconnect it to the internet.
- Make sure content is assigned. A player with no content shows a black screen.
- Force a push. Click Push to Players in the Portal, even if the button isn’t orange.
- Reboot the display. Wait 2 minutes for the content to reload.
6. Player Shows as “Offline” in the Portal
Your player needs an internet connection to stay in sync. If it’s Offline:
| Step | What To Do |
|---|---|
| 1. Test your internet | Check whether another device on the same network can browse normally |
| 2. Reboot the display | Power off and back on. Wait 2 minutes |
| 3. Check your network | Move closer to the router on Wi-Fi, or switch to a wired (Ethernet) connection |
| 4. Check for a login page | On a hotel, airport, or public Wi-Fi, a login page may block the display. Ask the network admin to place the display’s MAC address into the allow list. |
| 5. Check your firewall | See the address list below |
Finding Your Display’s IP and MAC Addresses
- From the Portal: Go to Screens, select the screen, and check the Status tab.
- From the display: Boot it without a network connection. A “Portal Connection” error appears on screen, showing both addresses.
Required Firewall Exceptions (all outbound)
| Address | Port | What It’s For |
|---|---|---|
hub.dsbackend.com | 443/TCP | Player communication with Yodeck |
repo.dsbackend.com | 80/TCP | Software updates |
dsbackend.s3.amazonaws.com | 443/TCP | Scheduling info and media downloads |
assets.dsbackend.com | 443/TCP | Media downloads |
platform.signageos.io | 443/TCP | webOS platform services |
upload.signageos.io | 443/TCP | webOS uploads |
signageos-device-monitoring.s3.eu-central-1.amazonaws.com | 443/TCP | webOS device monitoring |
For the most current webOS-specific list, see the signageOS Network Requirements.
Temporarily Offline?
No need to panic. Your player handles at least 30 days without internet. The content keeps playing, though time-based scheduling may drift slightly. After 30 days, playback stops, and an “Internet Access Required” message appears. Just reconnect to resume.
7. Content Not Updating on Screen
Did you click “Push to Players”?
This is the most common reason content doesn’t update. After making changes in Yodeck, the button in the top-right of the Portal turns orange and flashes “Push to Players?”. You can click it to send your changes. If the button is already black (“Changes pushed!”), clicking it again forces all players to re-check and restart playback.
Three Ways to Push Content
- Push to Players (orange, top-right): Pushes pending changes to all screens with updates waiting.
- Save & Push to this Screen: Saves and pushes changes to the screen you’re editing.
- Push Again to this Screen: Re-pushes to a single screen even when there are no pending changes. This is the troubleshooting tool for verifying Portal-to-player communication.
Other Common Issues
| Symptom | Likely Cause | Fix |
|---|---|---|
| “No Content Assigned” | No content is assigned | Select the screen, assign content, Save + Push |
| Old content still showing | Old content is still showing | Click the orange “Push to Players?” button |
| Downloading takes more than 5 minutes | Network issue or web filtering | Check your internet (Section 6) |
| Wrong content playing | A Schedule is overriding the Default Content | Review the Schedule and check which rule is active |
| Content plays at the wrong time | Timezone mismatch | Section 12 |
💡 See Section 12 for how Schedules and Default Content interact.
8. Video Playback Issues
| Symptom | Likely Cause | Fix |
|---|---|---|
| The layout may be too complex | “No supported source was found.” | Reduce zones or widgets |
| Video stutters or lags in a complex layout | Heavy layouts affect webOS playback | Simplify the layout |
| “No supported source was found” | Format isn’t compatible | Re-upload as MP4 (H.264) |
| 4K video isn’t playing in 4K | 4K not supported | Plays at lower resolution |
Recommended Video Specs for webOS
| Setting | Recommended Value |
|---|---|
| Container | MP4 |
| Video codec | H.264 |
| Profile / Level | High Profile, Level 4.1 |
| Resolution | 1920×1080 (1080p max) |
| Frame rate | 25 fps (anything above 60 fps is automatically reduced) |
| Bitrate | 10–15 Mbps (max 20 Mbps) |
| Pixel format | yuv420p |
| Audio codec | AAC, 128–256 kbps |
Heavy Layout Guidance
Keep layouts simple. Limit the number of simultaneously active dynamic zones (apps, live web content, videos) to 2–3 per layout. More than that can cause gapless playback issues or slowdowns.
💡 If a video plays fine on your computer but not on the display, the codec is usually the issue. Re-encode to MP4 (H.264).
9. No Sound / Audio Issues
| Symptom | Likely Cause | Fix |
|---|---|---|
| No sound at all | Display volume is muted or zero | Check the volume with the remote |
| Sound works on some content but not others | The file itself has no audio track | Confirm the file has audio on your computer |
| Can’t change audio output | Output selection not supported on webOS | Audio plays through the default output |
| Audio and video out of sync | Encoding issue | Re-encode using Section 8 specs and re-upload |
10. YouTube and Streaming Issues
| Symptom | Likely Cause | Fix |
|---|---|---|
| YouTube Live Stream won’t play | Live streams not supported | Use a pre-recorded video |
| The YouTube video shows an error | Age-restricted or region-locked | Try a different video, or host the file in Yodeck |
| Streaming buffers constantly | Slow or unstable internet | Check connection speed, or switch to Ethernet |
| Plays on your computer but not the display | Format or codec | Re-encode to MP4 (H.264). Check Section 8 of this article. |
💡 If you rely on YouTube content, download the videos and upload them to Yodeck directly. More control, fewer surprises.
11. Webpage Display Issues
| Symptom | Likely Cause | Fix |
|---|---|---|
| Webpage looks broken or doesn’t load | Site blocks non-browser access, requires authentication, or uses unsupported features | Try a different URL, or screenshot the page and use it as an image |
| Custom scripts don’t run | Custom scripts not supported on webOS | Use a static version of the page |
| Webpage shows a login screen | The site requires authentication | Use a publicly accessible URL |
| Content cut off, zoomed in, or doesn’t fit | Page isn’t sized for display screens (and webOS has limited zoom support. See below⬇️) | Use a page already sized for your display resolution, or screenshot it |
ℹ️ About web page zoom on webOS: Because of how webOS renders web pages internally, the Zoom Factor and Auto-Adjust Zoom settings may not behave consistently. This is a known platform limitation. For reliable results, use pages already sized for your display.
💡 For the most reliable results, use Yodeck’s built-in apps (like Notice Board or Social Wall) instead of embedding external sites.
12. Scheduling and Timezone Issues
In general, these devices provide a timezone selection in their device settings.
| Symptom | Likely Cause | Fix |
|---|---|---|
| Content plays at the wrong time | Timezone mismatch | Match the display’s timezone to your Yodeck account |
| The schedule may not be assigned to this screen | Default content plays instead of scheduled content | Confirm assignment in the Portal |
| Screen blank during the scheduled time | Schedule time slots don’t cover the current time | Review the schedule rules |
| The schedule worked before, but stopped | Schedule file expired (common when the player was offline and missed updates) | Bring the player online, then click Push to Players |
| Screen blank during scheduled time | A layout or media item with an availability end date has expired | Replace it or update its availability dates |
How Schedules Work
A Schedule takes priority over Default Content during its active time slots. Default Content is your “fallback”: it plays whenever no Schedule rule is active.
What Wins When Things Overlap
When more than one schedule or content type wants to play at the same time, Yodeck follows a strict priority order. The logic is that higher (1) beats lower (6):
- Emergency Alerts
- Takeover Content
- Working Hours
- Scheduled Content
- Default (Filler) Content
- Content Availability
Within a single schedule, the event listed higher in the Events List wins. Drag events up or down to change priority. For more, see our Prioritization of Content Types article.
13. Registration and Account Issues
| Symptom | Likely Cause | Fix |
|---|---|---|
| Registration code keeps appearing after setup | Code wasn’t entered correctly, or the player lost its registration | In the Portal, go to Screens > +Add Screen > webOS Player and enter the 9-digit code again |
| No content displayed on the screen | No content assigned | Assign a playlist or layout, then Save + Push |
| “Device Deactivated” | The account screen limit was reduced | Upgrade your plan or delete unused screens |
| No registration code on screen | App is still loading, or not installed correctly | Wait 2 minutes after booting. If no code appears, see Section 4 |
| Player deleted by mistake | Deleting removes it from your account; the player detects this automatically | Wait a minute, then add the screen again with the new code that appears on the screen |
Deregistering a Player
To deregister, delete the Screen entry in the Portal. As long as the player is online, it detects the change automatically and displays a new 9-digit registration code, ready to be re-registered. If the player is offline at the time of deletion, it won’t detect the change until it reconnects. Therefore, you need to make sure it’s online before deleting.
14. Supported LG webOS Devices
Only LG commercial displays running a supported version of webOS are compatible. Regular LG home TVs are not supported, even if they run webOS.
Supported: webOS 4.0, 4.1, 6.x, 8.x (8.x added April 2026) Not supported: webOS 3.x (browser too old), 5.x, 7.x (no compatible commercial display models)
For the full list of compatible LG models and recommended firmware, see our LG webOS Supported Devices page.
⚠️ Not sure if your display is compatible? Look up the model number on our supported devices page above. If it’s not listed, check the firmware version on the LG commercial display portal, or contact Yodeck Support, and we’ll help you check.
15. Factory Reset and Reinstalling the Yodeck App
The LG webOS Yodeck app is managed at the LG operating system level, so a factory reset is performed in the display’s own settings, not through the Yodeck Portal. After a factory reset, you also need to reinstall the Yodeck app manually using the steps in Section 4.
| Situation | What to Do |
|---|---|
| The Yodeck app is crashing or behaving unexpectedly | Reboot the display first (power off, then power on). On webOS, the Yodeck app launches automatically at boot, so a reboot relaunches the app. If problems continue, reinstall the app by repeating the steps in Section 4. |
| You want to completely start over with the device | Go to Settings > General > Reset to Initial Settings on the LG display. This wipes the display and returns it to its out-of-box state. You’ll then need to redo the LG initial setup tutorial and reinstall the Yodeck app using the steps in Section 4. |
| After a factory reset, the Yodeck app doesn’t appear | webOS does not restore the Yodeck app automatically after a factory reset. Reinstall it manually using the SI Server / IPK process in Section 4. |
| You reset the device, but the old screen still shows in the Portal | The old screen entry will show as Offline. Delete it from the Screens in the Portal, then register the device again as a new screen using the registration code shown on the display. |
⚠️ Before resetting: A factory reset cannot be undone, and it will require you to redo both the LG initial setup tutorial and the full Yodeck app installation. If you only need to re-register the device, try deleting and re-adding the screen from the Yodeck Portal first (as covered in Section 13). The player will detect the deletion automatically and display a new 9-digit registration code on screen; no reset needed.
Need Help?
The Yodeck Support Team can help you out! Log in to your Yodeck account and send us a message from the bottom right corner!