Unzip

An Unzip node extracts the files inside each incoming ZIP archive and passes on the extracted files. Use it to unpack the archives partners send before routing, converting, or delivering the files inside them, in the same run.

Unzip accepts only file items, because it reads an archive's contents.

Settings

The node takes an optional destination path with the same tokens and templates as every destination. With no destination, the files are extracted into the archive's own folder. The overwrite setting is off by default, so an extracted file whose path already exists fails with processing-failure/destination-exists instead of replacing the existing file.

What the Next Node Receives

Unzip passes on one file item for each extracted file, so a run that receives one archive with 30 files continues with 30 items. The archive itself is unchanged.

Errors

A file that is not a ZIP archive fails that item. Error Handling rules on the node determine what happens to a failed item.

Unzip vs. Automatically Unzip Files

Automatically Unzip Files is a Folder Setting that extracts every archive uploaded to or copied into a folder, writing the files to a subfolder, without an Automation. Use it when every archive in a folder is unpacked the same way and nothing else happens to the files. Use an Unzip node when the extracted files are routed, converted, or delivered by the nodes that follow.