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.
Macro Parameters
Macro Parameter Name | Description |
|---|---|
Width | Defaults to full width, but can be specified as a pixel value e.g. 600 |
Height | Defaults to 600 pixels, but can be specified as a pixel value e.g. 400 |
Aspect Ratio | Use this instead of a height to maintain correct aspect ratios at all screen sizes. There are a variety of aspect ratio, but the most common are:
|
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={}
| |
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. Example: | |
| https://youtube.com/v/{}
https://www.youtube.com/v/{}
| |
| https://youtube.com/v/{}?start=30
https://www.youtube.com/v/{}?start=30
Note that the start time is in seconds only, e.g. | |
Short link video URLs | https://youtu.be/{}
Example: | |
Short link video URLs with a specific start time | https://youtu.be/{}?start=30
Note that the start time is in seconds only, e.g. | |
Playlist URLs | https://youtube.com/playlist?list={}
https://www.youtube.com/playlist?list={}
Example: | |
Embed URLs | https://youtube.com/embed/{}
https://www.youtube.com/embed/{}
| |
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. | |
Embed playlist URLs | https://youtube.com/embed/videoseries?list={}
https://www.youtube.com/embed/videoseries?list={}
Example: |