Extract ArchiveInstall

Summary

Extract ZIP or RAR archives from either a binary input or a file path, returning the extracted files as workflow items or saving them to disk with options for filtering and folder structure preservation.

Inputs

• Input Mode (required) — Select whether to extract an archive from binary data passed from a previous node or from a file path on the server.
• Input Binary Field (required) — The binary property name containing the archive file when using binary input mode.
• File Path (required) — Full path to the archive file on the server when using file path input mode.
• Archive Type (required) — Specify the archive type (ZIP, RAR, or auto-detect based on file extension/content). Defaults to auto-detect.
• Password — Password for encrypted archives, if applicable.
• Output Mode (required) — Choose to output extracted files as multiple items (one per file) or as a single item containing all files as separate binary properties.
• Output Binary Field (required) — Name of the binary property used for output files when not saving to disk. In single output mode with multiple files, files are named with indices (e.g., file_1, file_2).
• Save to Disk (required) — Option to save extracted files directly to a specified directory on the server instead of returning binary data. Only metadata is returned in this mode.
• Output Directory (required) — The server directory where extracted files will be saved when saving to disk.
• Create Subdirectory from Archive Name (required) — Whether to create a subdirectory named after the archive file inside the output directory when saving to disk.
• Keep Folder Structure (required) — Whether to preserve the original folder structure from the archive in the output directory or flatten files into a single directory.
• Recursive Extract (required) — If enabled, recursively extracts nested ZIP archives inside the extracted files until none remain.
• Include Subdirectories (required) — Whether to include files from subdirectories in the output when returning extracted files.
• File Filter — Comma-separated list of filename patterns to extract (e.g., '*.txt, *.pdf'). If empty, all files are extracted.

Output shape

multiple items or a single item with multiple binary properties, or metadata-only items when saving files to disk

In multiple output mode, each extracted file is a separate workflow item with its binary data or metadata if saving to disk. In single output mode, one item contains all extracted files as separate binary properties or metadata. When 'Save to Disk' is enabled, only file metadata including paths, sizes, and names is returned. Supports filtering files by patterns and options to keep folder structures or flatten extraction.

Links

• n8n community nodes installation guide