> 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/multiple-media.md).

# Multiple Media

The **Multiple Media** control is an input component that allows a user to upload multiple image or video files in a single step. The control then outputs a list of temporary URLs, one for each uploaded file.

## When to Use

Use the Multiple Media control for any workflow that needs to process a batch of files provided by the user. Common use cases include:

* Compiling multiple video clips into a single highlight reel.
* Analyzing a collection of images.
* Processing a set of related documents or slides that are in image format.

## How to Add

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

## Configuration

* **Title:** The main label for the file upload area.
* **Description:** Optional helper text to provide more context.
* **Variable Name:** The name used to access the **list** of URLs for the uploaded files.
* **Optional/Required:** A toggle to specify if the user must upload at least one file.

## Accessing the Value

This control outputs a **list (or array) of strings**, where each string is a temporary, secure URL pointing to one of the uploaded files. This list is accessible via the variable name you assigned.

For example, if the variable name is `source_files`:

* The value of `{{source_files}}` would look like `["https://url/to/file1.jpg", "https://url/to/file2.png"]`.
* This list is ideal for use with a **Map Node**, which can run a sub-workflow for each file URL.

**Note:** For security, these URLs expire after a few days. They are intended for immediate processing within the workflow run.

### Example

**Goal:** Allow a user to upload several product images and generate a description for each one.

1. **Add a Multiple Media Control:**
   * Title: "Upload Product Images"
   * Variable Name: `product_images`
2. **Add a Map Node:**
   * **Input List:** `{{product_images}}`
   * **Sub-Workflow:**
     * **Sub-Node 1: OpenAI MCP (GPT-4 Vision)**
       * **Action:** `Analyze Image Content`
       * **Image URL:** `{{item}}`
       * **Prompt:** `Write a one-sentence marketing description for the product in this image.`
       * **Note:** `{{item}}` refers to the individual image URL for the current iteration.
3. **Add a Save to File Node:**
   * **File Name:** `product_descriptions.txt`
   * **Content:** The collected list of descriptions will be saved: `{{map_1.output}}`

This workflow efficiently processes a batch of user-uploaded images, performing the same analysis on each one and collecting the results.