If you've ever tried to attach a PDF or image to Claude only to have it fail silently or throw an error, you're not alone. It's one of the more frustrating experiences when you're ready to get work done and the first step doesn't cooperate.
As an indie developer running the Dolice Labs blogs, I hand Claude draft MDX, screenshots, and exported CSVs almost every day — so I've hit the silent "file not recognized" wall more than once. Each time, narrowing it down calmly, the cause came down to format, size, or a stale browser state. This guide walks through those causes in the order I actually check them, with a practical fix for each. Most cases resolve if you work through them one by one.
Identifying Your Error Type
Before diving into fixes, it helps to know which type of problem you're dealing with. Claude file issues tend to fall into four categories.
① The attach button doesn't respond or the upload never completes This is typically caused by a browser issue, a cached session state, or a file that exceeds the size limit.
② The file uploads but Claude says it can't read it This usually means the file format isn't supported or the file is corrupted.
③ An image is attached but Claude doesn't seem to understand its content The model you're using may not support vision, or the image quality may be too low for reliable recognition.
④ A PDF is attached but Claude only seems to see part of it Very long PDFs or scanned (image-based) PDFs hit practical reading limits.
Step 1: Check Supported File Formats and Size Limits
Claude supports a broad range of file types, but not everything. Here's what works as of April 2026.
Text and documents Plain text (TXT), PDF, CSV, DOCX, PPTX, XLSX, HTML, and Markdown are all supported.
Images JPEG, PNG, GIF, and WebP are supported. BMP, TIFF, and RAW formats are not currently supported.
Code and data files Python (.py), JavaScript (.js), TypeScript (.ts), JSON, XML, and most common code file types can be read directly.
File size limits Each individual file has a cap of roughly 32 MB. If your file is larger, you'll need to split it or convert its contents to a pasteable text format. There's also a practical limit on the combined size of all files in a single conversation, so avoid uploading many large files at once.
Step 2: Refresh Your Browser Environment
If a properly formatted file still won't upload, the browser itself is often the culprit.
Clear cache and cookies Claude.ai is sensitive to stale browser state. In Chrome, go to Settings → Privacy and Security → Clear Browsing Data, then delete cache and cookies. Reload the page and try again.
Try a different browser If clearing cache doesn't help, open the conversation in a different browser entirely. Chrome, Firefox, Safari, and Edge can all behave differently, and what fails in one often works fine in another.
Disable extensions Ad blockers and privacy extensions sometimes interfere with file upload functionality. Test in an incognito window or with extensions disabled to rule this out.
Check your mobile app version If you're using the Claude iOS or Android app, make sure it's fully up to date. Older versions may have incomplete file support.
Step 3: Fixing PDF-Specific Problems
PDFs are the most common source of upload confusion, so they deserve their own section.
Scanned PDFs (image-based PDFs) When a document is scanned and saved as a PDF, the content is stored as an image—not as selectable text. Claude can work with these to some degree, but accuracy drops significantly and very complex layouts may be missed entirely.
The most reliable workaround is to extract the text first. You can open a scanned PDF in Google Drive and use its built-in OCR to get an editable version, or use a dedicated OCR tool. Once you have the text, paste it directly into the chat.
Very long PDFs Even text-based PDFs have practical limits. If you're sending a 100-page technical document, Claude won't be able to hold all of it in context at once. Trim the file to the relevant pages, or be explicit about which sections you need help with.
Password-protected PDFs Encrypted PDFs cannot be read by Claude. Remove the password protection before uploading.
Step 4: Fixing Image Recognition Issues
If Claude receives an image but doesn't seem to understand what's in it, here's what to check.
Switch to a more capable model Image understanding is strongest in Claude Sonnet and Claude Opus. If you're using a Haiku tier model, switching up may resolve the issue. You can change models from the model selector in the Claude.ai interface.
Improve image resolution Very small or heavily compressed images are harder to interpret accurately. Where possible, use the original high-resolution version of the image rather than a thumbnail or screenshot of a screenshot.
Text-in-image recognition Claude handles OCR tasks (reading text from images) reasonably well—business cards, screenshots, and document photos are all fair game. That said, very small fonts or tilted text will reduce accuracy. Increasing contrast and cropping tightly to the relevant area of the image helps.
Step 5: Fallback Options When Nothing Else Works
If you've tried everything above and the file still won't cooperate, these alternatives almost always get the job done.
Paste the content directly For text-based files—code, CSV data, email threads, article drafts—simply copying the content and pasting it into the chat is just as effective as uploading the file. Claude reads it the same way either way.
Convert to a different format Sometimes changing the file format breaks whatever was causing the issue. Try converting a DOCX to PDF, or a PDF to plain text, and upload the converted version.
Use the Claude API If you need to handle very large files or process multiple documents in a workflow, the API gives you finer control over how files are passed to Claude. It also supports batch processing patterns that aren't available through the web interface.
The 5 Places I Check First When "Failed to upload file" Keeps Appearing
Sometimes the same file triggers "Failed to upload file" again and again. When this happens, there are a few things I check before formats or sizes — because this error usually points to something interrupting the upload midway, on the network or environment side.
1. Is your connection dropping mid-upload? Uploads need a stable connection for a few seconds. On mobile data or shaky Wi-Fi, the session can break partway through and return the same error. Retrying on a wired or stable connection often clears it on its own.
2. Is a browser extension blocking the request? Ad blockers and privacy extensions sometimes intercept the upload request. Opening an incognito window disables extensions, which makes this easy to isolate. If it works there, the extension is your culprit.
3. Are you behind a corporate proxy or VPN? Company networks and VPNs can filter file-upload requests. Turning the VPN off for a single test quickly tells you whether the environment is the cause.
4. Does the filename contain special characters? Emoji, certain symbols, or extremely long filenames can make an upload fail. Renaming the file to a short, plain-ASCII name and trying again often just works.
5. How many files are you sending at once? Attaching several files together can hit a combined-size or concurrency limit. Send them one at a time to pinpoint where it fails.
Walking down these five in order, most cases where a file fails despite a valid format and size turn out to have a cause somewhere in the connection or the environment.
Looking back
Most Claude file attachment and recognition problems come down to a handful of root causes: unsupported format, oversized file, stale browser state, or a scanned PDF. Work through this checklist whenever you hit a wall.
First, verify that your file format and size fall within the supported range. Then clear your browser cache and try in a different browser. For PDFs, check whether the file is scan-based and extract text if needed. For images, switch to a more powerful model and use a high-resolution source image. As a last resort, paste the content directly into the chat instead of uploading a file.
If problems persist after all of that, the Anthropic support page is the right place to reach out. We hope this guide helps you get back to the work that matters.