---
title: "ExternalVideo"
description: "Represents a video hosted outside of Shopline."
doc_type: graphql
doc_category: storefront
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/docs/storefront-api/common-objects/objects/external-video'
  md: 'https://developer.shopline.com/docs/storefront-api/common-objects/objects/external-video.md'
---
# ExternalVideo

Represents a video hosted outside of Shopline.

- **API Version:** v20270301
- **API Type:** Storefront
- **API Protocol:** GraphQL
- **Operation Type:** Object

## Type Signature

`ExternalVideo`

## Fields

* `alt`

  [String](https://developer.shopline.com/docs/storefront-api/common/scalars/string.md)

  A word or phrase to share the nature or contents of a media.

* `host`

  [MediaHost!](https://developer.shopline.com/docs/storefront-api/common-objects/enums/media-host.md)

  The host of the external video.

* `id`

  [ID!](https://developer.shopline.com/docs/storefront-api/common/scalars/id.md)

  A globally-unique ID.

* `mediaContentType`

  [MediaContentType!](https://developer.shopline.com/docs/storefront-api/common-objects/enums/media-content-type.md)

  The media content type.

* `originalUrl`

  [String!](https://developer.shopline.com/docs/storefront-api/common/scalars/string.md)

  The origin URL of the video on the respective host.

* `previewImage`

  [Image](https://developer.shopline.com/docs/storefront-api/common-objects/objects/image.md)

  The preview image for the media.

## Schema Definition

```graphql
type ExternalVideo { 
	alt: String
	host: MediaHost!
	id: ID!
	mediaContentType: MediaContentType!
	originalUrl: String!
	previewImage: Image 
}
```

## Error Handling

For detailed information about common codes, see [Status and error codes](https://developer.shopline.com/docs/apps/api-instructions-for-use/storefront-api/overview.md#status-and-error-codes).