From b0457bc7c18f6e8d33dfa019aec5d84bd18a65c3 Mon Sep 17 00:00:00 2001 From: Vikhyath Mondreti Date: Tue, 3 Feb 2026 13:06:16 -0800 Subject: [PATCH] improve docs --- apps/docs/content/docs/en/execution/files.mdx | 34 +++++++++++++++++++ 1 file changed, 34 insertions(+) diff --git a/apps/docs/content/docs/en/execution/files.mdx b/apps/docs/content/docs/en/execution/files.mdx index 14c5121d4..125093952 100644 --- a/apps/docs/content/docs/en/execution/files.mdx +++ b/apps/docs/content/docs/en/execution/files.mdx @@ -23,6 +23,40 @@ When blocks output files (like Gmail attachments, generated images, or parsed do You can access any of these properties when referencing files from previous blocks. +## The File Block + +The **File block** is the universal entry point for files in your workflows. It accepts files from any source and outputs standardized file objects that work with all integrations. + +**Inputs:** +- **Uploaded files** - Drag and drop or select files directly +- **External URLs** - Any publicly accessible file URL +- **Files from other blocks** - Pass files from Gmail attachments, Slack downloads, etc. + +**Outputs:** +- A list of `UserFile` objects with consistent structure (`name`, `url`, `base64`, `type`, `size`) +- `combinedContent` - Extracted text content from all files (for documents) + +**Example usage:** + +``` +// Get all files from the File block + + +// Get the first file + + +// Get combined text content from parsed documents + +``` + +The File block automatically: +- Detects file types from URLs and extensions +- Extracts text from PDFs, CSVs, and documents +- Generates base64 encoding for binary files +- Creates presigned URLs for secure access + +Use the File block when you need to normalize files from different sources before passing them to other blocks like Vision, STT, or email integrations. + ## Passing Files Between Blocks Reference files from previous blocks using the tag dropdown. Click in any file input field and type `<` to see available outputs.