---
title: 'Liquid objects: external_video'
description: Information about an external video from YouTube or Vimeo.
api_name: liquid
source_url:
  html: 'https://shopify.dev/docs/api/liquid/objects/external_video'
  md: 'https://shopify.dev/docs/api/liquid/objects/external_video.md'
---

# external\_​video

Information about an external video from YouTube or Vimeo.

***

Tip

Use the [`external_video_tag` filter](https://shopify.dev/docs/api/liquid/filters/external_video_tag) to output the video in an HTML `<iframe>` tag. Use the [`external_video_url` filter](https://shopify.dev/docs/api/liquid/filters/external_video_url) to specify parameters for the external video player.

***

## Properties

* * alt

    [string](https://shopify.dev/docs/api/liquid/basics#string)

  * The alt text of the external video.

  * aspect\_​ratio

    [number](https://shopify.dev/docs/api/liquid/basics#number)

  * The aspect ratio of the video as a decimal.

  * external\_​id

    [string](https://shopify.dev/docs/api/liquid/basics#string)

  * The ID of the video from its external source.

  * host

    [string](https://shopify.dev/docs/api/liquid/basics#string) from a set of values

  * The service that hosts the video.

    | Possible values |
    | - |
    | youtube |
    | vimeo |

  * id

    [number](https://shopify.dev/docs/api/liquid/basics#number)

  * The ID of the external video.

  * media\_​type

    [string](https://shopify.dev/docs/api/liquid/basics#string)

  * The media type of the external video. Always returns `external_video`.

    ![](https://shopify.dev/images/icons/32/lightbulbscroll.png)![](https://shopify.dev/images/icons/32/lightbulbscroll-dark.png)ExampleFilter for media of a specific type

    You can use the `media_type` property with the [`where` filter](https://shopify.dev/docs/api/liquid/filters/where) to filter the [`product.media` array](https://shopify.dev/docs/api/liquid/objects/product#product-media) for all media of a desired type.

    ```liquid
    {% assign external_videos = product.media | where: 'media_type', 'external_video' %}


    {% for external_video in external_videos %}
      {{- external_video | external_video_tag }}
    {% endfor %}
    ```

    ##### Code

    ```
    {% assign external_videos = product.media | where: 'media_type', 'external_video' %}

    {% for external_video in external_videos %}
      {{- external_video | external_video_tag }}
    {% endfor %}
    ```

    ##### Data

    ```
    {
      "product": {
        "media": [
          {
            "media_type": "external_video"
          },
          {
            "media_type": "video"
          }
        ]
      }
    }
    ```

    ## Output

    ```html
    <iframe frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen="allowfullscreen" src="https://www.youtube.com/embed/vj01PAffOac?controls=1&amp;enablejsapi=1&amp;modestbranding=1&amp;origin=https%3A%2F%2Fpolinas-potent-potions.myshopify.com&amp;playsinline=1&amp;rel=0" title="Potion beats"></iframe>
    ```

  * position

    [number](https://shopify.dev/docs/api/liquid/basics#number)

  * The position of the external video in the [`product.media`](https://shopify.dev/docs/api/liquid/objects/product#product-media) array.

  * preview\_​image

    [image](https://shopify.dev/docs/api/liquid/objects/image)

  * A preview image of the media.

    Note

    Preview images don't have an ID attribute.

```json
{
  "alt": "Potion beats",
  "aspect_ratio": "1.77",
  "external_id": "vj01PAffOac",
  "host": "youtube",
  "id": 22015756402753,
  "media_type": "external_video",
  "position": 1,
  "preview_image": {}
}
```

##### Example

```
{
  "alt": "Potion beats",
  "aspect_ratio": "1.77",
  "external_id": "vj01PAffOac",
  "host": "youtube",
  "id": 22015756402753,
  "media_type": "external_video",
  "position": 1,
  "preview_image": {}
}
```