Filters: oEmbed Filter

Maintained by Picture of James McQuillan James McQuillan, Picture of Mike Churchward Mike Churchward
A filter that will swap hyperlinks pointing towards supported websites with an embedded version using code retrieved from the site using the oEmbed protocol. An option for "Lazy" loading of some sites is also available.
841 sites
15 fans

Using the oEmbed protocol hyperlinks pointing to supported sites will be substituted with an embedded version.

N.B. You may need to disable YouTube and Vimeo in the Admin->Site Administration->Appearance->Media Embedding

This helps send students to videos on external sites but without leaving Moodle and being distracted by other content.

As of 3.2, the media sites that are supported are the ones defined at (JSON: You can also modify or add provider info locally to your site.

See the "README.txt" file for more information on managing providers.

Pre-3.2, the supported sites are:

  • YouTube *
  • Vimeo *
  • Ted *
  • SlideShare
  • Screenr
  • Issuu
  • Poll Everywhere
  • Soundcloud
  • Microsoft Mix
Sites with * also support optional "Lazy" loading. For these sites a thumbnail still of the video is shown that is swapped for the actual video when clicked upon. This speeds up page load times and reduces bandwidth.


This plugin is part of set Office 365.


Screenshot #0
Screenshot #1
Screenshot #2
Screenshot #3


Picture of James McQuillan
James McQuillan (Lead maintainer)
Picture of Mat Cannings
Mat Cannings: Original author
Picture of Vinayak (Vin) Bhalerao
Vinayak (Vin) Bhalerao
Picture of Nima Mojgani
Nima Mojgani: Manager
Picture of Akinsaya Delamarre
Akinsaya Delamarre: Contributor
Picture of Guy Thomas
Guy Thomas: Contributor
Picture of Erich Wappis
Erich Wappis: Contributor
Please login to view contributors details and/or to contact them

Comments RSS

Show comments
  • Picture of Scot Hacker
    Wed, 15 Oct 2014, 3:03 AM
    Has anyone tried this filter on 2.6 (by modifying the stated requirements)? Just curious whether it might "just work" or does it actually need 2.7 ?
  • Picture of erika alarcon
    Fri, 13 Feb 2015, 5:26 AM
    Hi, I tested the filter but doesn't work in my Site. We have Moodle 2.7
    Do I have to configure the text editor?
  • Picture of James McQuillan
    Sat, 14 Feb 2015, 1:17 AM
    Hi Erika - Have you enabled the filter? (Administration block > Site Administration > Plugins > Filters > Manage Filters)
  • Picture of Phuong Hoang
    Sun, 12 Jul 2015, 9:30 PM
    Hi guys,
    First of all, thanks for sharing the wonderful plugin. Everything works well in my site. In my country, Vietnam soundcloud's not popular - this is the first I visit In Vietnam we often listen to music and upload audio files onto Can you do me a favor?
    1. Help me how to add to this plugin? This website has links as (baihat=song)
    2. is the biggest learning community in Vietnam containing numerous learning materials for both students and teachers. How can add this website to your plugin? I often embed materials into my vBulletin website by using link:
    I look forwards to hearing from you soon,
    Thanks in advance
  • Picture of James McQuillan
    Mon, 13 Jul 2015, 12:15 PM
    Hi Phuong - do you know if these sites support oembed?
  • Picture of Phuong Hoang
    Mon, 13 Jul 2015, 6:40 PM
    Hi James,
    Thanks for your reply. Sorry I don't know whether the two websites support oembed or not. However, We embed these materials by using bbcode.
  • Picture of James McQuillan
    Tue, 14 Jul 2015, 1:49 AM
    Thanks Phuong, this plugin uses a standard called oembed to embed content ( You might want to look at the other filter plugins available ( and see whether they might be a better fit for what you're looking for.
  • Picture of Phuong Hoang
    Sun, 19 Jul 2015, 4:24 PM
    Oh, I see. What a pity!
    Thanks anyway,
  • Picture of Daemon Hunt
    Fri, 30 Oct 2015, 2:21 PM
    Sorry this isn't working for me in Moodle 2.9. Have tried everything including disabling YouTube and Vimeo in the Admin->Site Administration->Appearance->Media Embedding. Have moved it up and down in the filter list. Have tried disabling some filters entirely in case of a conflict. Have tried adding my youtube link to a Label, a Description, a Summary... nothing. Will have a good look at the code for this plugin on a rainy day.
  • Picture of James McQuillan
    Wed, 9 Dec 2015, 12:45 PM
    Hi Daemon - can you post some examples of the links you were using to help debug what might be going on? Thanks!
  • Picture of Astrid Callista
    Tue, 29 Mar 2016, 4:00 PM
    Hi, I'm trying to use this for embed soundcloud urls but it shows "Error while accessing the embedded media. Please try refreshing the page."
    I've disabled and even tried uninstalling soundcloud filter but it won't work. Can you help?
    Thank you
  • Picture of Astrid Callista
    Tue, 29 Mar 2016, 4:04 PM
    Sorry, to add to my previous question, this doesn't work if my soundcloud file is set to private so is there a work around for this? Thank you
  • Picture of James McQuillan
    Mon, 4 Apr 2016, 3:32 PM
    It only doesn't work when the media is private? I would imagine that's probably a soundcloud privacy thing, to keep private media private. Are you seeing that for public media?
  • Picture of Peter Sercombe
    Thu, 26 May 2016, 8:29 AM
    I've tried to submit this to the tracker, but it won't allow me until I find a similar, open issue and watch it. Unfortuantely, I can't find one... so here goes.

    We've encountered an issue whereby if a user attempts to embed a secure, shortened URL for a YouTube video, the video embed errors.

    Steps to reproduce:
    * Enable YouTube embedding via oembed filter
    * Disable YouTube embedding via default Media Embedding
    * In a label or page add a link to a YouTube video using a shortened, secure URL (e.g. )

    Expected behaviour: When page is saved and viewed, the video embeds into the page.

    Actual behaviour: Message is displayed - "Error while accessing the embedded media. Please try refreshing the page."

    Using Moodle 2.9.3 (over https) and plugin version
  • Picture of Peter Sercombe
    Thu, 26 May 2016, 8:31 AM
    Bother - the URL was embedded in my comment. It was meant to provide an example of the type of URL we've tried to embed - i.e. https://[video ID]
1 2
Please login to post comments