Overview
This node uploads files to a specified destination path or folder. It supports uploading a single file or multiple files from binary data in the input items. Users can specify the target path or folder, MIME type, and optionally enforce file size limits and extension filters. Additional metadata can be attached to single file uploads. This node is useful for automating file storage tasks, such as saving reports, images, or documents to a remote or local file system.
Use Case Examples
- Uploading a single PDF report from binary data to a specific folder path.
- Uploading multiple image files from input items to a target folder, filtering by allowed extensions like jpg and png.
- Enforcing a maximum file size limit when uploading files to prevent oversized uploads.
Properties
| Name | Meaning |
|---|---|
| Input Data Mode | Determines whether to upload a single file or multiple files from the input data. |
| Binary Property | The name of the binary property containing the file to upload (used in single file mode). |
| Target Path | The destination path where the single file will be stored, including filename and extension. |
| Target Folder | The destination folder where multiple files will be stored (used in multiple files mode). |
| MIME Type | The MIME type of the file being uploaded (used in single file mode). |
| Enable Size Limit | Whether to enforce a maximum file size limit for uploads. |
| Maximum Size (MB) | The maximum allowed file size in megabytes if size limit is enabled. |
| Enable Extension Filter | Whether to filter files by allowed extensions during upload. |
| Allowed Extensions | Comma-separated list of allowed file extensions if extension filter is enabled. |
| Metadata | Additional metadata key-value pairs to attach to the file (used in single file mode). |
Output
JSON
uploadedFiles- Array of objects representing the uploaded files with details such as path, size, and metadata.
Dependencies
- An API key or authentication token for the file storage service may be required.
Troubleshooting
- Ensure the binary property name matches the actual binary data property in the input item to avoid upload failures.
- If size limit is enabled, files exceeding the maximum size will be rejected; adjust the limit or disable it if needed.
- When extension filter is enabled, files with disallowed extensions will not be uploaded; verify the allowed extensions list.
- Check that the target path or folder exists and is writable to prevent errors during file upload.