You drag a PDF or PNG into the chat. The attachment tile appears with the file name and size, but the preview thumbnail is a blank gray rectangle, a broken-image icon, or just nothing at all. Worse, you cannot tell from the UI whether Claude actually received the content or only the metadata. Most of the time the file did upload fine and Claude can read it; only the preview layer broke. The cause is usually one of: a CDN race where the thumbnail render lagged the upload, an unusual MIME type that the preview pipeline does not handle, a stale browser cache, or an image format Claude opened but the previewer cannot rasterize.
Common causes
Ordered roughly by how often each one is the real reason.
1. Thumbnail render lagged the file upload
The file is uploaded and indexed, but the preview thumbnail is generated by a separate service that occasionally lags by a few seconds.
How to judge: Wait 30 seconds and refresh the page. If the thumbnail appears, this was it.
2. MIME type mismatch between client and server
Some browsers set application/octet-stream for unusual file types. The previewer cannot guess what to render and falls back to the blank tile.
How to judge: Right-click the file in your OS, check its real type. If it differs from what the upload dialog showed, MIME confusion is likely.
3. Browser cache holding a stale render
Hard refreshes are uncommon and the preview CDN sets long cache headers. A previously failed render can be cached and re-served forever in that session.
How to judge: Try in an Incognito window. If the preview appears there, your main browser cache is stale.
4. PDF or image larger than the preview pipeline can handle
PDFs over 100 pages or images over 20 MP often skip thumbnail generation to save compute. The file is still readable by Claude.
How to judge: Check the file size and dimensions. If either is on the high end, that is your answer.
5. Unsupported image format (HEIC, AVIF, TIFF)
Claude can read modern formats but the previewer mostly handles PNG, JPG, GIF, and WebP. Other formats upload but show no thumbnail.
How to judge: Look at the file extension. HEIC, TIFF, AVIF, or BMP have spotty preview support.
6. Network blocked the thumbnail CDN
Corporate proxies and some ad-blockers block third-party CDN domains. The file upload succeeds because it uses the main API endpoint, but the thumbnail CDN is unreachable.
How to judge: Open DevTools, Network tab, filter on “image.” Look for blocked or 4xx-status requests to a CDN subdomain.
Before you start
- Confirm Claude can actually see the content by asking a simple question about the file (“What is the title on page 1?”). If it answers correctly, the file is in.
- Decide whether the preview matters for your workflow or whether you can proceed without it.
- Have one alternate browser ready (Chrome if you are on Safari, or vice versa).
Information to collect
- Exact file type, size, and dimensions or page count.
- Browser, version, OS, and any active extensions.
- Whether the tile shows a file icon or a broken-image icon.
- Network conditions: corporate VPN, public Wi-Fi, residential.
- Screenshot of the attachment tile and any console errors from DevTools.
- Whether other attachments in the same conversation render correctly.
Step-by-step fix
Step 1: Wait and refresh
Give it 30 seconds, then refresh the conversation. Most failed previews resolve on the second load because the CDN has caught up by then.
Step 2: Confirm Claude actually has the content
Ask the assistant: “Without re-reading, summarize the file I just attached in two sentences.” If the summary is accurate, the upload worked and only the preview is broken; you can proceed.
Step 3: Re-upload with a clean format
Convert HEIC to JPG, AVIF to PNG, TIFF to JPG. For PDFs over 50 MB, compress with a tool like Adobe Acrobat or Smallpdf. Re-upload the cleaner version and the preview usually renders.
Step 4: Open in Incognito and re-upload
Open the same conversation in an Incognito or Guest window with no extensions. Re-upload the file. If the preview renders here, your normal browser has a stale cache or a blocking extension.
Step 5: Disable extensions one at a time
In your main browser, disable extensions and reload. uBlock, Privacy Badger, and corporate security extensions are the most common culprits. Re-enable one by one until the preview breaks again.
Step 6: Try a different network
Tether to a phone hotspot and reload. If the preview renders on cellular, your office or home network is blocking the CDN. File a ticket with your IT team to whitelist the Anthropic preview domain.
Step 7: For persistent failures, attach via API
For mission-critical files that must preview, upload via the Files API instead of the web UI. The API returns a file_id you can reference directly; the preview layer is bypassed.
Verify
- A thumbnail appears in the attachment tile within 10 seconds of upload.
- Clicking the thumbnail opens the full-size preview overlay.
- Claude responds correctly to questions about the file content.
- Reloading the conversation a minute later still shows the thumbnail.
Long-term prevention
- Convert HEIC and AVIF to JPG or PNG before uploading; the iOS Files app and macOS Preview can both do this.
- Keep PDFs under 50 MB by compressing or splitting before upload.
- Whitelist Anthropic CDN domains in your corporate proxy and any ad-blocker.
- Keep one browser profile clean of extensions for upload-heavy work.
- For automated pipelines, prefer the Files API over the web UI.
Common pitfalls
- Assuming a missing preview means Claude cannot see the file. Ask a question to confirm before re-uploading.
- Re-uploading the same broken file 5 times. Same MIME, same outcome — try a different format.
- Treating the iPhone Photos share sheet output as JPG. It is often HEIC; check the extension.
- Forgetting that drag-drop on Safari sometimes loses the original MIME. Use the Upload button instead.
- Trusting a partial preview (first page only) as proof the rest is readable. Sometimes only the first page indexed.
FAQ
- Did Claude actually receive the file even without a thumbnail? Usually yes. Ask the model to summarize the file to confirm.
- What file types preview reliably? PDF, PNG, JPG, GIF, WebP, plain text, CSV, Markdown. Office formats preview as text-extracted, not visually.
- Why does HEIC fail? The preview pipeline does not rasterize HEIC in many environments. Convert to JPG before upload.
- Is there a size limit? Soft cap around 32 MB per file via the web UI. Files API supports up to 500 MB.
- Does mobile work better than desktop for previews? Slightly worse, actually. Mobile Safari is more aggressive about cache and CDN behavior.
- Will refreshing lose my conversation? No, refreshes are safe. Conversations persist server-side; only the in-page state reloads.
Related
- Claude file upload stuck on processing
- Claude artifact renders blank
- Claude PDF table extraction wrong
- Claude mobile app sync broken
- Claude file generation credits
- Claude conversation export broken
Tags: #Claude #Troubleshooting #PDF #Debug