Vimeo shortcode

Example

To display a Vimeo video with this URL:

https://vimeo.com/19899678

Include this in your Markdown:

{{< vimeo 19899678 >}}

Hugo renders this to:

Arguments

id

(string) The video id. Optional if the id is the first and only positional argument.

allowFullScreen

New in v0.146.0

(bool) Whether the iframe element can activate full screen mode. Default is true.

class

(string) The class attribute of the wrapping div element. Adding one or more CSS classes disables inline styling.

loading

New in v0.146.0

(string) The loading attribute of the iframe element, either eager or lazy. Default is eager.

title

(string) The title attribute of the iframe element.

Here’s an example using some of the available arguments:

{{< vimeo id=19899678 allowFullScreen=false loading=lazy >}}

Privacy

Adjust the relevant privacy settings in your project configuration.

privacy:
  vimeo:
    disable: false
    enableDNT: false
    simple: false

[privacy]
  [privacy.vimeo]
    disable = false
    enableDNT = false
    simple = false

{
   "privacy": {
      "vimeo": {
         "disable": false,
         "enableDNT": false,
         "simple": false
      }
   }
}

disable

(bool) Whether to disable the shortcode. Default is false.

enableDNT

(bool) Whether to block the Vimeo player from tracking session data and analytics. Default is false.

simple

(bool) Whether to enable simple mode. If true, the video thumbnail is fetched from Vimeo and overlaid with a play button. Clicking the thumbnail opens the video in a new Vimeo tab. Default is false.

The source code for the simple version of the shortcode is available in this file.