(video: …)
Embeds a video from YouTube, Vimeo or a local file by URL or filename
Attributes
| autoplay |
| caption |
| controls |
| class |
| height |
| loop |
| muted |
| poster |
| preload |
| style |
| width |
Supported video sources
YouTube
Embedded YouTube video by video URL:
(video: http://www.youtube.com/watch?v=lLuc6rtWkrM)The following link YouTube link formats are recognized:
Basic video URLs:
- https://www.youtube.com/watch?v=lLuc6rtWkrM
- https://www.youtube.com/embed/lLuc6rtWkrM
- https://youtu.be/lLuc6rtWkrM
- https://www.youtube-nocookie.com/embed/d9NF2edxy-M
Since 3.4.0
URLs with additional query parameters:
- https://www.youtube.com/watch?v=d9NF2edxy-M&t=10
- https://www.youtube-nocookie.com/watch?v=d9NF2edxy-M&t=10
- https://www.youtube.com/embed/d9NF2edxy-M?start=10
- https://www.youtube-nocookie.com/embed/d9NF2edxy-M?start=10
Playlists:
- https://www.youtube.com/embed/videoseries?list=PLj8e95eaxiB9goOAvINIy4Vt3mlWQJxys
- https://www.youtube-nocookie.com/embed/videoseries?list=PLj8e95eaxiB9goOAvINIy4Vt3mlWQJxys
- https://www.youtube.com/playlist?list=PLj8e95eaxiB9goOAvINIy4Vt3mlWQJxys
- https://www.youtube-nocookie.com/playlist?list=PLj8e95eaxiB9goOAvINIy4Vt3mlWQJxys
Vimeo
Embedded Vimeo video by video URL:
(video: http://vimeo.com/3432886)Since 3.5.5
Local and remote videos
You can now embed videos from the local or from remote servers.
# local
(video: local-video.mp4)
# remote
(video: https://example.com/sample-video.mp4)The video will be muted automatically if autoplay is enabled and muted is not defined. To start autoplay with sound, use it as in the following example:
(video: local-video.mp4 autoplay: true muted: false)Options
Caption
(video: http://youtu.be/lLuc6rtWkrM caption: This is a really nice video)<iframe> size
(video: http://vimeo.com/3432886 width: 300 height: 200)Custom CSS class
(video: http://youtu.be/lLuc6rtWkrM class: myvideo)Since 3.5.5
New attributes
The video tag now supports some attributes of the HTML <video> element: autoplay, controls, loop, muted, poster, preload
(video: local-video.mp4 autoplay: true)
(video: local-video.mp4 controls: false autoplay: true loop: true)
(video: local-video.mp4 poster: cover.jpg)
(video: local-video.mp4 preload: auto)
(video: https://example.com/sample-video.mp4 muted: true controls: false autoplay: true)
(video: local-video.mp4 poster: https://example.com/sample-cover.jpg)These new attributes are not supported by video providers such as YouTube and Vimeo.
Version 2's youtube and vimeo tags
To keep your content compatible with older Kirby versions, we still have the old youtube and vimeo KirbyTags. We recommend switching to the new video tag though.