YouTube in Confluence supports embedding individual videos and also playlists.

When you paste a YouTube URL into the Confluence editor it will attempt to generate the correct embed URL and display an embedded video.

Examples of supported YouTube URLs

Description

URL pattern examples

Expected macro output

Normal video URLs

https://youtube.com/watch?v={}
https://m.youtube.com/watch?v={}
https://www.youtube.com/watch?v={}

Example:
https://www.youtube.com/watch?v=FEhPhnkX4SA

Normal videos with a specific start time

https://youtube.com/watch?v={}&start=30
https://m.youtube.com/watch?v={}&start=30
https://www.youtube.com/watch?v={}&start=30

Note that the start time is in seconds only, e.g. &start=30

Example:
https://www.youtube.com/watch?v=1AnG04qnLqI&start=30

/v/ URLs

https://youtube.com/v/{}
https://www.youtube.com/v/{}

Example:
https://www.youtube.com/v/FEhPhnkX4SA

Short link video URLs

https://youtu.be/{}

Example:
https://youtu.be/FEhPhnkX4SA

Playlist URLs

https://youtube.com/playlist?list={}
https://www.youtube.com/playlist?list={}

Example:
https://www.youtube.com/playlist?list=PL-9DkOQ9HIokIRFTQIlSnCIjIRdQcnARw

Embed URLs

https://youtube.com/embed/{}
https://www.youtube.com/embed/{}

Example:
https://www.youtube.com/embed/FEhPhnkX4SA

Embed URLs with a specific start time

https://youtube.com/embed/{}?start=30
https://www.youtube.com/embed/{}?start=30

Note that the start time is in seconds only, e.g. &start=30

Example:
https://www.youtube.com/embed/1AnG04qnLqI?start=30

Embed playlist URLs

https://youtube.com/embed/videoseries?list={}
https://www.youtube.com/embed/videoseries?list={}

Example:
https://www.youtube.com/embed/videoseries?list=PL-9DkOQ9HIokIRFTQIlSnCIjIRdQcnARw