external_video_tag
Generates a player for a specified external video in an <iframe> tag. An external video is a video hosted on a platform external to SHOPLINE.
Only YouTube video URLs are supported.
{{#external_video_tag videoUrl attribute=any /}}
Required params
videoUrl string: The URL of the external video.
Optional params
attribute any: The attribute=any in the syntax represents a placeholder. You can pass any native HTML attributes (such as class="my-video", id="player", or style="..."), which are applied directly to the generated <iframe> tag.
Examples
Rendering a video player
Use this tag together with the external_video_url filter to render a YouTube video player.
{{#external_video_tag media | external_video_url() /}}
{{#for media in product.media}}
{{#switch media.media_type}}
{{#case "external_video" /}}
{{#if media.host == "youtube"}}
{{#external_video_tag media | external_video_url(autoplay=true, loop=false) /}}
{{/if}}
{{/switch}}
{{/for}}
Adding HTML attributes
Pass in standard HTML iframe attributes, such as class and frameborder.
{{#external_video_tag media | external_video_url() attribute=any /}}
{{#for media in product.media}}
{{#switch media.media_type}}
{{#case "external_video" /}}
{{#if media.host == "youtube"}}
{{#external_video_tag media | external_video_url(autoplay=true, loop=false) class="video-media-youtube" frameborder="0" /}}
{{/if}}
{{/switch}}
{{/for}}
Was this article helpful to you?
'%3e%3crect%20x='6'%20y='7.13049'%20width='13'%20height='10'%20rx='1'%20fill='black'/%3e%3cpath%20d='M12.4998%2012.936L-3.65042%200.604835L28.65%200.604838L12.4998%2012.936Z'%20stroke='white'%20stroke-linejoin='round'/%3e%3c/g%3e%3cdefs%3e%3cclipPath%20id='clip0_716_14611'%3e%3crect%20x='6'%20y='7.13049'%20width='13'%20height='10'%20rx='1'%20fill='white'/%3e%3c/clipPath%3e%3c/defs%3e%3c/svg%3e)
'%3e%3crect%20x='5.63086'%20y='7.26086'%20width='13'%20height='10'%20rx='1'%20fill='white'/%3e%3cpath%20d='M12.1306%2013.0664L-4.01956%200.735206L28.2809%200.735209L12.1306%2013.0664Z'%20stroke='%231A2C42'%20stroke-linejoin='round'/%3e%3c/g%3e%3cdefs%3e%3cclipPath%20id='clip0_716_14599'%3e%3crect%20x='5.63086'%20y='7.26086'%20width='13'%20height='10'%20rx='1'%20fill='white'/%3e%3c/clipPath%3e%3c/defs%3e%3c/svg%3e)
© Copyright 2013-2026 SHOPLINE Limited.