Inserting a Video

You can insert videos in your topics if you publish to HTML or HTML5, and have the video show up embedded and watchable directly in your publication. You can use videos on YouTube, Vimeo, Wistia, or Microsoft Stream out of the box. Other services or solutions may require customization.

(Microsoft Stream videos require that the user has an account to view the video.)


Even if you publish to PDF as well, the video will appear, but then as a hyperlink to the video. By default the link text will simply display the url, but you can if you want add a caption in your mediaobject element, an alternative image to display, or the alt or textobject elements (if you don't want a caption in HTML output).

  1. Click the video icon in the toolbar: image of video icon.

    A video frame appears.

  2. Click the frame to display a popup toolbar, and insert the link to the video.

    • For YouTube, use the Share link.

    • For Vimeo just use the web url in the browser address field.

    • For Wistia, you can use either the regular Inline embed, or the iFrame (fallback) embed link:

      Only get the url from the src attribute in the script tag (ending with .jsonp), or the src attribute in the iframe element for the iFrame fallback version. Read more about the types here: Inline embedFallback (iframe) Embed.


      The Wistia video embed is by default responsive, adapting to the size of the screen. But it has a default max-width value set to 620px. If you want to change that default width, override this property in your CSS:

          max-width: 620px; 

      If you want it to utilize the entire screen space, just set the value to none.

  3. Save, and the preview of the video appears for YouTube and Vimeo videos.

    Microsoft Stream and Wistia currently do not show you the preview in the editor, but will work just fine when you publish.


When you publish to HTML or HTML5 you should now see the video embedded in your content.


If you are publishing videos to Zendesk, but cannot see them, you need to enable videos in the Zendesk settings: Why are videos not displaying in Help Center?

Setting options like autoplay and start time

It is also possible to set options for your video, for some of the available video formats. For example if you want the video to start playing as soon as the page is viewed, or if you want it to start at a particular time into the video. This is done a bit differently depending on what video platform you use:

Procedure. YouTube
  1. Add a "querystring" at the end of the embedcode, e.g ?autoplay=1 to autoplay the video.

  2. To add more than one option, add them with an ampersand after the first option, e.g ?autoplay=1&start=34. Note that the start time option does not use any unit, just specify it as the number of seconds.


    See YouTube Embedded Players and Player Parameters for a complete list of possible options.

Procedure. Vimeo
  • Set options the same way as for YouTube videos, with the exception that start time uses a hash (#) instead of a question mark or ampersand (for example, #t=1m2s)


    See Using Player Parameters for a complete list of possible options.

Procedure. Wistia
  1. Add an autoplay attribute.

    (Note that it is used for more options than just autoplay)

  2. Set the options according to the format specified by Wistia, but separated with semicolons, e.g autoPlay=true;time=0m34s to set it to autoplay and start at 34 seconds in. Take care to use the correct capitalization of the properties.


    See Embed Options and Plugin for a complete list of possible options.