File - ZIP Create

Type identifier: file:zip:create Category: File Operations

Description

The File - ZIP Create node builds a ZIP archive from file entries, with size and count limits. Entries can be grouped by folder, provided as flat folder/file rows, or placed as bare file entries at the archive root; the archive name can be a static string or a single-line template resolved at process time.

Input Handles

Handle	Type	Description
`trigger`	control	Triggers the creation process.
`entries`	`zipEntry[]`	File entries to include in the archive.

An entry is one of:

Grouped: { folder: string, files: file | file[] } — one folder with one or more files
Flat: { folder: string, file: file } — one folder + one file per row (for example, from a list:map node)
Top-level: a bare file entry — placed at the root of the ZIP

Output Handles

Handle	Type	Description
`file`	`file`	The created ZIP archive.
`success`	control	Triggered when creation completes successfully.
`error`	control	Triggered when creation fails.

Configuration Options

Option	Type	Default	Description
ZIP File Name	`string` \| template	`archive.zip`	Static name, or a single-line template (for example, with the built-in `now` variable). Max 255 chars; invalid filesystem characters are rejected.
ZIP File Name Variables	`string[]`	`[]`	Custom template variables resolved via wired data handles. The built-in `now` variable does not need to be listed.
Max Total Uncompressed Size	`number`	-	Total uncompressed size limit in bytes. Maximum allowed: 10 GB.

Limits

Check	Limit	Description
Max files	5000	Maximum number of files in archive
Max uncompressed size	10 GB	Total uncompressed size limit
Processing time	5 minutes	Maximum time to create the archive

Examples

Static Archive Name

Configuration:

ZIP File Name: report.zip

Use case: Bundle a fixed set of generated files under one name.

Templated Archive Name

Configuration:

ZIP File Name: export-{ now | date("YYYY-MM-DD") }.zip

Use case: Daily exports with a date-stamped archive name.

Grouped Entries

Input entries:

[{ "folder": "invoices", "files": ["inv-1.pdf", "inv-2.pdf"] }, "readme.txt"]

Result: invoices/inv-1.pdf, invoices/inv-2.pdf, and readme.txt at the root.

File - ZIP Extract

The File - ZIP Extract node extracts files from a ZIP archive, applying security validations to prevent malicious archives from causing harm. It supports file pattern filtering and size limits, returning the extracted files as an array that can be processed by other nodes.

List - Map

Iterates over each item in a list and runs the nodes connected to the trigger output for each one. Creates a scoped context for each iteration where the current item is available. Collects results from all iterations into an output list. Supports both parallel and sequential modes.