YouTube in Confluence macro usage

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

Description

URL pattern examples

Expected macro output

Normal video URLs

1 2 3 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

1 2 3 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

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

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

/v/ URLs with a specific start time

1 2 https://youtube.com/v/{}?start=30 https://www.youtube.com/v/{}?start=30

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

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

Short link video URLs

1 https://youtu.be/{}

Example:
https://youtu.be/FEhPhnkX4SA

Short link video URLs with a specific start time

1 https://youtu.be/{}?start=30

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

Example:
https://youtu.be/1AnG04qnLqI?start=30

Playlist URLs

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

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

Embed URLs

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

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

Embed URLs with a specific start time

1 2 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

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

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