Embedding video

This article provides guidance on embedding video content in your article by using an embedded player. Embedding a video might be a good option if you prefer to keep the reader on your page, rather than providing a link to watch the video on another site or page. For information about the various types and professional creation of video, see the style guidelines for video.


Organizations in Microsoft might have different standards for naming media files, for placing the files within repositories or on streaming media services, and for referencing those files. The following sections provide a best-practice approach, with organization-specific guidance where appropriate.

Embedding a video by using the Docs [!VIDEO] Markdown extension

The Docs site team provides its own [!VIDEO] Markdown extension. It creates the corresponding HTML that's required to play the video via an HTML <iframe> element.


The following example demonstrates a video hosted on Channel 9:

> [!VIDEO https://channel9.msdn.com/Shows/Azure-Friday/Scott-Guthries-demos-Windows-Azure-Active-Directory-in-the-Cloud/player]

The following example demonstrates a video hosted on YouTube:

> [!VIDEO https://www.youtube.com/embed/iAtwVM-Z7rY]

Azure conceptual articles (Microsoft employees)


Although conceptual articles for Azure services have migrated to docs.microsoft.com, videos used in them must continue to be uploaded to Channel 9 and the ACOM video gallery at this time. Please use the following steps to ensure that your video is properly uploaded and published to both Channel 9 and the ACOM video gallery. Use the Docs [!VIDEO] Markdown extension to embed the video in your article.

  1. For instructions on how to upload and publish a video on Channel 9, see Publishing Videos to Channel 9 for Azure.Microsoft.com as prepared by the ACOM web team. The article walks you through the entire process of uploading or updating a video, asynchronous encoding (with email notification upon completion), and publishing to the Channel 9 site.

  2. Import videos into the ACOM video gallery so they can be used with the ACOM video extension. For details, see Import Videos to Azure.Microsoft.com Video Center.‚Äč You will have to wait for a video approver to review and approve the integration request. After the video is ready, you will receive an email notification and you can begin using the ACOM embedded player in your article.


For videos embedded in Azure articles, we see significantly more views for the Channel 9 pages for each video than to the azure.microsoft.com pages that host the Channel 9 videos.

You can look in your Channel 9 Admin dashboard for videos with you tagged as an owner. In your Channel 9 Admin dashboard, select Reports to go to the Channel 9 Reporting site and get more data.

  • For general Markdown-related guidance, refer to the main Markdown article.
  • For style-related guidance geared toward art creation, see Visuals style for video.
  • Resources for Microsoft C+E employees:

    • If you can't find a specific answer/resource, send an email to the C+E CSIVideo@microsoft.com alias.
    • The process for effective localization of closed captions for Channel 9 video--though expensive--is as follows if you need it:

      1. Publish the video to Channel 9.
      2. Give administrative rights to the user: videolocalization@hotmail.com.
      3. Send an e-mail to Cloud & Enterprise International FTE PS csiintlfte@microsoft.com, requesting localization of closed captions.
      4. Depending on the length of your video, it can take 1-3 days for the closed captions to be created, localized, and published.