Convert Base64 To File

---

🎯 Purpose

The ConvertBase64ToFile node transforms Base64-encoded strings into actual files (e.g., images, PDFs, documents).

This is especially useful when working with APIs, databases, or uploads that return file data as Base64 text. The node supports saving files, organizing them into structured folders, and passing file references downstream in your workflow.

⚙️ Parameters

Data Source

Name	Type	Required	Default	Description
Base64 Value Expression	Text (dynamic)	Required	Empty	Path to the field containing the Base64 string.
File Extension Property Path	Text (dynamic)	Required	Empty	Path to the field containing file extension (e.g., pdf, jpg, png).

Processing

Name	Type	Required	Default	Description
Save File	Toggle (On/Off)	Optional	Off	Save converted files to storage (On) or just pass data forward (Off).
Folder Path	Text (dynamic)	Optional	"base64_decoder"	Folder path where files are stored (only applies if saveFile is enabled).

Output

Name	Type	Required	Default	Description
Option	Dropdown	Optional	Original with appended result column	Defines output format: - Original with appended result column: Keep all input data and add file column. - Return result column only: Only return file data.
Result Property Name	Text	Optional	"file_result"	Column name containing the converted file reference.

---

💡 Example Usage

📝 Document Processing

• Configuration:
  • Base64 Value Expression: API response field
  • File Extension Property Path: "pdf"
  • saveFile: On → folderPath: client_documents/incoming
  • outTransformId: Original with appended result column
  • outColumnName: "processed_document"
• Outcome: Base64 strings are converted into PDFs, saved in structured folders, and tracked with metadata.

---

📘 Best Practices

• File Organization: Use structured folder paths (/client/{{id}}/files).
• Data Validation: Confirm Base64 string validity before processing.
• Performance: Test large files with sample runs before batch conversion.
• Security: Apply access controls, retention policies, and encryption if needed.
• Error Handling: Watch for incorrect File Extension Property Path values—wrong extensions may make files unopenable.

---

🧪 Test Cases

• Given: Base64 string of a PDF, with File Extension Property Path = "pdf" → Expected: Valid PDF file created.

---

🏭 Industry Applications

Industry	Challenge	How Node Helps	Outcome
Healthcare	Medical imaging systems export scans as Base64 data	Converts scans into standard formats, stores securely with patient IDs	Reduces processing time by 70%, ensures compliant record storage
Financial Services	Mobile apps send signatures & documents as Base64	Converts into proper file formats, saves in secure folder structures	Improves processing efficiency by 60%, maintains compliance
Marketing Agencies	Client assets arrive as Base64 strings from varied sources	Converts to usable working files, organizes by campaign/client	Cuts asset prep time by 50%, improves creative workflow productivity

---