Help:Embedding Video files

The EmbedVideo parser function expects to be called in any of the following ways:

#ev - Classic parser tag

• {{#ev:service|id}}
• {{#ev:service|id|dimensions}}
• {{#ev:service|id|dimensions|alignment}}
• {{#ev:service|id|dimensions|alignment|description}}
• {{#ev:service|id|dimensions|alignment|description|container}}
• {{#ev:service|id|dimensions|alignment|description|container|urlargs}}
• {{#ev:service|id|dimensions|alignment|description|container|urlargs|autoresize}}
• {{#ev:service|id|dimensions|alignment|description|container|urlargs|autoresize|valignment}}

However, if needed optional arguments may be left blank by not putting anything between the pipes:

• {{#ev:service|id|||description}}

#evt - Parser tag for templates

The #evt parser tag allows for key=value pairs which allows for easier templating and readability.

{{#evt:
service=youtube
|id=https://www.youtube.com/watch?v=pSsYTj9kCHE
|alignment=right
}}

#evu - Parser tag for URLs

The #evu parser tag is like the #evt tag, but its first parameter is a URL that will be parsed to determine the service automatically.

{{#evu:https://www.youtube.com/watch?v=pSsYTj9kCHE
|alignment=right
}}

Tag hook

Videos can easily be embedded with the <embedvideo></embedvideo> tag hook. The ID/URL goes as the input between the tags and parameters can be added as the tag arguments.

<embedvideo service="youtube">https://www.youtube.com/watch?v=pSsYTj9kCHE</embedvideo>

Alternativly, you can also use the service id as the tag (assuming another extension isn't already using this tag).

<youtube>https://www.youtube.com/watch?v=pSsYTj9kCHE</youtube>

Attributes for parser tags

Attribute	Description
service="(See Supported Services below.)"	Required: yes The video service to call.
id="[id|url]"	Required: yes The raw ID of the video or URL from the player page.
dimensions="[WIDTH|WIDTHxHEIGHT|xHEIGHT]"	Required: no, Default: 640 Dimensions in pixels to size the embed container. The standard format is width x height where either can be omitted, but the x must proceed height to indicate it as the height. Examples: 480, 480x320, x320. If the height is not provided it will be calculated automatically from the width and service default ratio. Some services such as Gfycat do not have standard heights and should be specified for each embed. $wgEmbedVideoDefaultWidth can be set in LocalSettings.php to override the default width.
alignment="[left|center|right|inline]"	Required: no, Default: none Align the placement of the video either to the left, centered, or to the right. Inline will allow multiple videos to display side by side without forced line breaks.
description="[wiki text]"	Required: no, Default: none Display a description under the embed container.
container="[frame]"	Required: no, Default: none Specifies the container type to use for the embed. frame: Wrap the video player in a Mediawiki thumbnail box.
urlargs="modestbranding=1&version=3"	Required: no, Default: none Allows extra URL arguments to be appended to the generated embed URL. This is useful for obscure options only supported on one service.
autoresize="false"	Required: no, Default: true Automatically resize videos when their size will cause them to break outside of their container element.
valignment="[top|middle|bottom|baseline]"	Required: no, Default: none Align the vertical placement of the video either to the top, middle, bottom, or baseline of the parent element. Using this parameter forces the alignment parameter to be inline.

Examples

File:EmbedVideoExample1.jpg

Example #1

For example, a video from YouTube uses the 'youtube' service selector. You can specify either the raw ID:

{{#ev:youtube|pSsYTj9kCHE}}

Or specify the full URL:

{{#ev:youtube|https://www.youtube.com/watch?v=pSsYTj9kCHE}}

File:EmbedVideoExample2.jpg

Example #2

To display the same video as a right aligned large thumbnail with a description:

{{#ev:youtube|https://www.youtube.com/watch?v=pSsYTj9kCHE|1000|right|Let eet GO|frame}}

For YouTube to have the video start at a specific time code utilize the urlargs(URL arguments) parameter. Take the rest of the URL arguments from the custom URL and place them into the urlargs. Please note that not all video services support extra URL arguments or may have different keys for their URL arguments.

https://www.youtube.com/watch?v=pSsYTj9kCHE&start=76

{{#ev:youtube|https://www.youtube.com/watch?v=pSsYTj9kCHE|||||start=76}}

URL arguments can be used to chop up a video and loop it:

https://www.youtube.com/watch?v=pSsYTj9kCHE&start=160&end=180&loop=1

{{#ev:youtube|https://www.youtube.com/watch?v=pSsYTj9kCHE|||||start=160&end=180&loop=1}}

Supported services

As of version 2.x, EmbedVideo supports embedding video content from the following services:

Site	Service name(s)	ID example	URL example(s)	Notes
Archive.org Videos	archiveorg	electricsheep-flock-244-80000-6	https://archive.org/embed/electricsheep-flock-244-80000-6
Bambuser	bambuser	5262334	http://bambuser.com/v/5262334	Broadcasts
	bambuser_channel			Channels
Beam	beam	RocketBear	https://beam.pro/RocketBear	Streams
Bing	bing	31ncp9r7l	http://www.bing.com/videos/watch/video/adorable-cats-attempt-to-eat-invisible-tuna/31ncp9r7l
Blip.tv	blip		http://blip.tv/vinylrewind/review-6864612	Blip requires the full URL to the video page and does not accept the raw ID.
C3TV	mediacccde	32c3-7305-quantum_cryptography	https://media.ccc.de/v/32c3-7305-quantum_cryptography
CollegeHumor	collegehumor	6875289	http://www.collegehumor.com/video/6875289/batman-says-his-goodbyes
Dailymotion	dailymotion	x1adiiw_archer-waking-up-as-h-jon-benjamin_shortfilms	http://www.dailymotion.com/video/x1adiiw_archer-waking-up-as-h-jon-benjamin_shortfilms
Daum TVPot	tvpot - Obtain the URL or ID from the share menu URL.	s9011HdLzYwpLwBodQzCHRB	http://tvpot.daum.net/v/s9011HdLzYwpLwBodQzCHRB
Div Share	divshare
Edutopia				Edutopia content moved to YouTube. Please use the YouTube service selector below.
FunnyOrDie	funnyordie	c61fb67ac9	http://www.funnyordie.com/videos/c61fb67ac9/to-catch-a-predator-elastic-heart-edition
Gfycat	gfycat	BruisedSilentAntarcticfurseal	http://www.gfycat.com/BruisedSilentAntarcticfurseal
Hitbox	hitbox	Washuu	http://www.hitbox.tv/Washuu
JW Player	jwplayer	cr5d8nbu-8ZpoNmmJ	https://content.jwplatform.com/players/cr5d8nbu-8ZpoNmmJ.html
Kickstarter	kickstarter	elanlee/exploding-kittens	https://www.kickstarter.com/projects/elanlee/exploding-kittens
Metacafe	metacafe	11404579	http://www.metacafe.com/watch/11404579/lan_party_far_cry_4/
Nico Nico Video	nico	sm24394325	http://www.nicovideo.jp/watch/sm24394325
RuTube	rutube	b698163ccb67498db74d50cb0f22e556	http://rutube.ru/video/b698163ccb67498db74d50cb0f22e556/
SoundCloud	soundcloud		https://soundcloud.com/skrillex/skrillex-rick-ross-purple-lamborghini	SoundCloud requires the full URL.
TeacherTube	teachertube	370511	http://www.teachertube.com/video/thats-a-noun-sing-along-hd-version-370511
TED Talks	ted	bruce_aylward_humanity_vs_ebola_the_winning_strategies_in_a_terrifying_war	http://www.ted.com/talks/bruce_aylward_humanity_vs_ebola_the_winning_strategies_in_a_terrifying_war
Tubi TV	tubitv	318409	http://tubitv.com/video/318409
Tudou	tudou	mfQXfumwiew	http://www.tudou.com/listplay/mfQXfumwiew.html
Twitch	twitch	twitchplayspokemon	http://www.twitch.tv/twitchplayspokemon	Live Streams
	twitchvod			Archived Videos on Demand
Videomaten	videomaten
Vimeo	vimeo	105035718	http://vimeo.com/105035718
Vine	vine	h2B7WMtuX2t	https://vine.co/v/h2B7WMtuX2t
Yahoo Screen	yahoo	katy-perry-dances-sharks-2015-024409668	https://screen.yahoo.com/videos-for-you/katy-perry-dances-sharks-2015-024409668.html
YouTube	youtube	pSsYTj9kCHE	https://www.youtube.com/watch?v=pSsYTj9kCHE	Single videos
	youtubeplaylist		https://www.youtube.com/watch?v=CW_PbErQ_c8&list=PL76E80C7F756A2047	Playlists
	youtubevideolist		https://www.youtube.com/watch?v=CW_PbErQ_c8&playlist=CW_PbErQ_c8,CW_PbErQ_c8	Video list
Youku	youku	XODc3NDgzMTY4	http://v.youku.com/v_show/id_XODc3NDgzMTY4.html