What does it do?

Inputs lets you pass data into your WordApp. You can use them to provide context for your AI models, or to give them something to work with.

When you run a WordApp, you will be asked to provide values for your output for this particular run. If you access your WordApp via API, you’ll need to provide these values in your request.

How do I use it?

Inputs live in the input bar, just above the start of your flow in the editor.

To add an input, you can:

  • Click the + ADD button in the input bar
  • Type /input in the editor and hit Enter
  • Type @ and a name for the new input in the editor, then hit Enter

Options

A number of options appear in the sidebar when you create a new input. Here’s what they mean:

Name

The name of the input. You’ll need this later if you want to reference the input in your flow.

Description

A description of the input. This can be useful for keeping track of what each input is for, but is not required. It’s also not visible to the AI models in a generation.

Input Type

What values are allowed for this input. You can choose between:

Input typeWhat it’s for
TextA short word or phrase
Long TextA longer snippet of text, potentially multiple paragraphs
ImageAn image, helpful if you’re using AI models with vision capabilities, like GPT-4o
FileChoose a sub file type between Document or Raw File. A file must be processed by a tool like Document Parser or File Content Extractor before it can be used in the prompt. See a full example in Parsing a PDF.
AudioUpload a song, or a recording and use it in your prompt. This is helpful if you’re using AI models with audio capabilities, like Google Gemini.

Outputs

While it’s not technically an output, the value of an input can be referenced in your flow the same as any other output.