Version 4 supported
This version of Silverstripe CMS is still supported though will not receive any additional features. Go to documentation for the most recent stable version.

Embedding media

To add media such as a video into a page, you should first upload it to a video hosting service such as YouTube or Vimeo. This means they will take care of everything involved in insuring the video will play on a wide range of devices such as computers, tablets & mobile devices.

YouTube allows you to mark a video as Unlisted so that it will not appear on YouTube.com search results etc. Also adverts will not be displayed on your video unless you enable that option from within YouTube.

This feature isn't just limited to video, you can also embed Flickr slideshows and other embeddable widgets this way, if they support the 'oEmbed' standard.

You can upload your video to one of the supported media services (many of the services that support oEmbed protocol can be handled in this way):

  • YouTube
  • Twitter
  • Flickr
  • Vimeo
  • Viddler
  • Revision3
  • Hulu

Insert Media via URL

  1. Upload your media to a hosting service.
  2. While viewing your video, copy the full URL of the page, by selecting the full address at the top of your browser or right click and copy the URL.
  3. While editing a pages content, position your cursor where you'd like the video to appear.
  4. Click the button Insert media from URL which is shown as a media icon in the HTML editor.
  5. Paste the full URL of your video into the empty field.
  6. Click the button Add media.
  7. You can edit the following specifications for your video:
  • Caption
  • Placement
  • Dimensions
  1. Click the button Insert media.
  2. Click the button Publish to make your changes live.

Media metadata caching

Metadata such as the media title or dimensions from the media service may be cached (saved) on your website so that it loads faster for visitors.

If you change the source media in some way (for example, changing the title), you may need to clear the cached metadata to see this change reflected on your website. You can do this by re-saving or publishing a page containing the embedded media. This will correct any pages containing that media.

To edit the embedded media further, select the media in the HTML editor and click the button Insert media from URL.

Edit on Github