Claude Upload Limit: File Sizes, Counts and Fixes

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 context window every upload shares — up to 1M tokens on current models.

Upload caps and context-window sizes verified 31 July 2026 against Anthropic's context windows documentation.

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 are three separate caps, one per surface: chat attachments allow 500MB per file and 20 files per conversation, Projects knowledge-base files cap at 30MB each but are effectively unlimited in number, and the Files API stores 500MB per file.

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.

Free vs Pro vs Max: what actually changes

Nothing about size or count changes with price — Free and Max both get 500MB per file and 20 files per chat. What paid tiers buy is usage headroom and Projects, the persistent knowledge base that holds far more than 20 documents.

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

Format matters as much as size. Claude reads PDF, DOCX, RTF, ODT, TXT, EPUB, CSV, JSON, HTML, and XLSX documents plus JPEG, PNG, GIF, and WebP images. Anything else is rejected before the size check even runs.

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.

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

Megabytes are the wrong currency — tokens are. Every upload shares the model's context window with your conversation history and Claude's replies, so a document that uploads fine can still overflow the moment you ask a question.

The 500MB number is a red herring for most work. The real Claude attachment limit you hit day to day is the context window — up to 1,000,000 tokens (roughly 750,000 words) on current models such as Sonnet 5 and Opus 5, and 200K on Haiku 4.5, shared between every upload, 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 few hundred dense pages sit comfortably inside a 1M-token window, but a multi-thousand-page archive — or twenty large files at once — still overflows it, 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 750,000-word library, don't expect Claude to hold all of it at once.

Fixing a Claude upload limit error

Four causes cover almost every failure: the file exceeds the per-surface size cap, its token count overflows the context window, the format is unsupported, or the transfer dropped mid-flight. Pasting the text directly clears the marginal cases fastest.

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.

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. If the attachment dies with a vague message rather than a size complaint, our walkthrough of the "upload failed due to a network issue" error sorts out whether it's really the file, an extension, or a VPN.

How to upload large files to Claude

Three durable options when splitting is not viable: put the document in a Project so Claude retrieves the relevant slices on demand, upload it through the Files API and reference it by ID, or connect external storage through an MCP connector.

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 5 or Opus 5 session uses.

Claude pricing at a glance

Claude is free to start, $20 a month on Pro, and from $100 a month on Max. Size caps are identical on every tier; paid plans buy usage headroom and Projects rather than bigger files.

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

On the free plan specifically, the numbers are less obvious than they look — see the Claude free upload limit for what is actually capped and what is not.

Hitting an error rather than a limit? Claude file upload not working triages the format, size, stale-tab, and network causes with a fastest-fix-first checklist.