Why Does a Webpage PDF Have Missing Images?
Missing images in a webpage PDF can come from print settings, page styles, or images that never loaded. Diagnose the cause with this browser-by-browser guide.
A webpage PDF can have missing images because browsers use a print layout that may differ from the page on screen. Background images and colors are often controlled by a print setting; inline images may instead be blocked by the page’s print styles, fail to load, or be affected by a browser or system problem. Compare the page with print preview first, then follow the checks below to narrow down the cause.
1. Compare the webpage with print preview
Open the page’s print dialog or print preview and compare it with the page as displayed in the browser. This tells you what kind of content is missing and whether the problem appears before the PDF is saved.
- Backgrounds, decorative artwork, or colored panels are missing: check the browser’s background graphics option.
- Inline photos or illustrations are missing: check whether they loaded on the webpage, whether the print layout hides them, and whether another browser produces the same preview.
- The preview looks complete but the saved PDF does not: save again and inspect the new file in a different PDF viewer. This helps distinguish a print-generation problem from a display problem in the viewer.
Print output can differ from what appears on screen. Mozilla Support notes that web pages can be configured to look different on paper. A missing image therefore does not, on its own, identify the cause.
2. Turn on background printing
Microsoft Edge
- Open the page’s print dialog.
- Expand More settings.
- Enable Background graphics.
- Review the preview before saving or printing.
Microsoft recommends enabling Background graphics when the preview or output differs from the webpage. This setting applies to background graphics; it does not fix an inline image that failed to load or is omitted by the page’s print layout. Microsoft’s Edge print troubleshooting.
Mozilla Firefox
- Open the print dialog and inspect the preview.
- Enable Print backgrounds in the print options.
- If the option is unavailable or backgrounds remain absent, check that the page is not using Simplified format. Firefox’s Simplified format disables Print backgrounds.
- To save a PDF, choose Save to PDF from the destination dropdown.
See Mozilla’s Firefox printing instructions for the print controls and PDF destination.
Browser wording and control placement may vary between versions. Use the preview to confirm that the change affected the missing content.
3. Work out whether the page or browser is responsible
Use the same URL and compare both the affected page and another page. Change one variable at a time so the result is useful:
- Try the same page in another browser. If the images appear in its print preview, investigate settings or saved state in the original browser. If they are missing in both, the page or its content is more likely involved.
- Try another website in the affected browser. If that page prints correctly, the issue may be specific to the original site’s content or print styling.
- Try printing from another application. If print problems also occur outside the browser, check the printer driver, operating system, connectivity, or hardware rather than treating it as a webpage-only issue.
Microsoft Support lists damaged graphics, fonts, or code on a website or document among possible causes of print issues. It also recommends testing a plain version in Immersive Reader where available. These checks are diagnostic; no one setting fixes every missing-image PDF. See Microsoft’s troubleshooting guide and Mozilla’s Firefox printing troubleshooting guide.
4. Check the image itself and the page’s print layout
If only one or a few inline images are absent, verify that they are visible on the page before printing. Reload the webpage and wait for its images to finish loading, then reopen print preview. A print stylesheet can intentionally hide or rearrange content, and an image that did not load cannot be restored by enabling background printing.
For a single image, Firefox notes that you can usually open it in a new tab and print it directly. This may retrieve that image, but it does not repair the complete webpage PDF. Mozilla’s printing instructions.
5. Troubleshooting by symptom
| Symptom | Likely area to check | Next step |
|---|---|---|
| Background art or colored sections are absent | Print background setting | Enable Background graphics in Edge or Print backgrounds in Firefox, then inspect preview. |
| Firefox has no Print backgrounds control | Simplified format | Switch to the original page format and check preview again. |
| Inline images are missing in preview and on the webpage | Image loading or page content | Reload, wait for images, and test another browser. A print option cannot restore an image the page did not load. |
| Inline images appear on screen but not in print preview | Page print layout or browser behavior | Try another browser and, where available, a plain view such as Edge Immersive Reader. |
| One page fails, other pages print correctly | Page-specific content or styling | Compare the same page in another browser and test another page in the original browser. |
| Pages from multiple sites or applications fail | Browser, driver, operating system, connectivity, or hardware | Follow the browser’s print troubleshooting steps; check whether printing fails outside the browser too. |
| Firefox alone keeps using incorrect print behavior | Saved print settings or browser state | Use Mozilla’s Firefox printing troubleshooting guide to clear saved print settings. |
6. Save a clean PDF from a browser
- Wait until the webpage’s visible images have loaded.
- Open print preview and select the original page format if a simplified layout is active.
- Enable background printing if backgrounds are missing.
- Check the preview page by page, especially where images or background sections should appear.
- Choose the browser’s PDF destination, such as Firefox’s Save to PDF, and save the file.
- Open the saved PDF in a viewer and compare it with the preview.
If the preview itself is missing images, changing PDF viewers is unlikely to restore them; return to the page-versus-browser checks above.
7. Or skip the browser setup
If your goal is a screenshot or PDF capture for a workflow, ScreenshotNeo is a website screenshot API and MCP server from ScreenshotNeo. A GET request can return a PNG, JPEG, WebP, or PDF. Its capture options include full-page capture with lazy images loaded and custom wait conditions. For a webpage PDF, request the PDF output using the documented API parameters; use a browser’s print-to-PDF flow when you specifically need to inspect or control its print preview.
For example, this cURL request saves a webpage capture as WebP:
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp
See the ScreenshotNeo API documentation for authentication, PDF output, capture options, and response headers. Python and Node.js versions of the same request:
import requests
r = requests.get(
"https://api.screenshotneo.com/v1/shot",
params={"access_key": "YOUR_API_KEY", "url": "https://stripe.com"},
timeout=90,
)
open("shot.webp", "wb").write(r.content)
const q = new URLSearchParams({ access_key: 'YOUR_API_KEY', url: 'https://stripe.com' });
const res = await fetch(`https://api.screenshotneo.com/v1/shot?${q}`);
if (!res.ok) throw new Error(`ScreenshotNeo returned ${res.status}`);
await import('node:fs/promises').then(fs => fs.writeFile('shot.webp', Buffer.from(await res.arrayBuffer())));
- Cookie banners are accepted and removed, along with known newsletter popups and chat widgets, before capture; each step can be turned off.
- Bot checks, blank pages, failed loads, timeouts, and cache hits are not billed. The response identifies the page verdict and billing status in headers.
- An MCP server provides screenshot tools for Claude, Cursor, and other MCP clients.
- The free plan includes 1,000 screenshots a month with no card. Paid plans start at $5 for 3,000 screenshots.
Sign up for 1,000 free screenshots a month, with no card required.
8. Performance, reliability, and cost
For browser print-to-PDF, the main practical reliability check is the preview: wait for page images to load, confirm backgrounds are enabled where needed, and review all pages before saving. The support guidance does not establish one universal cause or guarantee a fix for every site.
For automated capture, ScreenshotNeo offers caching with a chosen TTL, asynchronous jobs with signed webhooks, and bulk capture of up to 100 URLs per call. Its stated billing rule means bot checks, blank pages, timeouts, failed loads, and cache hits cost nothing. Plans are Free (1,000 shots/month), Starter ($5 for 3,000), Growth ($15 for 15,000), Pro ($39 for 60,000), Scale ($99 for 250,000), and Business ($249 for 1,000,000); yearly billing gives two months free. Every feature is available on every plan. Consult the documentation for request settings and response details.
FAQ
Does enabling background graphics bring back every missing image?
No. It affects background graphics. Inline images can be missing because they did not load, the page’s print layout omitted them, or a browser or system issue affected printing.
Why does the print preview differ from the webpage?
Web pages can use print-specific layouts, and browsers provide print controls that affect backgrounds and formatting. Compare the preview and test another browser to narrow down the cause.
Can I fix a PDF after saving it?
If the image is absent from the generated PDF, the practical route is usually to correct the source or print settings and generate it again. Opening the image directly can help with one image, but will not reconstruct a complete page.
What if the preview is complete but the PDF viewer shows gaps?
Open the saved file in another PDF viewer. If it appears there, the issue may be the original viewer; if not, regenerate from the browser after checking its preview and settings.


