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.
939 sites
17 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 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]
  • Picture of Luca Bösch
    Tue, 11 Apr 2017, 7:23 PM
    Could you guide me how you can circumvent oembed e.g. when you really want to display the YouTube URL but not embed the YouTube player?
    Thanks a lot.
  • Picture of Guy Thomas
    Tue, 11 Apr 2017, 9:08 PM
    @Luca. There's an Atto plugin that you can use with the filter that provides that capability. You have to configure the filter to use the oembed div wrapper instead of anchors. This isn't in the plugin dB yet but you can get it from
  • Picture of Mike Churchward
    Tue, 11 Apr 2017, 9:30 PM
    1) Disable Youtube filtering in the Oembed plugin. No good if you don't want it disabled everywhere.
    2) Use the
    tag style instead of the style in the Oembed settings. You would need to change the content everywhere that you have filtering currently.
    3) Display the link you don't want filtered using escaped HTML anchors. So instead of <a> tag, you use & lt;a& gt; . (remove spaces after &).
  • Picture of Henrik sune Pedersen
    Fri, 21 Apr 2017, 6:35 PM
    We have almost similar problem. When sending links in messages, the youtube links gets removed from the message when the oembed filter is enabled. I write this in the mesage text area : but only the text is recieved And we cannot have the teachers and students using html tage, i dont think they would remember that. smile

    Hopefully theres a solution i havent tried / overseen.

    Kind regards
    Henrik Sune Pedersen
  • Picture of Mike Churchward
    Mon, 24 Apr 2017, 10:34 PM
    There isn't currently any way that I know of to "selectively" filter oembed tags. Its kind of all or nothing. But, you can use div tags instead of HTML tags, so that you can precisely choose what you want to filter.
1 2
Please login to post comments