Slate PDF

Troubleshooting

Why Are Images Not Showing in My PDF?

Blank boxes, missing logos and grey rectangles where pictures should be — the causes, and how to get the images back.

August 19, 20262 min read

Images that fail to display in a PDF look like corruption and usually are not. There are five likely causes and they are quick to distinguish.

One: the reader is set not to show them

Some readers have an option to suppress images for speed, and some corporate builds enable it by default. Check the display preferences first — it takes ten seconds and it explains a surprising share of cases.

Two: an unsupported image encoding

JPEG 2000 and some CCITT variants are not handled by every renderer. The page draws, the image slot stays empty. Opening the file in a different reader confirms it immediately: if the picture appears elsewhere, the file is fine.

Three: the image was never embedded

A PDF can reference an external file rather than embedding it. This is rare and always a mistake for a distributed document — the image exists on the author's machine and nowhere else. There is no fix except asking for a corrected file.

Four: transparency handling

An image with a soft mask or an unusual blend mode can render as a black or white rectangle in a renderer that does not support it. Common with logos placed with transparency.

Five: genuine damage

If the image data itself is corrupted, the page renders with a gap. A repair pass may recover it; if the bytes are gone, they are gone.

What to do

  1. 1Open it in a browser to establish whether the file or the reader is at fault.
  2. 2Check your reader's image display setting.
  3. 3Update the reader.
  4. 4Run a repair if it fails everywhere.
  5. 5Ask the sender to re-export, embedding all images.

If you are producing the document

Embed every image, avoid exotic encodings for anything widely distributed, and flatten transparency where you can. Then open the result in a browser and a desktop reader before sending — the same two-viewer check that catches most rendering surprises.

Do it now

Repair PDF

Fix corrupted or damaged PDF files. It runs in this browser tab — your file is not uploaded anywhere.

Open Repair PDF

Frequently asked questions

Why do images show in Chrome but not Acrobat?+

Different renderers support different encodings. It confirms the file is intact.

Can missing images be recovered?+

If the data is in the file, a repair may restore them. If the image was never embedded, no.

Why is there a black box where the logo should be?+

Transparency that the renderer cannot handle. Flatten it when producing the file.

How do I stop this happening in documents I create?+

Embed all images, use common encodings, and check the output in two different readers.

Keep reading