# Workflow Inputs

How to Add Input Variables

Workflow Inputs are variables you can set at runtime and use inside of your Workflows.

### 1. Click the **"Configure"** button on your Start step

<figure><img src="https://3762890407-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-364d5d534be80aed67eb6e17b73c3f82a34737af%2FCleanShot%202025-02-23%20at%2017.50.20%402x.png?alt=media" alt=""><figcaption><p>Click on "Set Inputs" to define your inputs</p></figcaption></figure>

### 2. Select your input type

You will be prompted to first choose your desired **"Input Type."** This determines both the user interface and the data type of your input value:

<figure><img src="https://3762890407-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-4f92f4c83928dfbe23857f5eecd99fc7fc97f373%2FCleanShot%202025-02-23%20at%2017.51.45%402x.png?alt=media" alt=""><figcaption></figcaption></figure>

### 3. Customize the input field

See the [next section](#input-types) for a full list of supported types to decide what works best for your use-case. Continue to populate the remaining fields of your Workflow Input:

<figure><img src="https://3762890407-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-2ae2eda2392939b2a04a8d9e4ecb00cd7085c411%2FCleanShot%202025-02-23%20at%2017.52.34%402x.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

* **Label:** a descriptive label for the name of your input
* **Variable Name:** the name of your input as a variable, which will be referenced as liquid syntax in your steps. By default, the variable name is automatically generated when you add a label, but it can be customized to be separate
* **Hint:** helper text that appears below your input on the Workflow page
* **Placeholder:** example value that will be overwritten by your input value
* **Default Value:** a default value used if no other input value is provided, this is useful for API calls
* **Required:** determines whether or not the input is required for your Workflow to run successfully

{% hint style="info" %}
**Inputs are required by default.** When you create a new input, it is automatically set as required. This saves you one click per input when building workflows. You can uncheck the "Required" option if you want to make an input optional.
{% endhint %}
