YouTube in Confluence macro usage
- David Simpson
This app has been retired from the Atlassian Marketplace
See the announcement blogpost – We're retiring YouTube in Confluence – for more information.
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=30Note that the start time is in seconds only, e.g. Example: | |
| https://youtube.com/v/{}
https://www.youtube.com/v/{} | |
| Note that the start time is in seconds only, e.g. | |
Short link video URLs | Example: | |
Short link video URLs with a specific start time | Note that the start time is in seconds only, e.g. | |
Playlist URLs | Example: | |
Embed URLs | ||
Embed URLs with a specific start time | Note that the start time is in seconds only, e.g. | |
Embed playlist URLs | Example: |
Â
Main website • Support • Service Status