Skip to content

Part of Build n8n Workflows With Proven Patterns

Engineering Blueprint

Safety checked

Handle Binary Data and Files Correctly

0June 2026

Manage files, images, PDFs, and binary data in workflows without losing file contents or breaking vision input for AI agents.

What problem does this solve?

Teaches Claude that binary data lives in $binary (not $json), how to pass files between nodes without corruption, and the pre-staging pattern for sending files to AI agent tools, so workflows preserve file integrity and agents can access images without CDN/URL requirements.

How does it work?

When working with files, uploads, downloads, or AI vision, this skill activates and explains: file contents never go in $json; use $binary to keep them intact; merge operations that use "Merge Mode: Keep both, using only the nth fields" to preserve binary across JSON transforms; and for AI agents, pre-stage files to storage and pass keys/URLs instead of raw binary to the tool.

Included Skills

No skills in this group

What's required to run this?

Binary data handling is version-specific; n8n v1.x+ uses $binary consistently, but legacy v0.x workflows may use different patterns. CDN requirement applies to chat surfaces (Claude, UI) but not to backend processing (Code nodes can work with raw binary).

Key Features

$binary vs $json

File contents live in $binary; $json is for metadata only

Merge for Context

Keeping binary alive across JSON transforms with Merge node

Agent Tool Binary

Pre-stage files to storage; pass URLs to AI tools, not raw binary

CDN Requirement

Images must be URLs for display in chat surfaces; raw binary fails

About This Blueprint

Industry
Technology
1 File
Productivity

Business Automation & Productivity Workflow

Reduce hours lost to repetitive admin without adding a complicated stack. Prioritized, tested workflows automate routine research, client communication, project tracking, and website tasks while keeping people in control of important decisions.

1 File
Engineering

Business Technology & Digital Solutions Workflow

Avoid costly, fragmented digital projects with a plan that connects business goals to practical tools, implementation steps, and measurable results. It also flags performance, security, accessibility, and SEO checks before launch.

WordPressGoogle AnalyticsGoogle Search Console+2 more
Sales

ICP-Filtered Outreach Lists from G2 Buyer Intent

Stop wasting rep time on weak intent signals and mismatched accounts. The workflow ranks ICP-fit buyers by readiness, finds the right contact, and supplies tailored outreach angles for the strongest opportunities.

ClaudeClaudeG2 Buyer Intent (G2 MCP Server)ZoomInfo (MCP)+3 more

Ishani D.

Account Manager at G2