Skip to main content

​
What It Does

  • Generates a single-row DataFrame from user-defined fields to trigger workflows.
  • Adds static form values to existing datasets without overwriting existing columns.
  • Automatically resolves duplicate column names with numeric suffixes.
  • Supports empty DataFrames, preserving previous column structure.
  • Works as a first-node trigger, middle-node enhancer, or recovery node for empty inputs.

​
🏁 Getting Started

Input Form Node config screenshot
1

Define your fields

List the fields you want to add with names and values.
2

Connect input data (optional)

If adding to existing data, provide the input DataFrame.
3

Configure column behavior

The node automatically resolves duplicates for you.
4

Run the node

Generates output with form fields appended to your data.

​
Inputs

​
🛠️ Required Fields

  • fields_to_input (✅)
    Define each field with a label and a value.
    Why it matters: Controls which columns and values appear in the output DataFrame.

​
Output

  • Output contains all original columns plus the form fields you defined.
  • Duplicate names are automatically suffixed (field_1, field_2, etc.) to avoid overwriting.
✨ If your input DataFrame already has any of the column names, new form columns will be renamed automatically (e.g., company_1, department_1).

​
How It Works

  1. Validates your field definitions for names and values.
  2. Loads input DataFrame if provided, or prepares a new one.
  3. Applies form values to either a new row or to each existing row.
  4. Resolves any column name conflicts automatically.
  5. Outputs the final DataFrame with all original and new columns.

​
🚀 Example Use Cases & Prompts

Use CaseSetup or Prompt Example
Trigger workflowAdd {"field_text": "company", "field_value": "Microsoft"} as first node
Inject static metadataAdd {"field_text": "form_date", "field_value": "2024-01-15"} to existing DataFrame
Recover empty input dataUse form fields to fill missing rows with default values

​
✨ Pro Tips

  • Name your fields clearly to avoid unexpected suffixes.
  • When appending to existing data, check column order to ensure form fields appear last.
  • Use test mode to preview how fields will append without creating full output.

​
⚠️ Important Considerations

  • If multiple form fields share the same name, numeric suffixes are added automatically (e.g., company, company_1).
  • Empty input DataFrames will maintain original columns as None and add form fields.

​
🛠 Troubleshooting & Gotchas

SymptomLikely CauseQuick Fix
Column not appearingName conflict with inputLook for suffixed column like company_1

​
📝 FAQ

Yes — provide the input DataFrame, and the node will add form columns to each row.
The node automatically renames form columns to prevent overwriting using numeric suffixes.
Absolutely — it works as a trigger node and will generate a single-row DataFrame with only form fields.

​
💰 Pricing

Each form row processed uses 1 credit.
One credit per run when used as a trigger node.

Use the Input Form Node to start workflows or inject metadata consistently — no coding required. 🚀