 | Do not use this template to link to material that violates copyright law. Links to such material must either be replaced with a non-copyvio link or removed immediately. NOTE: A YouTube video uploaded by a user with a verification check mark badge, indicating that it is an official channel of an established creator or organization, does not fully guarantee that it complies with copyright and fair use laws. |
 | This template is used on approximately 64,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them. |
 | This template should not be used in citation templates such as Citation Style 1 and Citation Style 2, because it includes markup that will pollute the COinS metadata they produce; see Wikipedia:COinS. |
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.
Usage and examples
Video
YouTube video ID (P1651) (see uses)
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):
Examples (2 parameters):
* ((YouTube|9bZkp7q19f0|"Gangnam Style"))* ((YouTube|id=9bZkp7q19f0|title="Gangnam Style"))
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):
* ((YouTube|c=UC-9-kyTW8ZkZNDHQJ6FgpwQ))* ((YouTube|channel=UC-9-kyTW8ZkZNDHQJ6FgpwQ))
Example (2 parameters):
* ((YouTube|c=UC-9-kyTW8ZkZNDHQJ6FgpwQ|#Music))* ((YouTube|channel=UC-9-kyTW8ZkZNDHQJ6FgpwQ|title=#Music))
With handle
- YouTube handle (P11245) (see uses)
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):
* ((YouTube|h=PewDiePie))* ((YouTube|handle=PewDiePie))
Example (2 parameters):
* ((YouTube|h=PewDiePie|PewDiePie))* ((YouTube|handle=PewDiePie|title=PewDiePie))
Example (3 parameters):
* ((YouTube|handle=officialBEG|title=Brown Eyed Girls|suffix='))
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):
* ((YouTube|u=pewdiepie))* ((YouTube|user=pewdiepie))
Example (2 parameters):
* ((YouTube|u=pewdiepie|PewDiePie))* ((YouTube|user=pewdiepie|title=PewDiePie))
Example (3 parameters):
* ((YouTube|user=officialBEG|title=Brown Eyed Girls|suffix='))
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):
* ((YouTube|custom=officialBEG))
Example (2 parameters):
* ((YouTube|custom=officialBEG|Brown Eyed Girls))
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):
* ((YouTube|s=SCWdVLvom3QaFGxEKNASntaA))* ((YouTube|show=SCWdVLvom3QaFGxEKNASntaA))
Example (2 parameters):
* ((YouTube|s=SCWdVLvom3QaFGxEKNASntaA|Star Trek: The Original Series))* ((YouTube|show=SCWdVLvom3QaFGxEKNASntaA|title=Star Trek: The Original Series))
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):
* ((YouTube|p=PLrEnWoR732-DZV1Jc8bUpVTF_HTPbywpE))* ((YouTube|playlist=PLrEnWoR732-DZV1Jc8bUpVTF_HTPbywpE))
Example (2 parameters):
* ((YouTube|p=PLrEnWoR732-DZV1Jc8bUpVTF_HTPbywpE|Learn Something New))- Learn Something New playlist on YouTube
* ((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))
It will display an error message if the parameter provided is not known.
* ((YouTube|ID=test))
TemplateData
TemplateData for YouTube
Use this to create an external link to YouTube in the External links section. This is not a citation template.
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| YouTube video id | id 1 | The video id which appears after https://www.youtube.com/watch?v= in the URL
| 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
| String | optional |
| YouTube channel id | channel c | The channel id which appears after https://www.youtube.com/channel/ in the URL
| String | suggested |
| YouTube channel handle | handle h | The user name which appears after https://www.youtube.com/@ in the URL
| String | optional |
| YouTube legacy username | user u | The user name which appears after https://www.youtube.com/user/ in the URL
| 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
| String | optional |
| YouTube show id | show s | The show id which appears after https://www.youtube.com/show/ in the URL
| String | suggested |
| YouTube playlist id | playlist p | The playlist id which appears after https://www.youtube.com/playlist?list= in the URL
| String | suggested |
| Title | title 2 | The name of the page being linked to
| 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.
| String | optional |
| Link on | link | Set this parameter to no to suppress the link to the YouTube article
| String | optional |
Tracking categories
- Category:Articles using YouTube with invalid parameters (28) – 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