Skip to main content

Zip upload troubleshooting

Sjaak Velthoven avatar
Written by Sjaak Velthoven
Updated over a week ago

In this article you will find information about the errors that can occur when uploading a zip / file structure.

This article contains information about the following topics:

Upload failed

It is recommended to use a wired connection for uploading the zips to Catenda.

Many wifi routers do a great job at making sure they receive the right data, but even the best routers can struggle with a weak signal if you are far away from the router.

Unable to process file

During the zip upload process packets of data are being sent to the Catenda server.

If there is a problem with any of the packets during the process the following message is displayed:

Failed to upload! Unable to process file.

Even when right next to a WiFi antenna with a device it is never 100% sure the packet will arrive safely through the air.

This effect is amplified by being further away from the antenna or if there are objects like walls between the device and the antenna.

Large files

When large amounts of data are being uploaded many packets are being sent.

If even one of them does not arrive to the router through the air properly a network error can appear.

When this happens the entire upload will be invalid.

Network error

Certain software limit the amount of characters that paths to files in a zip file can have.

If there is a problem with the path structure in the zip file the following error will appear:

Failed to upload! Network error.

Unzip/Rezip

If this zip was received from someone else it can help unzipping it and rezipping it.

Known limits (updated December 2025)

Microsoft Windows 10/11

The limit in Windows is 260 characters but can be increased.

Access required: Windows Administrator account

Windows Home users:

This limit can be increased by going to Windows Start and typing REGEDIT

Open the Registry Editor and navigato to:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem

Doubleclick LongPathsEnabled and change the value to 1.

If it is not there, rightclick the FileSystem key and choose

New > DWORD (32-bit) Value

Name the new value LongPathsEnabled with a value of 1.

Windows Pro users

This limit can be increased by going to Windows Start and typing gpedit.msc

Open Edit Group Policy and navigato to:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem

Double click on Enable Win32 long paths and enable it.

OneDrive and SharePoint

400 Unicode code units


Robust uploads

Smaller zips

If the zip consists of multiple files, the zip can be split into smaller zips.
Each separated zip can be uploaded individually but there will always be a risk of a network or connection error.

Individual files

The Catenda Desktop Connector is a safer way to upload as it uploads documents file for file.

This is also faster as the files are uploaded directly to our backend rather than through the browser interface.

Even if one of the files fails, the ones uploaded until then will already appear on Catenda.

The rest of the files will continue uploading the next time the upload task runs.

Zip uploads with special characters

Catenda detects the encoding of the zip file when it gets extracted so if the zip has special characters in it they will be interpreted properly when extracted. If the special characters were not encoded properly they will not be extractable by Catenda and will end up looking garbled.

Depending on the service you use for creating your zip file your characters may or may not be encoded correctly.

If your special characters are garbled please look in the zip to see if they look right there.

If you think your characters were encoded properly and are not properly being extracted by Catenda we are happy to have a look at your zip file and see if there is anything we can do. In this case please contact support@catenda.com with the details of how you created your zip file.

Zip encoding on Windows

Different versions of Windows use different zip encodings.

For example the English version uses the encoding standard IBM-437 and the pt-BR version uses IBM-850. If your Windows installation does not encode your zip files properly you might have more luck using a third party service like 7zip or WinRAR to create your zip files with the right encoding.

Completed but nothing happened

Even though a zip import completes it there can be several reasons for no change to be visible in the documents table.

This is what it can look like when a zip import has completed without changes being made.

This is what the right menu of the zip import page can look like in this situation:


Skipped folders

If a folder with the same name as a folder in the zip already exists in the location that the where a folder is attempted to be extracted the creation of the folder will be skipped and no new folder will be created.

Any documents within the folder with the same name as on Catenda will be uploaded to the existing folder in the Catenda project.

Skipped files

If the skip and continue option was chosen in the zip upload dialogue and a document with the same name as the file that is attempted to be uploaded from the zip file already exists it will be skipped and the next file will start extracting.

Missing documents

If documents are listed under missing documents this means that the documents were successfully created but cannot be viewed.

The documents that the files were uploaded to can since have been removed.

It could also be that the uploader no longer has access to the documents that the files were uploaded to.

Access required: Read access

Harmful filetypes

When a file in the zip file has a potentially harmful filetype they will not be uploaded.
This is what the zip import page can look like when harmful filetypes are attempted to be uploaded:

This is what the right menu on the zip import page can look like when a harmfull file is attempted to beuploaded:


​The following filtypes which can potentially be harmful are not allowed.

Harmful formats

Extensions

Comments

Scripts

php

Windows executables

exe

Windows installer packages

msi

Batch scripts

bat

Command scripts

cmd

DOS executables

com

Screensaver executables

scr

PowerShell scripts

ps1

Windows shortcuts

lnk

Clicking a downloaded link could link to an executable without looking like an executable.

Java executable files

jar

Insufficient access

The right access is required for the zip contents to be extracted.

Access required: Write access

This is what the zip import page can look like when there is not enough access:

This is what the right menu on the zip import page can look like when there is not enough access:

Did this answer your question?