> For the complete documentation index, see [llms.txt](https://docs.agenticflow.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.agenticflow.ai/workflows/workflow-inputs/upload-video.md).

# Upload Video

The **Upload Video** control is an input component that allows a user to upload a video file (e.g., MP4, MOV, WEBM) when they run a workflow. The uploaded video is then accessible via a temporary URL that can be used by downstream nodes.

## When to Use

Use the Upload Video control for any workflow that needs to process a user-provided video file. Common use cases include:

* Transcribing the audio track of a video to text.
* Analyzing video frames or content (with a capable model).
* Creating summaries or highlight reels from a longer video.
* Watermarking or clipping a video.

## How to Add

1. From your workflow's **Build** page, click on **+ Add Input**.
2. Select **Upload Video** from the list of available controls.

## Configuration

* **Title:** The main label for the file upload field.
* **Description:** Optional helper text to provide more context.
* **Variable Name:** The name used to access the URL of the uploaded video file.
* **Optional/Required:** A toggle to specify if the user must upload a file.

## Accessing the Value

After the user uploads a file, this control outputs a temporary, secure URL pointing to that video file. This URL is accessible via the variable name you assigned.

For example, if the variable name is `source_video`, the value of `{{source_video}}` will be a URL (e.g., `https://cdn.agenticflow.ai/.../presentation.mp4`).

**Note:** This URL is temporary and will expire. It is meant for immediate processing within the workflow run.

### Example

**Goal:** Allow a user to upload a video of a presentation and get a text transcript of the audio.

1. **Add an Upload Video Control:**
   * Title: "Upload Presentation Video"
   * Variable Name: `presentation_url`
2. **Add an OpenAI MCP Node (Whisper):**
   * **Action:** `Create Transcription`
   * **File:** `{{presentation_url}}`
   * **Purpose:** To extract and transcribe the audio from the video file.
3. **Add a Save to File Node:**
   * **File Name:** `presentation_transcript.txt`
   * **Content:** `{{openai_mcp_1.text}}`
   * **Purpose:** To save the final transcript.

This workflow provides a simple but powerful way to convert video content into searchable, analyzable text.