Part ofHow Much Does Claude Cost? Full Pricing Breakdown
Claude upload limit explained: file size and count caps for chat, Projects and the Files API, how uploads eat context, and fixes when they fail.
In This Article
7 sectionsThe Claude upload limit on claude.ai is 500MB per file and 20 files per chat, with images capped at 8000×8000 pixels. Projects knowledge-base files max out at 30MB each but are effectively unlimited in number, and the developer Files API stores up to 500MB per file. The real ceiling is the ~200K-token context window every upload shares.
We push documents into Claude every day — research PDFs, spreadsheets, whole draft posts — and the numbers people quote for the Claude upload limit are usually a version behind. Anthropic raised the chat cap without much fanfare, so here are the current limits, the reason your file gets rejected, and the fixes we reach for when something is genuinely too big.
What the Claude upload limit actually covers
There isn't one Claude upload limit — there are three, one for each place you can put a file. Mixing them up is why the advice online contradicts itself.
- Chat attachments on claude.ai: up to 500MB per file, 20 files per conversation, and images up to 8000×8000 pixels. This is the paperclip icon in a normal chat.
- Projects knowledge base (paid plans): 30MB per file, but effectively unlimited files — Claude indexes them and pulls in only the relevant sections on each question.
- Developer Files API (beta): up to 500MB per file, with 100GB of total storage per organization, referenced by file ID across API calls.
Anthropic documents these in its official upload files to Claude help article, and the size caps are identical whether you are on Free, Pro, or Max.
| Surface | Max file size | Max files | Notes |
|---|---|---|---|
| Chat attachment (claude.ai) | 500MB per file | 20 per chat | Images up to 8000×8000 px |
| Projects knowledge base | 30MB per file | Effectively unlimited | Paid plans; retrieval-based |
| Developer Files API (beta) | 500MB per file | 100GB per org | Referenced by file ID |
Free vs Pro vs Max: what actually changes
Here's the part that surprises people: the Claude file upload limit for size and count is identical on every plan. A Free user and a Max user both get 500MB per chat file and 20 files per conversation. What changes with price is how much you can do with those uploads.
- Free — full chat uploads, but tight daily message limits mean a couple of large documents can exhaust your allowance fast. No Projects.
- Pro ($20/month) — everything on Free plus Projects, the persistent knowledge base that holds far more than 20 files. Our Claude Pro plan breakdown lists the full feature set.
- Max (5× at $100, 20× at $200) — the same technical caps with much higher usage ceilings and priority, so you can work across long, document-heavy sessions without hitting a wall. Claude Max is the tier we run on heavy research days.
- Team and Enterprise — Projects plus admin controls for enabling code execution (needed for .xlsx) and data governance.
Cost is the real differentiator here, not the Claude AI upload limit itself — our pillar on how much Claude costs maps every tier to what you actually get for the money. The Claude upload limit for file size simply does not scale with your subscription.
Supported file types and sizes
The Claude upload limit is not only about size — format matters too. Claude reads a wide range of documents, but only a fixed set of formats. Upload something outside the list — a .zip, a .psd, a raw video — and you'll get a rejection before the size check even runs.
| Category | Formats | Size cap | Notes |
|---|---|---|---|
| Documents | PDF, DOCX, RTF, ODT, TXT, EPUB | 500MB chat / 30MB Project | PDFs best under 100 pages for full visual analysis |
| Data | CSV, JSON, HTML, XLSX | Same as above | .xlsx needs code execution enabled |
| Images | JPEG, PNG, GIF, WebP | Same as above | Up to 8000×8000 pixels |
PDFs are the common case. Under 100 pages, Claude analyzes both the text and the visual layout — charts, tables, scanned figures. Past that it leans on text extraction and can drop images, so a 400-page scanned report will lose its diagrams even though it uploads fine. The Claude file size limit is rarely the problem with PDFs; page count and token count are.
How uploads eat your context window
The 500MB number is a red herring for most work. The real Claude attachment limit you hit day to day is the context window — roughly 200,000 tokens (about 150,000 words) that every upload shares with your conversation history and Claude's replies.
A file has to be converted to tokens before Claude can reason over it, so size on disk and size in context are different currencies. A dense 300-page PDF can blow past 200K tokens on its own, which is why a file that uploads successfully can still trigger a "too long" error the moment you ask a question. Our Claude context window guide breaks down the token math, but the rule of thumb is simple: if a document wouldn't fit inside a 150,000-word book, don't expect Claude to hold all of it at once.
Fixing a Claude upload limit error
When you hit the Claude upload limit, it's almost always one of four things: the file exceeds the per-surface size cap, its token count overflows the context window, the format isn't supported, or a flaky connection dropped the transfer mid-upload. Here's how we clear each one.
| Error | Likely cause | Fix |
|---|---|---|
| "File too large" | Over the 500MB chat or 30MB Project cap | Split by page range, or compress the PDF/images |
| "Message too long" after upload | Token count overflows the ~200K context window | Upload fewer files, or paste only the relevant section |
| "Unsupported file type" | Format not on the accepted list | Convert to PDF, TXT, or CSV first |
| Upload stalls or fails silently | Network drop or oversized image | Retry on a stable connection; downscale huge images |
The fastest fix for a document that's only slightly over: paste the text directly into the chat box. Copy-pasted text skips the file pipeline entirely and often fits where the file itself was rejected.
How to upload large files to Claude
When a file is genuinely too big to split, you have three durable options. First, Claude Projects on any paid plan: drop the document into the knowledge base once and Claude retrieves the relevant slices on every question, which sidesteps the whole question of how many files Claude can hold in a single chat. Second, the Files API, documented at Anthropic's Files API reference, which stores files up to 500MB server-side and lets your code reference them by ID across requests. Third, an MCP connector to external storage — Google Drive, GitHub, a database — so Claude reads from the source instead of a one-time upload.
For most people the answer is Projects. It's the difference between re-uploading a 20MB spec every session and having it permanently on hand, and it's the cleanest way to make the Claude upload limit stop being a daily annoyance.
According to Anthropic's official docs, per-file and per-chat caps currently vary by surface, and every upload counts against the same context budget a Sonnet 4.6 or Opus 4.8 session uses.
Claude pricing at a glance
| Plan | Price |
|---|---|
| Free | $0 |
| Pro | $20 / month |
| Max | from $100 / month |
| API | Pay per token |
For the full breakdown of every plan, see our how much Claude costs guide.
Frequently Asked Questions

Written by
InnovateTechie
Writing about Claude and the Anthropic toolkit — models, Claude Code, pricing, features, and fixes, in clear, practical, hands-on guides tested by daily use.
View all posts →





