---
title: >-
  Vimeo embedded videos and ExternalVideo type changes - Shopify developer
  changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/vimeo-embedded-videos-and-externalvideo-type-changes
  md: >-
    https://shopify.dev/changelog/vimeo-embedded-videos-and-externalvideo-type-changes.md
metadata:
  effectiveApiVersion: ''
  affectedApi: []
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2021-03-09T14:45:46-05:00'
  postedAt: '2021-03-09T00:00:00-05:00'
  updatedAt: '2024-02-02T10:05:00-05:00'
  effectiveAt: '2021-03-09T00:00:00-05:00'
---

March 9, 2021

Tags:

* API

# Vimeo embedded videos and ExternalVideo type changes

Shopify now supports adding embedded Vimeo videos to products, leveraging the `ExternalVideo` object.

Many `ExternalVideo` API implementations assume that all external video objects represent YouTube videos. To help determine where the video is hosted, we're introducing the new field `host` to `ExternalVideo` that will return a `MediaHost` enum value (currently `VIMEO` or `YOUTUBE`).

Additionally, we're introducing two new `MediaError`values `EXTERNAL_VIDEO_EMBED_NOT_FOUND_OR_TRANSCODING` and `EXTERNAL_VIDEO_EMBED_DISABLED` for Vimeo error handling.