Skip to content
InnovateTechie
Claude Pricing

Claude Upload Limit: File Sizes, Counts and Fixes

InnovateTechieBy InnovateTechie9 min read
Share
Claude Upload Limit: File Sizes, Counts and Fixes

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.

The 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.

SurfaceMax file sizeMax filesNotes
Chat attachment (claude.ai)500MB per file20 per chatImages up to 8000×8000 px
Projects knowledge base30MB per fileEffectively unlimitedPaid plans; retrieval-based
Developer Files API (beta)500MB per file100GB per orgReferenced by file ID

Claude upload limit by surface — file size and file count caps for chat, Projects, and the developer Files API

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.

CategoryFormatsSize capNotes
DocumentsPDF, DOCX, RTF, ODT, TXT, EPUB500MB chat / 30MB ProjectPDFs best under 100 pages for full visual analysis
DataCSV, JSON, HTML, XLSXSame as above.xlsx needs code execution enabled
ImagesJPEG, PNG, GIF, WebPSame as aboveUp 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.

How an uploaded file consumes Claude's context window tokens alongside the conversation and replies

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.

ErrorLikely causeFix
"File too large"Over the 500MB chat or 30MB Project capSplit by page range, or compress the PDF/images
"Message too long" after uploadToken count overflows the ~200K context windowUpload fewer files, or paste only the relevant section
"Unsupported file type"Format not on the accepted listConvert to PDF, TXT, or CSV first
Upload stalls or fails silentlyNetwork drop or oversized imageRetry 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

PlanPrice
Free$0
Pro$20 / month
Maxfrom $100 / month
APIPay per token

For the full breakdown of every plan, see our how much Claude costs guide.

Frequently Asked Questions

On claude.ai, chat attachments can be up to 500MB per file, while Projects knowledge-base files cap at 30MB each. Developers using the Files API can store files up to 500MB. In practice, the ~200K-token context window limits how much of any large file Claude actually reads at once.

Claude.ai allows up to 20 files per conversation in a single chat. If you need more, Claude Projects on paid plans keep far more documents in a persistent, searchable knowledge base that Claude retrieves from on demand, so you are not limited to 20 attachments per thread.

Split it by page range into smaller PDFs, compress it to shrink embedded images, or copy the text straight into the chat box. For repeated access to a big document, add it to a Claude Project or upload it through the developer Files API, which handles files up to 500MB.

Yes. Claude reads .xlsx spreadsheets when code execution is enabled on your account, up to the per-file size cap. For very large sheets, exporting to CSV strips formatting and uses fewer tokens, so more rows fit inside the context window. Our [Claude Excel guide](/claude-excel) covers spreadsheet workflows in depth.

No. Claude has no folder or directory upload; you select files individually, up to 20 per chat. To bring in a whole project, add the files to a Claude Project one at a time, or connect external storage such as Google Drive or GitHub through an MCP connector instead.

Claude accepts PDF, DOCX, TXT, RTF, ODT, CSV, JSON, HTML, and EPUB documents, plus JPEG, PNG, GIF, and WebP images. Spreadsheets (.xlsx) work when code execution is enabled. Anything outside these types has to be converted to text or one of the supported formats before Claude can read it.

There is no model-specific cap. Claude Sonnet, Opus, and Haiku all share the same upload limits on claude.ai, and the same ~200K-token context window applies to each. The file size you can use depends on the surface — chat, Project, or Files API — not on which model you pick.
InnovateTechie

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 →