Understanding the Claude upload limit is essential if you regularly work with documents, images, or datasets inside AI tools. Whether you’re using Claude.ai for research, coding, or analysis, knowing the Claude file upload limit helps you avoid errors and work more efficiently.
This guide breaks down the Claude file size limit, the number of files allowed, supported formats, and how to handle large uploads without hitting those limits.
Claude Upload Limit at a Glance (Quick Reference)
Here is a simple overview of the Claude upload limit:
- Max file size: 30MB per file
- File count: 20 files per conversation
- Image limit: Up to 8,000 × 8,000 pixels
- Context window: Up to 200,000 tokens (plan dependent)
These limits apply mainly to the chat interface, but they change slightly when using advanced features like projects or APIs.
Chat Interface Upload Limits
30MB Per File = What That Means in Practice
The standard Claude Max file size is 30MB per file. This applies to PDFs, DOCX, TXT, CSV, and images.
In real-world terms:
- A PDF of 50–100 pages usually fits within this Claude file size limit
- High-resolution images may hit the limit faster
- Large datasets may need splitting
If your file exceeds the Claude upload size limit, you will get an upload error immediately.
20 Files Per Conversation Maximum
Another key Claude upload restriction is the limit of 20 files per conversation.
If you’re wondering how many files you can upload to Claude, the answer is:
- Up to 20 files per chat session
- You must start a new conversation after that
This is one of the most common limits users hit during heavy workflows.
Image Upload Limits (8,000 × 8,000 Pixels)
For images:
- Maximum resolution: 8,000 × 8,000 pixels
- Formats: JPEG, PNG, GIF, WebP
The Claude image upload limit ensures that images remain processable within the context window.
Claude Projects Upload Limits (Pro and Team Plans)
With Claude projects, limits are more flexible but still structured.
Unlimited Files in Project Knowledge Base
Inside projects:
- You can upload many files to build a knowledge base
- No strict 20-file cap like chat
However, this does not mean unlimited processing at once.
Same 30MB Per File Cap Applies
Even in projects, the Claude Max file size per upload remains 30MB.
Total Content Must Fit Within Context Window
The real constraint becomes the context window, not storage.
This means:
- Only a portion of your files can be actively used at once
- Large projects must be structured carefully
Claude Files API Upload Limits (Developers)
Developers using the Claude Files API get significantly higher limits.
Up to 500MB Per File (Claude Docs)
The Claude files api upload limit allows:
- Up to 500MB per file via documentation-supported endpoints
Up to 5GB Default / 10GB Enterprise (API)
Depending on your setup:
- Default API limit: ~5GB
- Enterprise setups: up to 10GB
100GB Workspace Storage Per Organization
Organizations can store:
- Up to 100GB total workspace data
This makes the API ideal for large-scale workflows.
Supported File Formats for Claude Uploads
Document Formats
Claude supports a wide range of formats:
- DOCX
- TXT
- CSV
- HTML
- JSON
- RTF
- EPUB
- ODT
These formats work well within the Claude document upload limit.
Image Formats
Supported image formats include:
- JPEG
- PNG
- GIF
- WebP
These fall under the Claude image upload limit size rules.
Code Files Treated as Plain Text
Files like:
- .py
- .js
- .html
- .css
are treated as text for the Claude AI upload limit.
How to Upload Excel (XLSX) Files
XLSX files are not directly supported in all cases.
Workarounds:
- Convert to CSV
- Use analysis tools
The Real Bottleneck: Context Window, Not File Size
200,000-Token Context Window Explained
Even if you stay within the Claude file upload limit, the real constraint is the context window.
- Free plan: ~100K tokens
- Pro/Team: up to 200K tokens
This determines how much data Claude can actually process at once.
How File Types Affect Token Usage
Different files consume tokens differently:
- Text-heavy PDFs → high token usage
- Images → processed separately
- CSV files → efficient for structured data
PDFs: Under 100 Pages for Best Results
For Claude, the PDF upload limit is pages:
- Under 100 pages allows full multimodal analysis
- Larger files may be partially processed
Claude Upload Limits by Plan: Free vs Pro vs Team vs Enterprise
Here is how the Claude upload limit free vs pro compares:
- Free plan:
- Smaller context window
- Same 30MB file limit
- Pro plan:
- Larger context window
- Better performance with multiple files
- Team/Enterprise:
- Shared knowledge base
- API access for large uploads
How to Work With Files Larger Than Claude’s Upload Limit
If you hit the Claude 30mb file limit, here are practical solutions:
Split Large Files Into Smaller Parts
Break large PDFs or datasets into smaller chunks.
Convert XLSX to CSV
CSV files are lighter and easier to process.
Use the Files API
The Claude files api 500mb limit allows much larger uploads.
Host Files Externally
Use links or integrations like MCP to reference large files without uploading them.
Common Upload Errors and How to Fix Them
Here are common issues related to the Claude upload limit:
- File too large error → Compress or split file
- Too many files uploaded → Start a new conversation
- Unsupported format → Convert to PDF, TXT, or CSV
- Processing incomplete → Reduce file size or pages
Understanding these errors helps you stay within the Claude upload restrictions.
Frequently Asked Questions About Claude Upload Limits
- What is the Claude upload limit per file?
The Claude Max file size is 30MB per file in the chat interface. - How many files can you upload to Claude?
You can upload up to 20 files per conversation. - Does Claude support PDF uploads?
Yes, but the Claude PDF upload limit works best under 100 pages for full analysis. - Can I upload large files to Claude?
Yes, by splitting files or using the Files API for larger uploads. - What file formats does Claude accept?
Claude supports PDF, DOCX, TXT, CSV, JSON, HTML, and common image formats.
