> ## Documentation Index
> Fetch the complete documentation index at: https://docs.youka.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Media

> Upload and manage reusable images, videos, logos, and intro/outro clips

Media are reusable files you can reference from presets or project settings. Upload them once, then apply them across multiple projects and exports.

## `media add`

Upload a local file as reusable media.

```bash theme={null}
youka media add <file> --as <type>
```

<ParamField path="file" type="string" required>
  Local path to the file you want to upload.
</ParamField>

<ParamField path="--as" type="string" required>
  One of `image`, `video`, `logo`, `intro`, or `outro`.
</ParamField>

### Types

| Type    | Description              |
| ------- | ------------------------ |
| `image` | Static background image  |
| `video` | Looping background video |
| `logo`  | Overlay logo             |
| `intro` | Intro clip               |
| `outro` | Outro clip               |

### Examples

<CodeGroup>
  ```bash image theme={null}
  youka media add ./background.png --as image --json
  ```

  ```bash intro theme={null}
  youka media add ./intro.mp4 --as intro --json
  ```
</CodeGroup>

## `media list`

List uploaded media for the authenticated account.

```bash theme={null}
youka media list
youka media list --json
```

## `media show`

Fetch one media item by ID.

```bash theme={null}
youka media show <mediaId>
youka media show <mediaId> --json
```

## `media delete`

Delete an uploaded media item.

```bash theme={null}
youka media delete <mediaId> --json
```

<Warning>
  Deleting media does not rewrite existing projects or exports. It only prevents
  future renders from referencing that media.
</Warning>

## What's next

* [Presets](/en/cli/presets) - bundle media into reusable render settings
* [Projects](/en/cli/projects) - apply media through `project settings`