Skip to content

Display troubleshooting

When displays don’t work as expected, use this guide to diagnose and resolve common issues.

The fastest path is the built-in guided check. Open the display from Zones, then under Troubleshoot click Something isn’t working, and pick what you’re seeing:

  • My screen is not updating — BrandCast checks the connection and refreshes the screen.
  • My screen is locked or frozen — it refreshes the screen, then restarts the display app if that doesn’t help.
  • My screen is dark — it checks the connection.

After each try it asks Is the issue fixed? If you answer No, still broken, it moves to the next fix, and finally offers Ask Twig to work through it with you.

You can also read the display’s status directly on its card:

StatusMeaningAction
OnlineConnected to BrandCast right now and playingCheck what’s scheduled on its week calendar
OfflineThe live connection to BrandCast has droppedUsually self-recovers within a minute or two; see Display loses connection intermittently before troubleshooting
UnpairedNo device claimed yetComplete the pairing process

A card has no Sleeping status. A display inside a night schedule shows a moon icon and a purple left border while its chip still reads Online or Offline — usually Offline, because a sleeping screen stops answering the health checks that keep it marked Online. An Offline chip on a card wearing a moon is normal during off-hours; check the night schedule only if the hours look wrong. The counts at the top of Zones put that same display under Sleeping, not Offline, which is why the counts can disagree with the chips.

Check device connectivity:

  1. Verify the display device has internet access — try loading any website in the device’s browser.
  2. Check WiFi signal strength or try a wired ethernet connection.
  3. Verify no firewall is blocking secure web connections (HTTPS, port 443).

Restart the connection:

  1. Refresh the browser on the display device.
  2. Close and reopen the browser (or restart the BrandCast app on Sentinel hardware).
  3. Power cycle the display device.
  4. If the problem persists, open the display’s panel and use Unpair · Change device on this display to re-pair with the fresh code shown on the device.

A brief Offline flicker is often normal and needs no action. A display running in a regular browser tab — a computer or tablet with BrandCast open in a browser, rather than a dedicated always-on device or kiosk — can momentarily show Offline whenever the tab is backgrounded, the computer goes to sleep, or the network blips. Any of these drops the display’s live connection to BrandCast. The display keeps playing through it and returns to Online automatically within a minute or two once it reconnects — the admin status dot self-corrects on its own.

Only work through the checklist below if a display stays Offline instead of recovering:

  • Check for WiFi interference (microwave ovens, crowded networks, distance from router).
  • Consider switching to a wired ethernet connection for more reliable signage.
  • Verify the device’s power settings don’t allow the screen or browser to sleep.
  • Check whether the TV has an auto-off feature enabled — disable it for signage use.

Tip: For a display that must never flicker Offline, run it on a dedicated always-on device or kiosk rather than a browser tab you also use for other things.

  1. Wrong characters — codes are six uppercase letters and digits. Double-check each character.
  2. Stale code — the device rolls its code over periodically. Reload the device and use the code currently on screen.
  3. Wrong URL — confirm the device is visiting displays.brandcast.app.

See Pairing a device for the full flow.

BrandCast’s display app is designed to recover automatically from interruptions. If the display browser is closed and reopened, or if the device briefly loses power, the display picks up where it left off using its last known schedule and content. You don’t need to re-pair after a brief outage.

If the display comes back showing a loading screen that doesn’t clear within a minute, try refreshing the browser page. If it still doesn’t recover, power cycle the device.

  1. Open the display from Zones and look at its week calendar.
  2. If the current hour is hatched, the screen is in night mode — that’s expected. Use Wake now if you need it on.
  3. If the current hour has no block and no dashed fallback, nothing is scheduled. Add a Design — see Scheduling Designs on screens.
  4. If a Design is scheduled, open it and check its Pages have content.
  5. Click Refresh content and wait a minute.
  1. Find the current hour on the display’s week calendar. A solid block is a scheduled Design; a dashed block is the fallback that fills unscheduled hours.
  2. Double-click the block to open that Design and check it’s the one you meant.
  3. If the times look shifted, check the display’s Timezone.
  1. Make sure you clicked Save in the editor — edits to a Page don’t reach screens until they’re saved.
  2. Wait a minute, then click Refresh content in the display’s panel, or Refresh screens in the Design’s Where & when.
  3. For files from Google Drive, check the file was updated and the Google connection still works.
ProblemSolution
BlurryUse higher-resolution source images
Stretched or croppedUse content that matches your display’s aspect ratio
RotatedCheck the screen’s Orientation, and that the Design was made for that orientation

Video won’t play: Verify the format — MP4 files with standard encoding work best. Re-upload or re-encode the video if needed.

Video stutters or freezes: Reduce the video resolution or bitrate. Check that the device has sufficient network bandwidth and RAM.

No audio: Check the mute setting in the content configuration, and verify the TV’s own audio isn’t muted.

  1. Close any other apps running on the display device.
  2. Cut down the number of areas or Pages in the Design that’s playing.
  3. Optimize images by compressing and resizing them before uploading.
  4. Limit the number of videos playing at once.
  5. Consider upgrading the display hardware if problems persist.
  1. Refresh the browser page on the device.
  2. Restart the browser or the BrandCast app.
  3. Power cycle the display device.
  4. If one piece of content always causes a freeze, remove it from the Page and re-upload or recreate it.

The screen is mounted in a different orientation than the content was designed for. Remount the screen, change the display’s Orientation (BrandCast Players and Sentinel devices), or play a Design made for that orientation.

The content’s proportions don’t match the display’s proportions. Use content that matches your display’s aspect ratio.

Disable the TV’s picture enhancement or “vivid” modes. These features process the image in ways that make digital signage look inaccurate. Use the TV’s “Standard” or “Custom” picture setting.

As a last resort:

  1. Soft reset — Refresh the browser on the device.
  2. Re-pair — Use Unpair · Change device on this display in the display’s panel and pair the device again with its fresh code.
  3. Recreate — Use Delete Display in the panel’s Danger Zone and create a new one. Your Designs and Pages stay.

If problems persist after troubleshooting:

  1. Contact support with the display name, device type, and a description of what you’ve tried.

Information to gather before contacting support

Section titled “Information to gather before contacting support”
  • Display name and its status in the dashboard
  • Device type (TV brand, streaming stick, computer, Sentinel tier, etc.) and browser
  • Exact error messages you see
  • When the problem started and what changed around that time
  • Steps you’ve already tried