The HubSpot file upload size limit depends on the tool. The files tool takes up to 20 MB per file on accounts with only the free tools and up to 2 GB on accounts with a subscription. One-to-one emails allow 20MB combined, documents 250 MB, customer portals 50MB and chat visitors 10 MB.
There's no single number
Here's the situation I see most often. Someone uploads a big video or brochure to the HubSpot file manager without trouble, then tries to attach the same file to an email and it won't go. That's not a bug. HubSpot sets a different size cap for each place you can put a file.
| Item | Limit | Applies to |
|---|---|---|
| Files tool | 20 MB per file | Accounts with only HubSpot's free tools (as of Nov 2026) |
| Files tool | 2 GB per file | Accounts with a subscription |
| Documents | 250 MB | Trackable sales documents |
| One-to-one email attachments | 20MB total, all files combined | Sales emails and conversations inbox emails |
| Chat widget files | 25 MB to visitor, 10 MB from visitor | Chat widget |
| Customer portal attachments | 50MB | Customer portal |
All of these come from HubSpot's Knowledge Base article on supported file types.
What happens near and over each cap
On accounts with a subscription, the files tool allows up to 2 GB per file, but HubSpot warns that files of 1 GB or more may cause upload issues. If a large upload keeps stalling, compress it or split it before you try again.
Email is where people get caught. The 20MB limit on one-to-one emails is for all attachments combined, not per file. Two 12 MB PDFs won't go together, even though each one alone would. The simple fix is to upload the file to the files tool or the documents tool and send a link instead.
Chat has two numbers because it runs in two directions. You can send a visitor files up to 25 MB, but a visitor can only send you files up to 10 MB. If a customer needs to send you something bigger, a customer portal takes 50MB.
One file, four different answers
Think of a 100 MB product video. It uploads to the files tool without a problem on a subscription account. It won't fit in a one-to-one email, which caps everything at 20MB combined. A visitor can't send it through chat, where the cap is 10 MB. And it's too big for a customer portal at 50MB. HubSpot's supported file types page lists each of those limits separately, and that's the reason the same file behaves so differently depending on where you put it.
Files HubSpot blocks or advises against
Executable file types are blocked from upload, including sh, bat, com, elf, bin, exe, jar, rpm and deb. The page doesn't list zip as blocked for the files tool.
HubSpot also says it's generally not recommended to host or render HTML or JavaScript files in the file manager. Upload them for storage or sharing, but don't expect to run a page from there.
If you use Breeze Assistant, uploads are limited to 10 files per thread, with a combined size cap per thread. My guide to HubSpot's Breeze Assistant covers what it can do with those files.
Uploading through the API
The files API takes uploads as a multipart/form-data POST request to files/v3/files, and HubSpot's developer docs say those uploads follow the same limits and formats as the Knowledge Base article. There's also an optional ttl setting from 1 day to 1 year, after which the file is deleted, which is handy for temporary shares.
Want AI doing the heavy lifting in your marketing?
I build the systems that handle the boring 80 percent, so you get your week back. Done properly, with the human kept in.
How other business tools compare
Slack lets members and guests add files up to 1GB. Zendesk limits outbound email attachments to 7 MB per file and sends larger ones as linked attachments. Notion's help page says uploads on its Free Plan are up to 5MB each as of Nov 2026, and up to 5GB each on higher plans.
My advice for anyone sending big files from HubSpot
Stop attaching and start linking. Put large files in the files tool or the documents tool, then share a link in your email or chat. You'll stay clear of the combined attachment cap, and with documents you get the tracking too. If you're setting up a new account, add this to your HubSpot setup checklist so the whole team works the same way.
Want your tool on this list? Featured spots and reviews here are paid partnerships. Here's how to partner with me.
Frequently asked questions
What is the HubSpot file upload limit?
For the files tool, 20 MB per file on accounts with only the free tools and 2 GB per file on accounts with a subscription.
How big can an email attachment be?
20MB total for all attached files combined on one-to-one and conversations inbox emails.
How large can a document be?
The documents tool allows 250 MB.
Can I upload an exe or zip file?
Executable types like exe, bat and sh are blocked. The page doesn't list zip as blocked for the files tool.
Do the same limits apply to the API?
Yes. HubSpot's files API says uploads follow the same limits and formats as the Knowledge Base article.
