# External Video Object
Information regarding videos hosted externally on YouTube or Vimeo platforms.
## Overview
The `external_video` object represents video content sourced from third-party hosting services. To render videos as HTML iframes, use the `external_video_tag` filter. For customizing player behavior, the `external_video_url` filter allows parameter configuration.
## Object Properties
| Property | Type | Description |
|----------|------|-------------|
| `alt` | string | Descriptive text for the video |
| `aspect_ratio` | number | Decimal representation of video dimensions |
| `external_id` | string | Video identifier from the host platform |
| `host` | string | Hosting service: `youtube` or `vimeo` |
| `id` | number | Unique identifier for the external video |
| `media_type` | string | Always returns `external_video` |
| `position` | number | Index within the product media collection |
| `preview_image` | image | Thumbnail representation (lacks ID attribute) |
## Usage Example
Filter product media to display only external videos:
```liquid
{% assign external_videos = product.media | where: 'media_type', 'external_video' %}
{% for external_video in external_videos %}
{{- external_video | external_video_tag }}
{% endfor %}
```
## Sample Data Structure
```json
{
"alt": "Potion beats",
"aspect_ratio": "1.77",
"external_id": "vj01PAffOac",
"host": "youtube",
"id": 22015756402753,
"media_type": "external_video",
"position": 1,
"preview_image": {}
}
```