Signage image file troubleshooting for offline displays

6 min read · Published November 1, 2026

Check storage access, the loaded content revision and image rendering in that order. Use a simple control image and a visible revision label to isolate the failing stage before changing the medium, reload process or artwork export.

Start signage image file troubleshooting by separating three questions: can the display access the storage, has the intended file been loaded, and can the player render that file? Work through them in that order. Re-exporting artwork cannot fix unreadable storage, and a picture that opens on your computer does not prove that the display has loaded it. Keep one simple image that already displays correctly as your control, then change only one thing at a time.

Read the symptom before changing files

A blank screen is not a diagnosis. Note whether the player opens, whether any pictures appear, and whether the problem affects one file or the whole show.

  • The player interface does not appear: investigate app startup before changing image exports. This is a different branch from a single missing picture.
  • The storage medium is not visible: check storage recognition before filenames, slide dimensions or artwork.
  • An older show still plays: check the reload process and the source files. Visible playback alone does not establish that the latest files were loaded.
  • Other pictures play but one is missing: concentrate on that file's actual format, export and inclusion in the loaded show.
  • The picture appears but looks stretched or cropped: investigate image proportions and display orientation, not storage formatting.
  • Small text looks soft: compare the exported pixel dimensions with the intended display resolution. Enlarging a small image cannot restore missing detail.

For the broader distinction between media playback and other player requirements, use the digital signage player guide. Keep this diagnosis focused on still-image files.

Separate storage, loading and rendering

Preparing a picture and displaying it are separate operations. Your design application exports a file. The display must then access that file, load it through the installed player's workflow and render its contents.

The offline player supports JPG, PNG and WebP images from microSD or USB. It keeps a copy of the show in internal memory and is designed to play that internal copy. An older slide on screen therefore does not prove that the current card or USB stick was read.

Use three checkpoints:

  • Storage access: establish whether the display recognizes the medium at all.
  • File loading: establish whether the intended revision reached the loaded show.
  • Rendering: establish whether that revision appears with the expected picture, proportions and detail.

Success at one checkpoint does not prove success at the next. A computer reading a card establishes only that the computer can read it. A display recognizing the card does not establish that a particular image was included in the show.

Check whether the storage is visible

Back up the source files before changing the medium. For this diagnostic process, power the display down before inserting or replacing microSD or USB storage. This avoids relying on media changes during playback.

If the display exposes a storage view, check whether the medium appears there. Distinguish that observation from the player simply showing existing content. Do not assume that every player provides a mount-status message or a file browser.

If the medium is not recognized:

  • Check that it is fully seated in the intended slot or port.
  • Confirm that your computer can still read the files after copying and safely ejecting the medium.
  • Repeat the check with another medium prepared for the same display and player.
  • If filesystem requirements are unclear, confirm them before formatting anything.

Formatting erases data. Do not format the only copy of a working show, and do not adopt a filesystem requirement from instructions for unrelated display hardware.

Stop image-export work while storage recognition remains unresolved. Changing a slide's dimensions or saving it as another image type will not make an unreadable medium accessible.

Check what was actually loaded

Once storage access is established, check the content revision. Use a diagnostic slide with a large, visible revision label, such as IMAGE CHECK B. A label inside the picture is more useful than a changed filename when you are looking at the screen.

Keep the diagnostic set small. Include the control image and the problem image, with distinct names. Confirm any required folder location using the instructions for the installed player rather than assuming that every folder will be scanned.

Our player has a hidden, PIN-protected menu for reloading a card. Use the documented reload process and observe the resulting show. Do not invent a different menu sequence or assume that copying files onto the medium also updates the internal copy.

If the revision label does not appear, return to file selection and loading. Check that you copied the exported image rather than a shortcut, design-project file or an older export with a similar name. A remote signage content workflow can help keep approved artwork and deployment copies separate when content is prepared away from the screen.

Do not assume what an interrupted load will leave on screen. Confirm the visible revision before treating the update as complete.

Check the image export

If the control image appears but the problem file does not, inspect the export rather than rebuilding the entire show.

The filename extension must match the actual file format. Renaming a document to end in .jpg does not convert it into a JPEG image. Export a fresh JPG, PNG or WebP from the source artwork. PowerPoint, PDF, HEIC and GIF files do not play in our player.

Open that exported file on your computer, not just the editable project. Check its pixel dimensions, orientation and visible contents. For a photographic slide, a fresh JPG is a useful comparison. For flat artwork or transparency, PNG is another supported option. Keep the original artwork so that each export comes from the source rather than from repeated recompression.

Use the signage content checker to inspect image resolution and shape and preview the show on a mock screen. Nothing is uploaded. That preview helps identify preparation errors, but it does not establish that the physical display has loaded the same files.

If the image renders but its shape is wrong, follow the narrower guidance on preparing portrait signage images. Rotation and artwork proportions are separate from whether a file can be read.

Apply the fix that matches the stage

Keep each correction tied to the evidence:

  • Storage access failed: resolve recognition first. Leave the artwork unchanged while comparing media and confirming storage requirements.
  • The wrong revision appeared: correct the source selection or reload process. Use the visible revision label to distinguish old content from the new export.
  • Only one image failed: replace that file with a fresh supported export, then reload using the same process that loaded the control image.
  • The image appeared with the wrong proportions: correct the canvas shape or orientation. Do not format storage to solve a layout problem.
  • The image appeared with poor detail: return to the source artwork and export at suitable pixel dimensions for the display.

The downloads section provides display spec sheets and starter slide packs. Use the relevant spec sheet to establish the target resolution instead of guessing from the screen's physical size.

Avoid changing storage, filenames, export format and orientation together. Even if the picture then appears, you will not know which change mattered.

Check the whole loop

After the repair, load the intended show and watch a complete loop. Confirm that the revision label appears, every expected image is present, and the repaired slide has the right proportions and readable detail.

Repeat the normal power-on check to confirm that the intended show appears through your usual operating sequence. Record the source filename, export format and correction that resolved the issue.

If the problem remains, send the original export, its pixel dimensions, the storage type, the installed player version if available, and a short account of which checkpoints succeeded through technical contact. State whether the control image appeared. That evidence separates an inaccessible medium from an unloaded file or a rendering problem without starting the diagnosis again.

Questions

Why does an image open on my computer but not on the signage screen?

It proves that the computer can read and render that file, not that the display has loaded it. Check storage recognition, the loaded content revision and the actual image format separately. Compare the problem file with a simple supported image that already displays correctly.

Should I format the card when a signage image is missing?

Not as a first step. Formatting erases data and does not fix an unsupported image export or incorrect artwork proportions. Back up the files, establish whether the display recognizes the medium, and confirm its storage requirements before deciding whether formatting is appropriate.

Why is the screen still showing an older picture?

The player keeps an internal copy of the show and is designed to play that copy. An older picture does not establish that the latest files were loaded. Put a visible revision label inside a diagnostic image, use the documented reload process and check for that label on screen.

Planning information, not legal or engineering advice. Rules differ by place: check codes and permits with your local authority and your licensed trades.

Keep reading

Build your signAsk for a quote