> 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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.agenticflow.ai/workflows/workflow-inputs/multiple-media.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.