Summary
If you are having trouble uploading files or folders to Box using your web browser, Box Drive, or Box Mobile, this guide covers both quick self-service fixes and in-depth diagnostic steps.
You can match your exact error message in the Quick Diagnostic Guide below, or follow the detailed sections covering file naming restrictions, storage quotas, network firewalls, and upload performance.
- Section 1: Storage Quota Exceeded: "Uploading this will put you over your allocated space" or "Account upload limit reached"
- Section 2: Maximum File Size Limits: "File size exceeds limit" or large files fail immediately
- Section 3: Network Errors, Firewalls, and Proxy Servers: "Network Error", upload bar freezes at 99%, or "An error occurred with the upload. Please refresh the page and try again"
- Section 4: File Name, Character, and Path Restrictions: "File name not supported" or "Value must be greater than or equal to 0"
- Section 5: Uploading Empty Folders: Empty folders do not upload when using the "Folder Upload" button
- Section 6: Active and Locked Files: "File is locked" or active program errors (such as Outlook
.pstfiles) - Section 7: Potential Causes of Slow Uploads and Bandwidth: Uploads are very slow or take much longer than expected
- Section 8: Specialized Upload Methods: Email to Folder or FTP
Initial Quick Checks
Before investigating deeper technical causes, complete these standard baseline checks:
- Update your web browser: Ensure you are using the latest version of Chrome, Firefox, Safari, or Edge. Out-of-date browsers can cause upload failures.
- Clear your browser's cache: Cached files and cookies can occasionally disrupt session tokens. Clear your browser cache and cookies, restart the browser, and try uploading again.
- Confirm supported operating systems: Make sure your device runs an officially supported operating system (Windows or macOS version).
- Toggle upload method: In the Box Web App, try using the File upload button instead of Folder upload, or vice versa.
- Check your network connection to Box. If connected to the internet with a wireless card, try a wired LAN connection. Check to see if the connection to the internet drops intermittently. If this is the case, we recommend the Folder upload method.
- Try temporarily disabling or configuring your firewall to allow Box as a trusted site. You may find that your anti-virus software includes a built-in firewall that is impacting performance. If you are attempting to access Box from an office location and experience upload issues, then please contact your IT administrator or internal Help Desk.
- Proxy servers may sometimes cause failed uploads. If you see the error message: An error occurred with the upload. Please refresh the page and try again. Please contact your IT department or Help Desk and ask them to check your proxy configuration.
- Upload from a local drive instead of a network drive: If the files you are uploading reside on a mapped network drive, corporate file share, or external server, copy or drag them onto your local hard drive (such as your Desktop) first, then upload to Box. Uploading directly from a network drive introduces latency, file access locks, and connection instability that can cause uploads to stall or fail.
Section 1: Storage Quota Exceeded
The Symptom
You receive the error message: "Uploading this will put you over your allocated space" or "Action Failed: Quota Exceeded".
Why This Happens
Box calculates and deducts uploaded storage from the account that owns the target folder, not the account uploading the file. Even if your enterprise plan provides unlimited storage:
- If the user who created and owns the folder has an individual storage quota set by their Box Administrator, and that quota is reached, all uploads to that folder are blocked.
- If you own the folder, your personal quota may be full, or your Box Trash may contain deleted items that still count toward your storage total.
How to Fix It
-
If you are an End User:
- Open the folder in the Box Web App and check the Owner listed in the right-hand Sharing sidebar.
- If you are the owner, open your Trash in the left sidebar, click the More Options (...) icon, and select Empty Trash to permanently clear deleted files.
- If another user owns the folder, contact the folder owner or your internal IT Help Desk and let them know that the folder owner's Box storage quota needs to be increased.
-
If you are a Box Administrator:
- In the Admin Console, go to Users & Groups > Managed Users.
- Search for the user who owns the folder and click their profile.
- Under Edit User Account Details, review Storage Allotted. Select Unlimited (or enter a larger storage amount) and click Save.
- For full details, see Resolving Account Storage Quota Errors.
Section 2: Maximum File Size Limits
The Symptom
An individual file fails to upload, or you receive a notification stating the file exceeds the maximum size allowed for your account.
How to Check Your Account Limit
- Log into Box.
- Click your account icon or initials in the upper-right corner.
- Select Account Settings from the menu.
- On the Account tab, scroll down to Account Details and review your Max file size.
File Size Limits by Account Tier
Each Box account tier enforces a maximum ceiling on the size of any single file:
Box Account Plan |
Maximum Single File Size Limit |
|---|---|
| Free Personal | 250 MB |
| Personal Pro | 5 GB |
| Starter | 2 GB |
| Business | 5 GB |
| Business Plus | 15 GB |
| Enterprise | 50 GB |
| Enterprise Plus | 150 GB |
| Enterprise Advanced | 500 GB |
Important Rule for Shared Folders: Shared folders enforce the single file size limit of the Folder Owner's plan, regardless of the plan tier of the person uploading. For example, if an Enterprise user (50 GB limit) collaborates in a folder owned by a Free Personal account (250 MB limit), uploads to that folder cannot exceed 250 MB.
Application-Specific Upload Limits
Some Box applications enforce specific upload limits regardless of your enterprise plan:
- Box Mobile App: 15 GB
- Box Sync: 15 GB
-
Email Uploads (
u.box.com): 50 MB (total email payload, roughly 35 MB raw file size)
How to Fix It
- If your file exceeds your plan limit, compress the file into multiple zip archives, or split large media files.
- If uploading to a shared folder owned by a free account, ask an Enterprise user in your organization to create the folder instead and invite the collaborators.
Section 3: Network Errors, Firewalls, and Proxy Servers
The Symptoms
- The upload starts, but freezes partway through (frequently at 99%).
- You receive: "Network Error" or "An error occurred with the upload. Please refresh the page and try again."
Why This Happens
When uploading via a web browser, Box streams files in multi-megabyte binary chunks directly to upload.box.com. Corporate security gateways, proxy servers, and firewalls may allow standard web browsing but block or terminate continuous data uploads, especially when deep packet inspection (DPI) or SSL inspection is enabled.
Diagnostic Steps
- Compare with Box Drive: Try uploading the file using the Box Drive desktop application. If Box Drive succeeds while the web browser fails, the issue is specific to your browser or web proxy configuration.
- Test Off-Network / Mobile Hotspot: Temporarily disconnect from your corporate VPN or switch your computer to a mobile Wi-Fi hotspot. If the upload succeeds off-network, your corporate office firewall or proxy is blocking upload streams.
-
Check for Port 80 / Port 443 Non-Response: Uploads may fail even when initial preflight HTTP
OPTIONSrequests succeed. If subsequent HTTPPOSTorPUTcalls receive no response or time out, network security hardware is intercepting the upload.
How to Fix It
- Configure Firewall as Trusted: Configure third-party firewall software (such as ZoneAlarm, Windows Defender Firewall, or macOS firewall) to allow Box domains as trusted destinations.
-
Corporate Proxy and IT Configuration: Contact your IT Help Desk or network administrator to ensure proxy configurations and firewalls allow uninterrupted traffic to
*.box.com,*.boxcdn.net, and specificallyupload.box.com. Ensure SSL inspection is bypassed for upload endpoints.
Section 4: File Name, Character, and Path Restrictions
File Name Validity and Length
Check that the file name is valid. Box only supports file or folder names that are 255 characters or less. File names containing non-printable ascii, "/" or "\", names with leading or trailing spaces, and the special names “.” and “..” are also unsupported. Box supports only Unicode Basic Multilingual Plane 0 (BMP) characters in file and folder names.ters.
Reserved Characters Not Allowed
The following characters cannot be used in file or folder names on Box:
-
<(less than) -
>(greater than) -
:(colon) -
"(double quote) -
/(forward slash) -
\(backslash) -
|(vertical bar or pipe) -
?(question mark) -
*(asterisk)
Case and Accent Insensitivity
File and folder names in Box are case-insensitive (no distinction between a and A) and accent-insensitive (no distinction between a and ă). You cannot have two items named Test and tèst in the same folder, because each item name must be unique within its directory.
Invisible Formatting Characters Stripped by Box
When you upload or create an item, Box automatically strips the following invisible formatting characters from the name and saves the remaining valid characters. If a name consists solely of these characters, it is rejected because no valid characters remain:
-
U+00ADSOFT HYPHEN -
U+200BZERO WIDTH SPACE -
U+200ELEFT-TO-RIGHT MARK -
U+200FRIGHT-TO-LEFT MARK -
U+202ALEFT-TO-RIGHT EMBEDDING -
U+202BRIGHT-TO-LEFT EMBEDDING -
U+202CPOP DIRECTIONAL FORMATTING -
U+202DLEFT-TO-RIGHT OVERRIDE -
U+202ERIGHT-TO-LEFT OVERRIDE -
U+2060WORD JOINER -
U+2061FUNCTION APPLICATION -
U+2062INVISIBLE TIMES -
U+2063INVISIBLE SEPARATOR -
U+2064INVISIBLE PLUS -
U+2066LEFT-TO-RIGHT ISOLATE -
U+2067RIGHT-TO-LEFT ISOLATE -
U+2068FIRST STRONG ISOLATE -
U+2069POP DIRECTIONAL ISOLATE -
U+FEFFZERO WIDTH NO-BREAK SPACE (byte order mark)
(Note: Box does not remove U+200C ZERO WIDTH NON-JOINER or U+200D ZERO WIDTH JOINER, as those characters are required for certain languages and emoji sequences).
Windows 255-Character Path Length
Verify that the file or folder's path on Windows machines is under the 255-character Windows limitation. Folder paths that exceed 255 characters may truncate the content's name before uploading to Box.
- For example: file names will be shortened to the '8.3' convention and contain a tilde character '~':
Exampl~1.PDF
macOS AppleDouble Companion Files (.DS_STORE and ._filename)
- If you see filenames containing
.DS_STOREor starting with dot underscore as in: "._filename" this is caused by Mac OS X and is known as AppleDouble.- For an explanation how to clean each see these resources:
- https://www.techrepublic.com/article/how-to-disable-the-creation-of-dsstore-files-for-mac-users-folders/
-
https://en.wikipedia.org/wiki/AppleSingle_and_AppleDouble_formats
- AppleDouble Example: If you have a file named
MyDocument.txt, macOS might create a hidden companion file called._MyDocument.txt.
- AppleDouble Example: If you have a file named
- For an explanation how to clean each see these resources:
Invalid Timestamps ("Value must be greater than or equal to 0")
If a local file's created or modified timestamp fields are empty, corrupted, or contain negative values, Box will return the error: "Value must be greater than or equal to 0". Open the file in its native application, make a minor edit, and save it to refresh the operating system timestamps before uploading.
Section 5: Uploading Empty Folders
When you try to upload an empty folder using New Folder Upload in the Box web interface, the upload does not start and the folder isn’t uploaded. However, if you drag and drop the same empty folder into Box, it uploads successfully.
This behavior is due to limitations in most web browsers’ file selection tools. When you select an empty folder through the file picker dialog (used by "Folder Upload"), browsers usually don’t recognize it as a valid upload because there are no files inside. As a result, no data is sent to Box for processing.
Use drag & drop to move the folder into your Box window instead of using New Folder Upload.
Expected Behavior with "New Folder Upload"
When you attempt to upload an empty folder using the Folder Upload button in the web interface, the upload will not start and the empty folder is not uploaded.
Why This Happens
This behavior is caused by limitations in web browser file selection dialogs. When you select an empty folder through a standard browser picker dialog, the browser does not recognize it as a valid data upload because it contains zero files. As a result, the browser transmits no data to Box.
The Solution: Use Drag and Drop
To upload an empty folder, drag and drop the empty folder directly from your computer desktop or file explorer into the Box web browser window. Drag and drop bypasses the browser file picker limitation and successfully creates the empty folder structure in Box.
Section 6: Active and Locked Files
The Symptom
The upload fails, or your computer displays an alert stating the file is in use or locked.
Why This Happens
Programs that continuously write data, such as Microsoft Outlook holding .pst archives, CAD software, or local database files, place exclusive system locks on files while open. Box cannot read or upload files that are locked by an active process.
How to Fix It
- Save your work and close the application using the file.
- If uploading an Outlook
.pstfile, quit Outlook completely and verify in Windows Task Manager thatOUTLOOK.EXEhas terminated. - If the file must remain open in another program, create a copy of the file on your local desktop and upload the copy instead.
Section 7: Potential Causes of Slow Uploads and Bandwidth
Bandwidth and Box Processing
Box does not limit, throttle, cap, or shape upload bandwidth.
Box does perform virus scanning, thumbnail generation, and metadata indexing on each file, which can affect the total completion time when uploading large numbers of files, but this does not limit the bits per second of your network connection.
For more information, please review our Fair Use Policy.
Upload speed depends on your network connection and a component of this is bandwidth.
- Bandwidth determines the amount of data that can pass from the Internet to your web browser in a given amount of time.
- A smaller bandwidth results in a longer time that it takes Internet data to transfer on your web browser.
Box offers multiple endpoints to make sure your uploads (and downloads) are taking the most efficient route. See our announcement: Box expands its Global Network Presence
If you find that your upload is taking longer than it should, we have listed a few reasons that may affect upload speeds.
-
Firewalls: Firewalls can slow down or block the upload process. If you use third-party software, try temporarily turning off firewalls such as ZoneAlarm, the built-in Windows firewall, Mac firewall, or any others.
- Simply configuring your firewall to allow the Box domains will likely solve this issue.
- If uploads are failing even when OPTIONS calls are shown to succeed, please next check if the POST/PUT calls show a non-response on Port :80. This confirms that the actual upload attempt is being met with a non-response, and the firewall and other network configuration settings should be reviewed to find where this is failing.
-
Business network restrictions: Users accessing Box from an office setting may find that their IT department has blocked or slowed down connections to Box. VPNs can be the cause of slower connections.
- If you are unsure whether your IT department has placed restrictions on uploads or unapproved websites, you can try connecting to Box from a different location, such as a coffee shop with Wi-Fi, to see if the issue persists. If the issue does not persist, then it is likely that your IT department has placed restrictions on Box.
- If you're using a VPN, your IP address may be misplaced, which can inadvertently put your computer in a different geographic location from your actual location. This can affect your upload speeds. Check with your network or IT department to see if a VPN is causing your computer to be placed in a different geographic location on the internet.
- Browser Specific Issues: If you're having trouble uploading files to Box, try using a different browser or computer. Some users find that their upload speeds increase when using a different browser or a faster computer..
-
Device Specific Issues: If your upload speed has not improved after trying different browsers and updating your browser, try using a different computer to isolate the issue.
- If your upload speed increases on another computer, then the first computer is causing the slow speed.
- If your speed does not increase, then it is likely an issue with your internet connection.
-
Internet Service Provider: Sometimes slow upload speeds are the fault of your Internet Service Provider.
- We recommend a high-speed internet connection with high upload speeds. Fiber is best, followed by Cable and DSL.
- Often with Cable and DSL, the upload speed is significantly slower than the download speed. This will result in fast loading times for most websites and file downloads, but slow uploads.
A Note on Megabytes vs. Megabits:
There is a difference between “Mb” (megabit) and “MB” (megabyte). One megabyte is equal to eight megabits. Internet service providers (ISP) advertise upload and download speeds in terms of “Mbps” (megabits per second) while Box uploads are shown in your browser in terms of "MBps" (MegaBytes per second). So, if you see browser upload speeds of 15 MBps this would be interpreted as 125 Mbps by your ISP.
Section 8: Specialized Upload Methods
If you use automated or protocol-specific upload tools:
-
Email Upload to a Folder (
u.box.com):- You can email attachments directly to a folder address formatted as
upload.<folder>.<token>@u.box.com. - Total message size (email body plus all attachments) cannot exceed 50 MB (approximately 35 MB on disk before email encoding).
- In Folder Settings, verify whether Allow uploads from anyone is enabled, or ensure the sending address is invited as a collaborator.
- If using the Email Upload feature, then please review these for help:
- You can email attachments directly to a folder address formatted as
-
FTP and FTPS:
- FTP access is supported on Business, Business Plus, and Enterprise accounts.
- Use passive mode (PASV) and explicit FTPS on port 21. Single file size limits match your account plan ceiling.