The night before a deadline, I tried to hand Claude six screenshots at once and got "Failed to upload file" three times in a row. The formats were fine and the files were small. My hand hovered over the reload button while I kept refreshing the tab.
The cause turned out to be the connection I was on, not the files. Since then, handing over draft MDX, screenshots, and exported CSVs from my indie-dev work almost daily, I've hit the "not recognized" wall a few more times, and each time it came down to format, a limit, or the state of the browser or network.
What I'd like to say first: the numbers have changed since earlier versions of this guide. Everything below was checked against the official help page on October 23, 2026, and ordered the way I actually work through it.
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
Here is what the official help page lists as of October 23, 2026. Numbers move, so if in doubt, check the official help article last.
Documents PDF, DOCX, CSV, TXT, HTML, ODT, RTF, EPUB, JSON, and XLSX. XLSX uploads require "code execution and file creation" to be turned on for your account. Earlier versions of this guide listed PPTX, but it no longer appears in the current list; if a PPTX fails, export it to PDF first.
Images JPEG, PNG, GIF, and WebP. BMP and TIFF aren't listed, so convert them to PNG or JPEG.
Limits for chat uploads 500MB per file, up to 20 files per chat, PDFs up to 1,000 pages, and images up to 8000×8000 pixels. This guide used to say "about 32 MB per file"; that no longer describes chat uploads. Files added to a project are different: 30MB per file.
A common error A PDF over 1,000 pages is rejected with "Uploaded file is too large." Reduce it to 1,000 pages or fewer, or split it by chapter.
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.
Where reading changes: the 100-page line According to the help page, PDFs of 1–100 pages are analyzed for text and visual elements such as images, charts, and graphics. From 101 to 1,000 pages, only text is processed and visuals aren't analyzed. So a figure-heavy document can look "read" while Claude never mentions its charts once it passes 100 pages. Cutting out just the chapters you need and staying under 100 pages often brings that back.
Scanned PDFs (image-based PDFs) A scanned document stores its words as an image, not as text. Within 100 pages Claude reads it visually, though handwriting, tilted pages, and complex tables lose accuracy. Past 100 pages only text is processed, so a scanned PDF may arrive nearly empty (that part is my inference). In that case, extract the text with Acrobat or an OCR tool and paste it into the chat.
Page references When you ask about "page 12," give the number your PDF viewer shows, not the number printed on the page. The help page says so explicitly, and it's an easy place to be off by a few when there's a long cover and table of contents.
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 Models differ in how well they read small text and detailed figures. If a dense image isn't coming through accurately, try a more capable model from the model selector in Claude.ai.
Improve image resolution The help page recommends images of 1000×1000 pixels or larger and advises avoiding small or low-resolution ones. The ceiling is 8000×8000, so shrink very large photos first. Use the original rather than a thumbnail or a 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
That night, I suspected the format and size first and left the connection for last. When an upload fails, doubt the road the file travels before you doubt the file. I keep to that order now.
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, page count, and number of files fall within the limits. Then clear your browser cache and try in a different browser. For PDFs, check whether the file runs past 100 pages or 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.