Skip to main content

Resolving Unzip Errors When Exporting Folders or Cabinets (Using 7-Zip)

Why you may see errors extracting an exported .zip file on Windows, and a step-by-step guide to extracting successfully using 7-Zip.

C
Written by Casey Huxtable

Required Roles: N/A

Required Permissions: Folder or Cabinet export permissions

When you export a folder or cabinet from Kivo, the resulting .zip file preserves the full folder and document structure — including nested folders and long document names. On Windows, the built-in File Explorer unzip tool enforces a strict path length limit (historically 260 characters), which can cause extraction to fail part-way through or throw an error like "The file name(s) would be too long for the destination folder."

This article explains why that happens and walks through the recommended workaround: extracting the archive using 7-Zip, a free, widely-used archive utility that handles long paths correctly.


Overview

Kivo's folder and cabinet export preserves the document hierarchy exactly as it exists in the system. For organizations with deep folder structures or long document names, the combined path length of individual files inside the .zip can exceed the Windows default path limit, causing the built-in extractor to fail.

Key things to know:

  • The .zip file itself is valid — the limitation is in the Windows File Explorer extraction tool, not in the archive.

  • 7-Zip bypasses the Windows path length limitation and can extract the archive in full.

  • No changes to your Kivo configuration or export settings are required.


Extracting Your Export with 7-Zip

Follow these steps to download, install, and use 7-Zip to extract your Kivo export.

Step 1 – Download and Install 7-Zip

  1. Download the installer that matches your system (most modern Windows PCs are 64-bit — choose the 64-bit x64 .exe).

  2. Run the installer and accept the default installation location.

  3. If your organization restricts software installation, contact your IT team — 7-Zip is free, open-source, and commonly approved for enterprise use.

Step 2 – Locate Your Exported .zip File

  1. Find the .zip file you downloaded from Kivo (typically in your Downloads folder).

  2. Move the .zip file as close to the root of your drive as possible (for example, C:\KivoExport\). Shorter destination paths reduce the chance of hitting any residual path length issues.

Step 3 – Extract with 7-Zip

  1. Right-click the .zip file.

  2. Hover over 7-Zip in the context menu.

  3. Select Extract to "[filename]\" to extract the contents into a new folder with the same name as the archive.

  4. Wait for 7-Zip to complete the extraction. A progress window will appear; larger exports may take several minutes.

  5. When the window closes, open the extracted folder to confirm that all files and subfolders are present.


Alternative Extraction Options

If the standard right-click extraction does not work, or if you prefer a different workflow, consider these alternatives:

  • Option A – Extract to a Custom Location: Right-click the .zip, choose 7-Zip → Extract files…, and specify a short destination path such as C:\Export\. This is useful when your default Downloads folder path is already long.

  • Option B – Open the Archive and Drag Files Out: Double-click the .zip to open it in 7-Zip File Manager, then drag individual folders or files to a destination on disk. This is helpful when you only need a subset of the export.

  • Option C – Use the 7-Zip Command Line: For advanced users or scripted workflows, run 7z x "C:\KivoExport\export.zip" -o"C:\KivoExport\Extracted" from a command prompt to extract the full archive.


Notes and Important Behavior

  • Permissions: Installing 7-Zip typically requires local administrator rights on the machine. Extraction itself does not require admin rights once 7-Zip is installed.

  • Why this happens: The issue is caused by the Windows MAX_PATH limitation (260 characters) in the built-in File Explorer unzip tool, combined with deeply nested folder structures or long document names in the exported archive.

  • Mac and Linux users: This path length limitation does not affect macOS or Linux. The built-in extraction tools on those systems will handle Kivo exports without issue.

  • Alternative tools: WinRAR and other modern archive utilities also support long paths and will work as an alternative to 7-Zip if your organization already has one of them approved.


Completing the Extraction

Once the extraction completes successfully:

  • Verify: Open the extracted folder and spot-check that subfolders and documents are present and match the original folder or cabinet structure in Kivo.

  • Save: Move the extracted folder to its permanent location (for example, a network share or archive drive).

  • Clean up: You can safely delete the original .zip file once you have confirmed the extraction is complete and correct.

  • Document: If the export is being retained for compliance or validation purposes, record the extraction date and destination path in your internal tracking system.


Related Articles and Next Steps

Still running into issues extracting your export? Reach out via the messenger icon in the bottom-right of your screen or email [email protected] and we'll help you get unblocked.

Did this answer your question?