Skip to content

Output

Finalizes and exports workflow results. Depending on the selected output type and the data provided, it saves files (e.g., images or archives) to the Salt output directory and emits a UI payload describing the saved artifacts for display and download.
Preview

Usage

Use this as the terminal node to persist and surface results. Connect the data you want to export (images, text, JSON, or a filesystem path) and choose the appropriate output type. The node writes files under an auto-generated unique subfolder and returns UI metadata for the Salt interface.

Inputs

FieldRequiredTypeDescriptionExample
output_typeTrueSTRING (enum: STRING \| PNG \| JPEG \| WEBP \| ZIP \| Path)Select how the output should be handled: STRING returns plain text in the UI; PNG/JPEG save image batches as files; ZIP creates a .zip (supports zipping image batches or textual/JSON content); Path zips a provided file or directory.PNG
output_dataTrueWILDCARDThe data to export. Supported combinations: PNG/JPEG require a torch tensor batch of images; ZIP supports a tensor batch (images as PNG inside the ZIP), a string (saved as .txt), a list (each item saved as numbered .txt), or a dict (saved as .json); Path requires a valid path string within allowed Salt directories (input/output/temp). STRING will display the value directly in the UI.A tensor batch of images for PNG/JPEG, or a string like "Process complete" for STRING, or a dict like {"scores": [0.9, 0.8]} for ZIP

Outputs

FieldTypeDescriptionExample
uiNot specifiedEmits a UI payload with salt_metadata and salt_output entries describing saved files (filenames, subfolder, type) and, for image types, a preview list. This node has no downstream data outputs.{"ui": {"salt_metadata": [{"salt_reference_uuid": "", "salt_asset": true, "salt_file_extension": "PNG"}], "salt_output": [{"filename": "output_1_0000.png", "subfolder": "", "type": "output"}], "images": [{"filename": "output_1_0000.png", "subfolder": "", "type": "output"}]}}

Important Notes

  • Image saving: PNG/JPEG only save when output_data is a tensor batch of images. Each image in the batch is saved as a separate file.
  • ZIP behavior: ZIP supports zipping (a) image batches (as PNG files), (b) a single string to a .txt, (c) a list of items to numbered .txt files, or (d) a dict to a single .json.
  • Path zipping: Path zips an existing file or directory but only if it resides within Salt's allowed directories (input, output, or temp); otherwise an error is raised.
  • STRING mode: STRING does not write files; it surfaces the provided text directly in the UI.
  • Output location: Files are written under the Salt output directory into an auto-generated unique subfolder (UUID). The UI response includes filenames and the subfolder for retrieval.
  • WEBP selection: While WEBP is available as a selectable type, saving behavior is implemented for PNG/JPEG images. Choose PNG or JPEG when exporting image tensors.
  • No downstream outputs: This node is an output node; it returns UI metadata only and does not pass data to subsequent nodes.

Troubleshooting

  • No files saved for images: Ensure output_type is PNG or JPEG and output_data is a valid image tensor batch.
  • ZIP created but contents unexpected: Verify output_data matches the intended ZIP mode (tensor for images, string/list/dict for text/JSON).
  • Path error: not allowed: Move the file/directory under the Salt input/output/temp directories or update your selection to a permitted location.
  • Empty UI preview: Image previews appear only when output_type is PNG or JPEG and files were actually saved.
  • Selecting WEBP yields no files: Use PNG or JPEG for image saving; WEBP is not currently saved by this node.

Example Pipelines

Example
Example