Skip to main content

File path errors when unzipping files on Windows

Written by Philip MacDonald
Updated over 2 weeks ago

The intended audience for this article is Agents.

If you see a file path error when unzipping a download from Wunderite, such as a Bulk Data Download or a Forms Download, this usually comes from limitations in Windows’ built-in unzip tool. The native Windows extractor can fail when:

  • Filenames or folder paths exceed the 260 character limit

  • Folder structures are deeply nested (including folders already on your computer)

  • Filenames contain special characters

  • The file uses older or inconsistent encoding

  • The ZIP is very large (larger than 4 GB or has more than 65,000 files)

What you can try

  • Extract the zip file with Winzip, WinRAR, or 7-Zip. These tools handle long filenames and nested folders more reliably. You may need your agency’s IT team to install one of these tools.

  • If the error appears while downloading a form from Wunderite, try renaming the form in Wunderite before downloading it. Shorter names reduce the final file path length.

  • If your agency uses Windows 10 (version 1607 or later) or Windows 11, your IT administrator can enable support for long file paths. This removes the old 260 character limit and often resolves unzip issues. See Microsoft's help article to enable long file path names.

Why we don’t simply truncate paths to 260 characters?

While Windows historically enforces a 260-character path limit, we don’t blindly truncate filenames to fit this limit because:

  • The limit applies to the full path, not just the filename—so truncating names alone doesn’t reliably prevent errors.

    • full path example: C:\Users\JohnDoe\Downloads\Wunderite\Exports\2026\April\Very-Long-Client-Name\Subfolder\Another-Subfolder\customer-report-2026-01-01-west-region-final-version.xlsx

  • Not all systems have this limit (modern Windows, macOS, Linux), so truncation would unnecessarily alter filenames for most users.

  • Naive truncation can cause conflicts, where different files end up with identical shortened names.

  • ZIP files themselves don’t enforce this limit—issues only arise during extraction in certain environments.

Instead of applying lossy, one-size-fits-all truncation, we preserve original file paths and rely on the extraction environment to handle limits appropriately.

Did this answer your question?