Skip to main content

Fixing Claude's 'File Limit Exceeded' Error: Upload Limits and How to Fix Them

When Claude blocks a file upload, it's almost always one of three limits — file count, file size, or total context. Here's the official numbers and a fix for each.

ByUpdated
🌐 This article was machine-translated and may contain inaccuracies. Read the Korean original if in doubt.

💬 1 copy-ready prompt in this article →

If Claude suddenly refuses to accept more files and shows a "file limit" style error, the cause is almost always one of three separate limits — how many files you attached, how large a single file is, or how much total content Claude can process at once. This guide walks through the official numbers from Claude's support documentation and matches each cause to a fix, so you can get back to work in a few minutes.

🟢 Model references match the current lineup · model notice · Fable subscription
🟢 Model references match the current lineup · Claude Opus 5.5 / Claude Sonnet 5 / Claude Haiku 4.5 (higher tier: Claude Fable 5.1). This notice changes only when Anthropic ships a new model.

Fable 5 and 5.1 subscription (updated September 7, 2026): Claude Fable 5.1, released September 1, 2026, is the current Fable model and Fable 5 is now legacy. Plan terms are the same for both — Max and Team Premium plans include Fable at up to 50% of the weekly usage limit; Pro and Team Standard use usage credits (

🟢 Model references match the current lineup · Claude Opus 5.5 / Claude Sonnet 5 / Claude Haiku 4.5 (higher tier: Claude Fable 5.1). This notice changes only when Anthropic ships a new model.
0/M input, $50/M output tokens). The one-time
🟢 Model references match the current lineup · Claude Opus 5.5 / Claude Sonnet 5 / Claude Haiku 4.5 (higher tier: Claude Fable 5.1). This notice changes only when Anthropic ships a new model.
00 credit applied only to the Fable 5 transition and is not offered for 5.1. Some coding and debugging requests may be answered by an Opus model due to a security classifier (both models). See the Fable 5.1 guide and the Fable 5 availability guide for details.

Chat upload File count: up to 20 Size per file: up to 500MB PDF: up to 1000 pages 100 pages or fewer: visuals analyzed too 101-1000 pages: text only Project upload File count: unlimited* Size per file: up to 30MB Processing: text extraction mainly *Total content must fit the context window

What does the "file limit exceeded" error actually mean?

In short, this error isn't one single limit — it's a signal that you've hit one of three different caps. Claude applies separate file count and size limits to chats and to Projects — workspaces that group related conversations and let you pre-load reference files — and on top of that, there's a context window, the total amount of text Claude can read at once. Any one of these three can block your upload or your message, so the first step is figuring out exactly which one you tripped.

Before you start

  • A Claude account — the file upload limits below apply the same way whether you're on Free or a paid plan (Pro/Max)
  • Access to claude.ai in a browser, or the Claude app, while signed in
  • The files you want to upload, with their format and size already checked (right-click a file → Properties/Get Info to see its size)

Quick terms to know

  • Projects — a workspace that groups multiple conversations and reference files together, so you don't have to re-upload the same files in every chat.
  • Context window — the total amount of text Claude can "keep in mind" at once. Uploaded file content, your conversation history, and Claude's replies all share this same budget.
  • Token — the unit Claude uses to count text, instead of characters. A file's size in MB and its token count aren't the same thing — a text-dense PDF can use more tokens than a larger, image-heavy one.
  • RAG (Retrieval-Augmented Generation) — instead of loading an entire knowledge base at once, Claude retrieves only the relevant parts when needed. Projects switch to this mode automatically as their content approaches the context limit.

Diagnose the cause first

Before you can fix the error, figure out which of the three limits you hit. Follow the flow below.

File won't upload ① File count exceeded More than 20 attached ② File size exceeded Over 500MB (chat) / 30MB (Project) ③ Context overflow Count & size are fine, length-limit message Fix Split chats or use a Project Fix Split or compress, then retry Fix Use a Project (RAG) or start a new chat

Chat uploads and Project uploads have different limits

Where you upload a file inside Claude changes which limit applies. According to Claude's official "Upload files to Claude" documentation, chat and Project uploads follow different caps.

CategoryChat uploadProject upload
Number of filesUp to 20 per chatUnlimited (but total content must fit the context window)
Size per fileUp to 500MBUp to 30MB
Image resolutionUp to 8000×8000 pixels-
PDF pagesUp to 1000 pages (100 or fewer: text + visuals analyzed; 101-1000: text only)Same PDF rules apply
ProcessingAnalyzes text and visual elementsText extraction only (except multimodal PDFs)

Supported file types are the same for chat and Projects: documents — PDF, DOCX, CSV, TXT, HTML, ODT, RTF, EPUB, JSON, XLSX; images — JPEG, PNG, GIF, WebP. Note that XLSX (Excel) files require enabling code execution in your account settings first — if a spreadsheet upload fails, check that setting.

Fixes, matched to each cause

  1. Over the 20-file count — split across conversations. Keep only the files you actually need in one chat, and move the rest to a separate conversation, or register shared reference material in a Project so you can keep referring to it without re-hitting the 20-file cap each time.
  2. A single file is over the size limit (500MB chat / 30MB Project) — split or compress it. Most PDF viewers and tools can split a document into smaller sections so you only upload the part you need, and compression tools can shrink image-heavy PDFs. Caution: if compression turns text into images, Claude may no longer be able to read it — double-check that text extraction still works after compressing.
  3. Count and size are fine but you see a "message will exceed the length limit" error — that's context overflow. The combined content of your attached files exceeds what Claude can process at once. Paste only the relevant text directly instead of the whole file, or move the material into a Project. On paid plans (Pro, Max, Team, Enterprise), Projects automatically switch to RAG mode as content grows, expanding usable knowledge capacity by up to 10x.
  4. Still stuck — start a new conversation. A long chat history itself takes up context space. The same files that failed in an old, long conversation sometimes upload fine in a fresh one.

You'll know it worked when the file appears in your attachment list and the send button becomes active. If the error persists, re-read the exact error text and work back through the three causes above.

Does this differ by plan (Free, Pro, Max, Team)?

The file upload count and size limits themselves are the same regardless of plan. Claude's official documentation doesn't list separate chat/Project file limits for Free versus paid plans — it's 20 files/500MB for chat and unlimited files/30MB for Projects either way. What does differ by plan is related, but separate:

  • Number of Projects — Free accounts can create up to five Projects. Paid plans have no such cap.
  • RAG-expanded knowledge capacity — the up-to-10x expansion described above is only available on paid plans (Pro, Max, Team, Enterprise). On Free, Project knowledge can hit the context limit without that expansion kicking in.
  • Sharing Projects — Team and Enterprise plans can share a Project with other members of an organization.

In other words, "how big can one file be" is identical across plans, but "how much material can I comfortably keep in a Project" has more headroom on paid plans.

Common sticking points: the exact error messages and what to do

SymptomCauseFix
New files stop attachingThe chat already has 20 files attachedRemove unneeded files, or move to a new chat/Project
One specific file is rejected instantlyThat file exceeds the size limit (500MB chat, 30MB Project)Split or compress the file, then retry
"Your message will exceed the length limit for this chat. Try attaching fewer or smaller files or starting a new conversation."Combined content of attached files exceeds the context windowAttach fewer files, paste only needed text, or start a new chat
A PDF over 1000 pages won't attach at allPDFs are supported only up to 1000 pagesSplit the PDF into multiple files

Next step: if your files keep piling up

If you're repeatedly uploading the same kind of reference material across multiple chats, it's worth consolidating that material into a single Project instead. Once it's registered there, you don't need to re-attach it every conversation, and on a paid plan, RAG mode means you can keep adding more material while Claude automatically retrieves only what's relevant. For the full picture on usage limits by plan, see Claude's usage limits guide.

Frequently asked questions

Q. How many files can I attach to a single chat?
Up to 20, per Claude's official documentation. Trying to attach more will fail or trigger an error.

Q. Does the file size limit vary by plan?
No — chat uploads are capped at 500MB per file and Project uploads at 30MB per file, the same on Free and paid plans. What is plan-specific is the ability to expand Project knowledge capacity by up to 10x via RAG, which is limited to paid plans.

Q. How many pages can a PDF have?
Up to 1000 pages. Claude analyzes both text and visuals for PDFs of 100 pages or fewer, and text only for 101-1000 pages.

Q. File count and size look fine, so why does it keep failing?
You've likely hit context overflow — the combined content of your files exceeds Claude's context window, the total text it can process at once. Try attaching fewer files, moving them into a Project, or starting a new conversation.

💬 Prompts for this problem

Copy, paste into Claude, and swap the parenthesised bits for your own situation.

  • 파일이 너무 커서 안 올라가, 나눠서 할 계획 짜줘

    Use when: 파일 제한 초과가 떠서 나눠 올려야 할 때

    클로드에 자료를 올리려는데 파일 제한에 걸렸어. 200페이지짜리 PDF 한 건이고, 전체 내용을 요약하는 게 목적이야. (여기를 네 자료로)
    
    내용이 끊기지 않게 나눠 처리할 계획을 세워줘. 어떤 기준으로 자르면 좋을지 내 자료에 맞게 제안해주고, 각 조각에 넣을 지시문과 마지막에 합칠 때 쓸 지시문을 그대로 쓸 수 있게 써줘.

All prompts →

Was this helpful?

Keep reading