Videos

Videos help you explain steps, walkthroughs, and complex concepts more clearly than text alone, and they keep readers engaged longer while working through an article. In Document360, you can add videos directly to an article or category page using the Insert video () and Insert file () options in the toolbar. You can add a video from a hosting platform such as YouTube, Wistia, or Vimeo, or upload one from Drive. This article covers how to insert a video in the Markdown editor and the Advanced WYSIWYG editor, and how to resolve a common Vimeo embed issue.

Insert video in Editor article

1. Navigate to the desired article in the Advanced WYSIWYG editor.
2. Use the Slash command /video and select Video. The Insert video panel appears with the following options:
   • Embed URL:
     • Enter video URL: Paste a self-hosted video URL from a platform such as Wistia, YouTube, or Vimeo, then update the pixel height and width in the editor.
     • Enter embed URL: Paste the URL available on the video hosting platform.
   • Embed code: Paste the embed code snippet provided by platforms such as Wistia, YouTube, or Vimeo.
   • Drive: Choose a video already stored in Drive.
3. Once the video uploads, a preview appears in the editor.

The video is now added to the article.

Insert video Markdown editor

You can insert a video in the Markdown editor in two ways: by pasting a video URL, or by selecting a video already available in Drive.

Insert a video by URL

1. Navigate to the desired article in the Markdown editor.
2. Select the Insert video () icon in the toolbar. The Insert video panel appears.
3. Paste the video URL (YouTube, Wistia, or Vimeo) in the first text field.
4. Enter an alternative text for the video in the Alt Text field.
5. Select OK.

Insert a video from Drive

1. Navigate to the desired article in the Markdown editor.
2. Select the Insert file () icon in the toolbar.
3. Select the desired video from Drive and select Insert.
4. Update the pixel height and width as needed.

Best practices

• Use the Insert URL/Embed URL option for hosted videos (YouTube, Wistia, Vimeo) instead of pasting a full embed snippet with wrapper tags, since Document360 only supports the <iframe> tag.
• Before publishing, test any pasted embed code to confirm slash commands, image editing, and other content blocks still work correctly in the article.
• Use the link analytics feature to periodically check for broken video links across your articles.
• Add descriptive alt text whenever you insert a video, for accessibility and search.

Troubleshooting

Unable to insert a Vimeo video using the embed code

To successfully insert a Vimeo video:

1. Remove unsupported tags: Keep only the <iframe> tag from the Vimeo embed code.
2. Set position to "relative": Adjust the position setting so the video is responsive and displays correctly.

Before (unsupported code):

<div style="padding:56.25% 0 0 0;position:relative;">
  <iframe src="https://player.vimeo.com/video/1053359488?badge=0&autopause=0&player_id=0&app_id=58479"
  frameborder="0" allow="autoplay; fullscreen; picture-in-picture; clipboard-write; encrypted-media"
  style="position:absolute;top:0;left:0;width:100%;height:100%;"
  title="Document360-Microsoft-Customer-Story"></iframe>
</div>
<script src="https://player.vimeo.com/api/player.js"></script>

After (supported code):

<iframe src="https://player.vimeo.com/video/1053359488?badge=0&autopause=0&player_id=0&app_id=58479"
frameborder="0" allow="autoplay; fullscreen; picture-in-picture; clipboard-write; encrypted-media"
style="position:relative;width:100%;height:100%;"
title="Document360-Microsoft-Customer-Story"></iframe>

FAQ