> For the complete documentation index, see [llms.txt](https://docs.tachyon.video/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tachyon.video/user-guide/4.-programming-a-show/timeline-editor/add-or-replace-media.md).

# Add or Replace Media

## Add Media

Create a new empty Media Clip on the Timeline by using one of these 3 methods:

**Method** ❶

* **`Right-click`** on a Layer track and select the **{Add Media}** option from the contextual menu 

OR 

* **`Click`** on a Layer to select it, then press <kbd>**`Ctrl`**</kbd>**+**<kbd>**`M`**</kbd>.

![](/files/-MZO3V_xGPbnRBrgNWeY)

{% hint style="info" %}
This will create a Media Clip with a duration that corresponds to the duration of the Timeline.
{% endhint %}

**Method** ❷

* **`Click`** on the empty Media Clip to select it. The Clip Properties window section of the Timeline module will reflect your selection and its name will change to “Media Properties.”

![](/files/-MZO3V_yldKeplP-XiDW)

**Method** ❸

* Select an item from the Media File list by clicking on its entry. The selected media file will be loaded onto the Media Clip and will loop to match the Clip’s duration.

## Add a Specific Media File as a Media Clip in the Timeline

* **`Drag+Drop`** a media file from the File Manager module onto the Timeline. A new Media Clip linked to the selected media file will be created.&#x20;

{% hint style="info" %}
The Clip’s duration will match the duration of the media file (even if it is a single frame or still image).
{% endhint %}

## Replace the Media File linked to a Media Clip

There are two methods to replace the media file linked to a Media Clip on the Timeline:

* **`Click`** on the Media Clip to select it and then **`Double-click`** on the desired media file located in the File Manager module&#x20;

OR&#x20;

* **`Click`** on the Media Clip to select it and choose a media file from the Media File list located in the Media Properties window section.

{% hint style="info" %}
None of these actions will alter the duration of the Media Clip.
{% endhint %}


---

# 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.tachyon.video/user-guide/4.-programming-a-show/timeline-editor/add-or-replace-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.