Template:YouTube

Video on YouTube

Template documentation[view] [edit] [history] [purge]

For the navigation template, see Template:YouTube navbox.

This template is used to create an external link to YouTube in the ==External links== section. It may also be used for other YouTube links such as those in {{External media}}.

This is not a citation template. Use {{cite AV media}} to provide bibliographic citations in footnotes. Alternatively, use {{cite news}} if the video is a newscast, or {{cite episode}} if the video is in an episodic format.

Note that this template makes it clear that it "has" various Wikidata property elements, it does not automatically "use" the information stored in Wikidata – the VIDEOID, CHANNELID, HANDLE, USERNAME, SHOWID or PLAYLISTID alphanumeric parameters mentioned below must be entered by hand in the template.

Usage and examples

Video

Usage (one parameter):

• {{YouTube|VIDEOID}}
• {{YouTube|id=VIDEOID}}

Usage (two parameters):

• {{YouTube|VIDEOID|TITLE}}
• {{YouTube|id=VIDEOID|title=TITLE}}

Parameter descriptions:

• id (or unnamed parameter 1) is the "YouTube video id" which appears as:

  https://www.youtube.com/watch?v=VIDEOID

• title (or unnamed parameter 2) gives an optional description that may replace the default title (Video)

Examples (1 parameter):

https://www.youtube.com/watch?v=9bZkp7q19f0

1. * {{YouTube|9bZkp7q19f0}}
   • Video on YouTube
2. * {{YouTube|id=9bZkp7q19f0}}
   • Video on YouTube

Examples (2 parameters):

1. * {{YouTube|9bZkp7q19f0|"Gangnam Style"}}
   • "Gangnam Style" on YouTube
2. * {{YouTube|id=9bZkp7q19f0|title="Gangnam Style"}}
   • "Gangnam Style" on YouTube

With timestamp

Usage:

• {{YouTube|id=VIDEOID|time=TIMESTAMP}}
• {{YouTube|id=VIDEOID|t=TIMESTAMP}}

Parameter descriptions:

• time or t is the timestamp within the video for the link target.

Examples:

• {{YouTube|id=9bZkp7q19f0|time=3m2s}}
• {{YouTube|id=9bZkp7q19f0|time=122}}
• {{YouTube|id=9bZkp7q19f0|t=3m2s}}

Channel

With channel ID

Usage (one parameter):

• {{YouTube|c=CHANNELID}}
• {{YouTube|channel=CHANNELID}}

Usage (two parameters):

• {{YouTube|c=CHANNELID|TITLE}}
• {{YouTube|c=CHANNELID|title=TITLE}}
• {{YouTube|channel=CHANNELID|TITLE}}
• {{YouTube|channel=CHANNELID|title=TITLE}}

Parameter descriptions:

• c or channel is the "YouTube channel id" which appears as:

  https://www.youtube.com/channel/CHANNELID

• title gives an optional description that may replace the default title (PAGENAME)

Examples (1 parameter):

https://www.youtube.com/channel/UC-9-kyTW8ZkZNDHQJ6FgpwQ

1. * {{YouTube|c=UC-9-kyTW8ZkZNDHQJ6FgpwQ}}
   • PAGENAME's channel on YouTube
2. * {{YouTube|channel=UC-9-kyTW8ZkZNDHQJ6FgpwQ}}
   • PAGENAME's channel on YouTube

Example (2 parameters):

1. * {{YouTube|c=UC-9-kyTW8ZkZNDHQJ6FgpwQ|#Music}}

   #Music's channel on YouTube

2. * {{YouTube|channel=UC-9-kyTW8ZkZNDHQJ6FgpwQ|title=#Music}}
   • #Music's channel on YouTube

With handle

Usage (one parameter):

• {{YouTube|h=HANDLE}}
• {{YouTube|handle=HANDLE}}

Usage (two parameters):

• {{YouTube|h=HANDLE|TITLE}}
• {{YouTube|h=HANDLE|title=TITLE}}
• {{YouTube|handle=HANDLE|TITLE}}
• {{YouTube|handle=HANDLE|title=TITLE}}

Parameter descriptions:

• h or handle is the "YouTube channel handle" which appears as:

  https://www.youtube.com/@HANDLE

• title gives an optional description that may replace the default title (PAGENAME)
• suffix replaces the default " 's " after the channel name. It is only to be used in the rare occasion that the channel name is a compound noun ending in S, and making it possessive does not repeat the S sound. Do not use it for a brand name ending in S, for example Smosh Games, which is a singular entity. See MOS:POSS for more information.

Examples (1 parameter):

https://www.youtube.com/@PewDiePie

1. * {{YouTube|h=PewDiePie}}
   • PAGENAME's channel on YouTube
2. * {{YouTube|handle=PewDiePie}}
   • PAGENAME's channel on YouTube

Example (2 parameters):

1. * {{YouTube|h=PewDiePie|PewDiePie}}
   • PewDiePie's channel on YouTube
2. * {{YouTube|handle=PewDiePie|title=PewDiePie}}
   • PewDiePie's channel on YouTube

Example (3 parameters):

https://www.youtube.com/@officialBEG

1. * {{YouTube|handle=officialBEG|title=Brown Eyed Girls|suffix='}}
   • Brown Eyed Girls' channel on YouTube

With legacy username

Usage (one parameter):

• {{YouTube|u=USERNAME}}
• {{YouTube|user=USERNAME}}

Usage (two parameters):

• {{YouTube|u=USERNAME|TITLE}}
• {{YouTube|u=USERNAME|title=TITLE}}
• {{YouTube|user=USERNAME|TITLE}}
• {{YouTube|user=USERNAME|title=TITLE}}

Parameter descriptions:

• u or user is the "YouTube channel user's name" which appears as:

  https://www.youtube.com/user/USERNAME

• title gives an optional description that may replace the default title (PAGENAME)
• suffix replaces the default " 's " after the channel name. It is only to be used in the rare occasion that the channel name is a compound noun ending in S, and making it possessive does not repeat the S sound. Do not use it for a brand name ending in S, for example Smosh Games, which is a singular entity. See MOS:POSS for more information.

Examples (1 parameter):

https://www.youtube.com/user/pewdiepie

1. * {{YouTube|u=pewdiepie}}
   • PAGENAME's channel on YouTube
2. * {{YouTube|user=pewdiepie}}
   • PAGENAME's channel on YouTube

Example (2 parameters):

1. * {{YouTube|u=pewdiepie|PewDiePie}}
   • PewDiePie's channel on YouTube
2. * {{YouTube|user=pewdiepie|title=PewDiePie}}
   • PewDiePie's channel on YouTube

Example (3 parameters):

https://www.youtube.com/user/officialBEG

1. * {{YouTube|user=officialBEG|title=Brown Eyed Girls|suffix='}}
   • Brown Eyed Girls' channel on YouTube

With custom URL

Usage (one parameter):

• {{YouTube|custom=CUSTOMURL}}

Usage (two parameters):

• {{YouTube|custom=CUSTOMURL|TITLE}}
• {{YouTube|custom=CUSTOMURL|title=TITLE}}

Parameter descriptions:

• custom is the "YouTube channel custom URL" which appears as:

  https://www.youtube.com/c/CUSTOMURL

• title gives an optional description that may replace the default title (PAGENAME)

Example (1 parameter):

https://www.youtube.com/c/officialBEG

1. * {{YouTube|custom=officialBEG}}
   • PAGENAME's channel on YouTube

Example (2 parameters):

1. * {{YouTube|custom=officialBEG|Brown Eyed Girls}}

   Brown Eyed Girls's channel on YouTube

Show

Usage (one parameter):

• {{YouTube|s=SHOWID}}
• {{YouTube|show=SHOWID}}

Usage (two parameters):

• {{YouTube|s=SHOWID|TITLE}}
• {{YouTube|s=SHOWID|title=TITLE}}
• {{YouTube|show=SHOWID|TITLE}}
• {{YouTube|show=SHOWID|title=TITLE}}

Parameter descriptions:

• s or show is the "YouTube show name" which appears as:

  https://www.youtube.com/show/SHOWID

• title gives an optional description that may replace the default title (PAGENAME)

Examples (1 parameter):

https://www.youtube.com/show/SCWdVLvom3QaFGxEKNASntaA

1. * {{YouTube|s=SCWdVLvom3QaFGxEKNASntaA}}
   • PAGENAME show on YouTube
2. * {{YouTube|show=SCWdVLvom3QaFGxEKNASntaA}}
   • PAGENAME show on YouTube

Example (2 parameters):

1. * {{YouTube|s=SCWdVLvom3QaFGxEKNASntaA|Star Trek: The Original Series}}
   • Star Trek: The Original Series show on YouTube
2. * {{YouTube|show=SCWdVLvom3QaFGxEKNASntaA|title=Star Trek: The Original Series}}
   • Star Trek: The Original Series show on YouTube

Playlist

Usage (one parameter):

• {{YouTube|p=PLAYLISTID}}
• {{YouTube|playlist=PLAYLISTID}}

Usage (two parameters):

• {{YouTube|p=PLAYLISTID|TITLE}}
• {{YouTube|p=PLAYLISTID|title=TITLE}}
• {{YouTube|playlist=PLAYLISTID|TITLE}}
• {{YouTube|playlist=PLAYLISTID|title=TITLE}}

Parameter descriptions:

• p or playlist is the "YouTube playlist id" which appears as:

  https://www.youtube.com/playlist?list=PLAYLISTID

• title gives an optional description that may replace the default title (PAGENAME)

Examples (1 parameter):

https://www.youtube.com/playlist?list=PLrEnWoR732-DZV1Jc8bUpVTF_HTPbywpE

1. * {{YouTube|p=PLrEnWoR732-DZV1Jc8bUpVTF_HTPbywpE}}
   • PAGENAME playlist on YouTube
2. * {{YouTube|playlist=PLrEnWoR732-DZV1Jc8bUpVTF_HTPbywpE}}
   • PAGENAME playlist on YouTube

Example (2 parameters):

1. * {{YouTube|p=PLrEnWoR732-DZV1Jc8bUpVTF_HTPbywpE|Learn Something New}}
   • Learn Something New playlist on YouTube
2. * {{YouTube|playlist=PLrEnWoR732-DZV1Jc8bUpVTF_HTPbywpE|title=Learn Something New}}
   • Learn Something New playlist on YouTube

Suppress wikilink

The link to YouTube can be suppressed with the parameter |link=no. Example:

* {{YouTube|9bZkp7q19f0|"PSY - GANGNAM STYLE(강남스타일) M/V"|link=no}}

• "PSY - GANGNAM STYLE(강남스타일) M/V" on YouTube

No ID in template

The template will display an error message if no parameters are provided.

* {{YouTube}}

• on YouTube

It will display an error message if the parameter provided is not known.

* {{YouTube|ID=test}}

• on YouTube

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:YouTube in articles based on its TemplateData.

TemplateData for YouTube

Use this to create an external link to YouTube in the External links section. This is not a citation template.

Template parameters[Edit template data]

This template prefers inline formatting of parameters.

Parameter		Description	Type	Status
YouTube video id	id 1	The video id which appears after https://www.youtube.com/watch?v= in the URL Example 9bZkp7q19f0	String	suggested
Timestamp	time t	The timestamp within the video for the link target; usually appears after &t= in the full URL or ?t= in a shortened URL Example 3m2s	String	optional
YouTube channel id	channel c	The channel id which appears after https://www.youtube.com/channel/ in the URL Example UC-9-kyTW8ZkZNDHQJ6FgpwQ	String	suggested
YouTube channel handle	handle h	The user name which appears after https://www.youtube.com/@ in the URL Example PewDiePie	String	optional
YouTube legacy username	user u	The user name which appears after https://www.youtube.com/user/ in the URL Example pewdiepie	String	optional
YouTube channel custom URL fragment slug	custom	The channel custom URL slug which appears after https://www.youtube.com/c/ in the URL Example youtube	String	optional
YouTube show id	show s	The show id which appears after https://www.youtube.com/show/ in the URL Example SCWdVLvom3QaFGxEKNASntaA	String	suggested
YouTube playlist id	playlist p	The playlist id which appears after https://www.youtube.com/playlist?list= in the URL Example PLrEnWoR732-DZV1Jc8bUpVTF_HTPbywpE	String	suggested
Title	title 2	The name of the page being linked to Default If it is a video, Video, if it is a show, the article's page name in italics, otherwise, the article's page name unformatted Example Gangnam Style	String	suggested
Channel title suffix	suffix	Text immediately after the channel title. It is only to be used in the rare occasion that the channel title is a compound noun ending in S, and making it possessive does not repeat the S sound. Default 's Example '	String	optional
Link on	link	Set this parameter to no to suppress the link to the YouTube article Example no	String	optional

Tracking categories

• Category:Articles using YouTube with invalid parameters (0) – list of pages using this template with too many parameters, or with invalid text in the |title= parameter.
• Category:Pages using YouTube with unknown parameters (0) – list of pages using this template with unsupported parameters.

See also

• {{External media}} – to link to external media, including YouTube videos
• {{Cite AV media}} – to cite a video
• {{Cite news}} – to cite a newscast
• {{Cite episode}} – to cite an episode of a show
• {{Cite serial}} – to cite a serial of a show
• {{YouTube navbox}} – navigation box for YouTube related articles
• WP:YOUTUBE – YouTube linking guideline
• Wikipedia:WikiProject Internet culture – Wikiproject covering YouTube personalities and videos
• All Wikipedia pages linked to http://*.youtube.com and to https://*.youtube.com
• Search for Wikipedia articles using this template as a reference

The above documentation is transcluded from Template:YouTube/doc. (edit | history)
Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages.
Add categories to the /doc subpage. Subpages of this template.