> ## Documentation Index
> Fetch the complete documentation index at: https://comfydeploy.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Workflow inputs

ComfyUI let's you connect nodes to each other when their input and output types match.

With Comfy Deploy you can expose inputs to your workflow by adding Comfy Deploy external nodes.

<Frame>
  <video src="https://mintcdn.com/comfydeploy/o5fOxSEVTG8z9WUO/images/input-custom-nodes/expose-prompt.mp4?fit=max&auto=format&n=o5fOxSEVTG8z9WUO&q=85&s=037a0a999804a7c04f00f81903847e35" autoplay="" loop playsinline="" data-path="images/input-custom-nodes/expose-prompt.mp4" />
</Frame>

# Input custom node reference

<Note>
  If you have an input type that we don't support, please let us know in our [discord](https://discord.gg/ygb6VZwaMt) or create a PR in our [github](https://github.com/BennyKok/comfyui-deploy).
</Note>

## External Boolean Input

Let's you expose a boolean input to your workflow.

### Properties

* `input_id`: Unique identifier for this input
* `default_value`: The default boolean value
* `display_name`: Optional friendly name to show in the UI
* `description`: Optional description of what this input controls

<Frame>
  <img src="https://mintcdn.com/comfydeploy/o5fOxSEVTG8z9WUO/images/input-custom-nodes/external-boolean.png?fit=max&auto=format&n=o5fOxSEVTG8z9WUO&q=85&s=38da79fe49339e20cee1f965ef429343" alt="External Boolean Node" width={500} data-path="images/input-custom-nodes/external-boolean.png" />
</Frame>

## External Checkpoint Input

Allows you to change the checkpoint model.

### Properties

* `input_id`: Unique identifier for this input (default: "input\_checkpoint")
* `default_value`: The default checkpoint model to use
* `display_name`: Optional friendly name to show in the UI
* `description`: Optional description of what this input controls

<Frame>
  <img src="https://mintcdn.com/comfydeploy/o5fOxSEVTG8z9WUO/images/input-custom-nodes/external-checkpoint.png?fit=max&auto=format&n=o5fOxSEVTG8z9WUO&q=85&s=b22b925a74300122ab1f49f143347ec5" alt="External Checkpoint Node" width={500} data-path="images/input-custom-nodes/external-checkpoint.png" />
</Frame>

## External Face Model Input

The External Face Model node is for the reactor face model node for [ComfyUI Reactor](https://github.com/Gourieff/comfyui-reactor-node)

### Properties

* `input_id`: Unique identifier for this input (default: "input\_reactor\_face\_model")
* `default_face_model_name`: The default face model to use
* `face_model_save_name`: Name to save downloaded face model as
* `display_name`: Optional friendly name to show in the UI
* `description`: Optional description of what this input controls
* `face_model_url`: Optional URL to download face model from

<Frame>
  <img src="https://mintcdn.com/comfydeploy/o5fOxSEVTG8z9WUO/images/input-custom-nodes/external-face-model.png?fit=max&auto=format&n=o5fOxSEVTG8z9WUO&q=85&s=8e598f5531a51e104a61fcc327ea959b" alt="External Face Model Node" width={500} data-path="images/input-custom-nodes/external-face-model.png" />
</Frame>

## External Image Input

The External Image node allows you to expose image inputs in your workflow. It supports loading images from URLs and base64 encoded data.

### Properties

* `input_id`: Unique identifier for this input (default: "input\_image")
* `default_value`: The default image to use if no input is provided
* `display_name`: Optional friendly name to show in the UI
* `description`: Optional description of what this input controls

<Frame>
  <img src="https://mintcdn.com/comfydeploy/o5fOxSEVTG8z9WUO/images/input-custom-nodes/external-image.png?fit=max&auto=format&n=o5fOxSEVTG8z9WUO&q=85&s=c010abd7abee562443670f63d73909ee" alt="External Image Node" width={500} data-path="images/input-custom-nodes/external-image.png" />
</Frame>

## External Image Alpha Input

The External Image Alpha node is an alternative image input node that allows you to expose image inputs to use the Alpha channel. It supports loading images from URLs and base64 encoded data, with improved alpha channel handling.

### Properties

* `input_id`: Unique identifier for this input (default: "input\_image")
* `default_value`: The default image to use if no input is provided
* `display_name`: Optional friendly name to show in the UI
* `description`: Optional description of what this input controls

<Frame>
  <img src="https://mintcdn.com/comfydeploy/o5fOxSEVTG8z9WUO/images/input-custom-nodes/external-image-alpha.png?fit=max&auto=format&n=o5fOxSEVTG8z9WUO&q=85&s=22539cbc974edcc09dc41fb82db836db" alt="External Image Alpha Node" width={500} data-path="images/input-custom-nodes/external-image-alpha.png" />
</Frame>

## External Image Batch Input

The External Image Batch node allows you to send multiple images as an input.
It supports loading images from URLs (including ZIP files containing images) and base64 encoded data.

<Note>
  This node is usually used with video workflows. Most likely you want to use External Image
</Note>

### Properties

* `input_id`: Unique identifier for this input (default: "input\_images")
* `images`: JSON array of image sources (URLs, ZIP files, or base64 data)
* `default_value`: The default image to use if no input is provided
* `display_name`: Optional friendly name to show in the UI
* `description`: Optional description of what this input controls

<Frame>
  <img src="https://mintcdn.com/comfydeploy/o5fOxSEVTG8z9WUO/images/input-custom-nodes/external-image-batch.png?fit=max&auto=format&n=o5fOxSEVTG8z9WUO&q=85&s=6a6be44d0b64589ddfc0d905c7d30495" alt="External Image Batch Node" width={500} data-path="images/input-custom-nodes/external-image-batch.png" />
</Frame>

## External Lora Input

The External Lora node allows you to dynamically load LoRA models into your workflow.

### Properties

* `input_id`: Unique identifier for this input (default: "input\_lora")
* `default_lora_name`: The default LoRA model to use if no input is provided
* `lora_save_name`: Name to save downloaded LoRA as (when loading from URL)
* `display_name`: Optional friendly name to show in the UI
* `description`: Optional description of what this input controls
* `lora_url`: Optional URL to download LoRA from

<Frame>
  <img src="https://mintcdn.com/comfydeploy/o5fOxSEVTG8z9WUO/images/input-custom-nodes/external-lora.png?fit=max&auto=format&n=o5fOxSEVTG8z9WUO&q=85&s=47a6d9faae302160f22daada33f8fac1" alt="External Lora Node" width={500} data-path="images/input-custom-nodes/external-lora.png" />
</Frame>

## External Number Input

The External Number node allows you to input numeric values.

### Properties

* `input_id`: Unique identifier for this input (default: "input\_number")
* `default_value`: The default number to use if no input is provided
* `display_name`: Optional friendly name to show in the UI
* `description`: Optional description of what this input controls

<Frame>
  <img src="https://mintcdn.com/comfydeploy/o5fOxSEVTG8z9WUO/images/input-custom-nodes/external-number.png?fit=max&auto=format&n=o5fOxSEVTG8z9WUO&q=85&s=92a012d50466e64da9c961805799c4ec" alt="External Number Node" width={500} data-path="images/input-custom-nodes/external-number.png" />
</Frame>

## External Number Int Input

The External Number Int node allows you to input integer values.

### Properties

* `input_id`: Unique identifier for this input (default: "input\_number")
* `default_value`: The default integer to use if no input is provided (range: -2147483647 to 2147483647)
* `display_name`: Optional friendly name to show in the UI
* `description`: Optional description of what this input controls

<Frame>
  <img src="https://mintcdn.com/comfydeploy/o5fOxSEVTG8z9WUO/images/input-custom-nodes/external-number-int.png?fit=max&auto=format&n=o5fOxSEVTG8z9WUO&q=85&s=97a889d8d6b721c0f7eb3e0a525f1376" alt="External Number Int Node" width={500} data-path="images/input-custom-nodes/external-number-int.png" />
</Frame>

## External Number Slider Input

The External Number Slider node provides a slider interface for numeric input.

<Note>
  This will render a slider in the playground UI.
</Note>

### Properties

* `input_id`: Unique identifier for this input (default: "input\_number\_slider")
* `default_value`: The default number to use if no input is provided (default: 0.5)
* `min_value`: Minimum allowed value for the slider (default: 0)
* `max_value`: Maximum allowed value for the slider (default: 1)
* `display_name`: Optional friendly name to show in the UI
* `description`: Optional description of what this input controls

<Frame>
  <img src="https://mintcdn.com/comfydeploy/o5fOxSEVTG8z9WUO/images/input-custom-nodes/external-number-slider.png?fit=max&auto=format&n=o5fOxSEVTG8z9WUO&q=85&s=5fe85b4b67777ae839eeb0146c56631d" alt="External Number Slider Node" width={500} data-path="images/input-custom-nodes/external-number-slider.png" />
</Frame>

## External Text Input

The External Text Input node allows accepting text input.

### Properties

* `input_id`: Unique identifier for this input (default: "input\_text")
* `default_value`: The default text to use if no input is provided
* `display_name`: Optional friendly name to show in the UI
* `description`: Optional description of what this input controls

<Frame>
  <img src="https://mintcdn.com/comfydeploy/o5fOxSEVTG8z9WUO/images/input-custom-nodes/external-text.png?fit=max&auto=format&n=o5fOxSEVTG8z9WUO&q=85&s=93f5faa038877f9abc9094adcc2da78a" alt="External Text Node" width={500} data-path="images/input-custom-nodes/external-text.png" />
</Frame>

## External Text Any

The External Text Any node is similar to External Text Input but can be connected to any type.

Useful for inputs that have string dropdowns. E.g. `sampler` for the `Ksampler` node.

<Warning>
  When connecting to an enum values, we will not be able to validate the input before runtime.
</Warning>

### Properties

* `input_id`: Unique identifier for this input (default: "input\_text")
* `default_value`: The default text to use if no input is provided
* `display_name`: Optional friendly name to show in the UI
* `description`: Optional description of what this input controls

<Frame>
  <img src="https://mintcdn.com/comfydeploy/o5fOxSEVTG8z9WUO/images/input-custom-nodes/external-text-any.png?fit=max&auto=format&n=o5fOxSEVTG8z9WUO&q=85&s=cf9dd67710722baf7b0823822cc8b49b" alt="External Text Any Node" width={500} data-path="images/input-custom-nodes/external-text-any.png" />
</Frame>

## External Video Input X VHS

The External Video Input node allows accepting video files through the API or playground. It supports common video formats like MP4, WebM, MKV and GIF.

This is desigend to work with the [Video Helper Suite nodes](https://github.com/Kosinkadink/ComfyUI-VideoHelperSuite)

### Properties

* `input_id`: Unique identifier for this input (default: "input\_video")
* `default_value`: The default video file to use if no input is provided
* `meta_batch`: Optional batch processing configuration

<Frame>
  <img src="https://mintcdn.com/comfydeploy/o5fOxSEVTG8z9WUO/images/input-custom-nodes/external-video-vhs.png?fit=max&auto=format&n=o5fOxSEVTG8z9WUO&q=85&s=e6828d9c85f37b01ea20c4f1de953769" alt="External Video Node" width={500} data-path="images/input-custom-nodes/external-video-vhs.png" />
</Frame>
