oEmbed Filter

Filters ::: filter_oembed
Maintained by James McQuillan, Mike Churchward
Part of set Microsoft 365.
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.
Latest release:
1439 sites
50 fans
Current versions available: 8

Using the oEmbed protocol http://oembed.com/ 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 http://oembed.com/#section7 (JSON: http://oembed.com/providers.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.


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


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

Comments RSS

Vis kommentarer
  • Peter Sercombe
    tor., 26 mai 2016, 08:31
    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:// youtu.be/[video ID]
  • Luca Bösch
    tir., 11 apr. 2017, 19:23
    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.
  • Guy Thomas
    tir., 11 apr. 2017, 21:08
    @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 https://github.com/AnsonArgyris/moodle-atto_oembed
  • Mike Churchward
    tir., 11 apr. 2017, 21:30
    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 &).
  • Henrik sune Pedersen
    fre., 21 apr. 2017, 18:35
    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 : https://www.screencast.com/t/45Qti6PUbkWY but only the text is recieved https://www.screencast.com/t/hR6A8m8Moid. And we cannot have the teachers and students using html tage, i dont think they would remember that. smiler

    Hopefully theres a solution i havent tried / overseen.

    Kind regards
    Henrik Sune Pedersen
  • Mike Churchward
    man., 24 apr. 2017, 22:34
    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.
  • Madhu Avasarala
    søn., 14 mai 2017, 03:57
    I am trying to upgrade to the latest version of the filter plugin. I am on 3.2.3+. I am getting the following error:
    Table "filter_oembed" does not exist"
    Moodle hangs at this step. I can recover by restoring from a snapshot made just before update. Any help will be appreciated.
  • Guy Thomas
    man., 15 mai 2017, 19:49
    @Madhu - it sounds like the upgrade script failed. You could try to force it to run again by running this SQL:

    update mdl_config_plugins set value = '2016000000' where plugin = 'filter_oembed' and name = 'version'

    And then go to /admin

    I advise you to try this out in a test environment / clone of your site first.
  • Mike Churchward
    man., 15 mai 2017, 20:56
    @Madhu - if the table "filter_oembed" doesn't exist, and the oembed filter is trying to upgrade, then someone must have manually removed the table. You probably need to uninstall the filter and then reinstall it. You should be able to uninstall the plugin from the plugin admin screen.
  • Guy Thomas
    man., 15 mai 2017, 21:19
    @Madhu - Mike's solution is better than the one I suggested! smiler
  • Nadine GIBAUD
    ons., 9 jan. 2019, 22:36
    With Moodle 3.6.1+ (Build: 20181220), this seems not working with a Vimeo video. Just the link to the Vimeo video is displayed, not embedded in a div tag.
  • Nadine GIBAUD
    ons., 9 jan. 2019, 22:36
    With Moodle 3.6.1+ (Build: 20181220), this seems not working with a Vimeo video. Just the link to the Vimeo video is displayed, not embedded in a div tag.
  • Derek Chaplin
    lør., 2 mai 2020, 02:01
    I'm trying to use this plugin with Moodle 3.8.2 and it only seems to work for YouTube. When I try to embed a Vimeo video it just displays the link and the link text. I have disabled the Vimeo and Youtube options in the Media Player settings as recommended.
  • koen roggemans
    ons., 23 nov. 2022, 22:20
    I'm trying to get this working with Peertube. I can't find anything wrong in my peertube setup - a url like https://my.peertube.be/services/oembed/?url=https://my.peertube.be/w/videolink gives a valid response. Alse when I paste the embed-code from peertube in a page, it works. But I can't get it to work with a pasted share link as it is supposed to. Documentation is on https://docs.joinpeertube.org/use-watch-video?id=sharing-a-video. Can anyone verify if that is correct?
  • Alex Meier
    tir., 6 jun. 2023, 18:38
    is there a chance for a v4 version of the plugin?
1 2
Please login to post comments