Title: Embeds Author: Dion Hulse Published: 2 Novembre 2018 Last modified: 27 Giugno 2020 --- # Embeds It’s super easy to **embed** videos, images, tweets, audio, and other content into your WordPress site. ## Usage To embed a video or another object into a post or page, place its URL into the content area. Make sure the URL is on its own line and not hyperlinked (clickable when viewing the post). For example: ```wp-block-preformatted Check out this cool video:http://www.youtube.com/watch?v=dQw4w9WgXcQThat was a cool video. ``` WordPress will automatically turn the URL into a YouTube embed and provide a live preview in the visual editor. Another option is to wrap the URL in the “`embed`” [Shortcode](https://codex.wordpress.org/Shortcode). ```wp-block-preformatted // NOTE: Remove space between '[' and 'embed' when you try.[ embed width="123" height="456"]http://www.youtube.com/watch?v=dQw4w9WgXcQ[/embed] ``` If WordPress fails to embed the URL, the post will contain a hyperlink to the URL. ## oEmbed The easy embedding feature is mostly powered by oEmbed, a protocol for site A (such as your blog) to ask site B (such as YouTube) for the HTML needed to embed content from site B. oEmbed was designed to avoid the need to copy and paste HTML from the site hosting the media you wish to embed. It supports videos, images, text, and more. ## Does This Work With Any URL? No, not by default. WordPress will only embed URLs matching an internal whitelist. This is for security purposes. ## Okay, So What Sites Can I Embed From? You can use all of these: | **Service** | **Embed Type** | **Since** | | [Amazon Kindle instant previews](http://amazon.com/) | Videos | [WordPress 4.9](https://codex.wordpress.org/Version_4.9) | | [Animoto](http://animoto.com/) | Videos | [WordPress 4.0](https://codex.wordpress.org/Version_4.0) | | [Blip](http://blip.tv/) | Videos | [WordPress 2.9](https://codex.wordpress.org/Version_2.9) | | [Cloudup](http://cloudup.com/) | Videos, Galleries, Images | [WordPress 4.4](https://codex.wordpress.org/Version_4.4) | | [CollegeHumor](http://collegehumor.com/) | Videos | [WordPress 4.0](https://codex.wordpress.org/Version_4.0) | | [Crowdsignal](https://crowdsignal.com/) | Polls & Surveys | [WordPress 3.0](https://codex.wordpress.org/Version_3.0) | | [DailyMotion](http://www.dailymotion.com/) | Videos | [WordPress 2.9](https://codex.wordpress.org/Version_2.9) | | [Facebook](https://www.facebook.com/) | post, activity, photo, video, media, question, note | [WordPress 4.7](https://codex.wordpress.org/Version_4.7) | | [Flickr](http://www.flickr.com/) | Videos & Images | [WordPress 2.9](https://codex.wordpress.org/Version_2.9) | | [FunnyOrDie.com](http://www.funnyordie.com/) | Videos | [WordPress 3.0](https://codex.wordpress.org/Version_3.0) | | [Giphy](http://giphy.com/) | Animated GIFs | [WordPress 4.7](https://codex.wordpress.org/Version_4.7) | | [Hulu](http://www.hulu.com/) | Videos | [WordPress 2.9](https://codex.wordpress.org/Version_2.9) | | [Imgur](http://imgur.com/) | Images | [WordPress 3.9](https://codex.wordpress.org/Version_3.9) | | [Instagram](http://instagram.com/) | Images | [WordPress 3.5](https://codex.wordpress.org/Version_3.5) | | [Issuu](http://issuu.com/) | Documents | [WordPress 4.0](https://codex.wordpress.org/Version_4.0) | | [Kickstarter](http://www.kickstarter.com/) | Projects | [WordPress 4.2](https://codex.wordpress.org/Version_4.2) | | [Meetup.com](http://meetup.com/) | Various | [WordPress 3.9](https://codex.wordpress.org/Version_3.9) | | [Mixcloud](http://mixcloud.com/) | Music | [WordPress 4.0](https://codex.wordpress.org/Version_4.0) | | [Photobucket](http://photobucket.com/) | Images | [WordPress 2.9](https://codex.wordpress.org/Version_2.9) | | [Reddit](http://reddit.com/) | Posts & Comments | [WordPress 4.4](https://codex.wordpress.org/Version_4.4) | | [ReverbNation](http://reverbnation.com/) | Music | [WordPress 4.4](https://codex.wordpress.org/Version_4.4) | | [Scribd](http://www.scribd.com/) | Documents | [WordPress 2.9](https://codex.wordpress.org/Version_2.9) | | [SlideShare](http://www.slideshare.net/) | Presentation slideshows | [WordPress 3.5](https://codex.wordpress.org/Version_3.5) | | [SmugMug](http://www.smugmug.com/) | Various | [WordPress 3.0](https://codex.wordpress.org/Version_3.0) | | [SoundCloud](http://soundcloud.com/) | Music | [WordPress 3.5](https://codex.wordpress.org/Version_3.5) | | [Speaker Deck](http://speakerdeck.com/) | Presentation slideshows | [WordPress 4.4](https://codex.wordpress.org/Version_4.4) | | [Spotify](http://www.spotify.com/) | Music | [WordPress 3.6](https://codex.wordpress.org/Version_3.6) | | [TED](http://www.ted.com/) | Videos | [WordPress 4.0](https://codex.wordpress.org/Version_4.0) | | [Tumblr](http://www.tumblr.com/) | Various | [WordPress 4.2](https://codex.wordpress.org/Version_4.2) | | [Twitter](http://twitter.com/) | Tweet, profile, list, collection, likes, Moment | [WordPress 3.4](https://codex.wordpress.org/Version_3.4) | | [VideoPress](http://videopress.com/) | Videos | [WordPress 4.4](https://codex.wordpress.org/Version_4.4) | | [Vimeo](http://vimeo.com/) | Videos | [WordPress 2.9](https://codex.wordpress.org/Version_2.9) | | [Vine](https://vine.co/) | Videos | [WordPress 4.1](https://codex.wordpress.org/Version_4.1) | | [WordPress plugin directory](https://wordpress.org/plugins-wp/) | Plugins | [WordPress 4.4](https://codex.wordpress.org/Version_4.4) | | [WordPress.tv](http://wordpress.tv/) | Videos | [WordPress 2.9](https://codex.wordpress.org/Version_2.9) | | [YouTube](http://www.youtube.com/) | Videos | [WordPress 2.9](https://codex.wordpress.org/Version_2.9) | **Notes** * Twitter – older versions of WordPress have issues with https embeds, just remove the s from the https to fix. * YouTube – only public and “unlisted” videos and playlists – “private” videos will not embed. * Tumblr – only posts (name.tumblr.com/post/etc) are recognized, not standalone images (name.tumblr.com/image) ## How Can I Add or Change Support For Websites? Adding support for an additional website depends on whether the site supports oEmbed. ### Adding Support For An oEmbed-Enabled Site If a site supports oEmbed, you’ll want to call [wp_oembed_add_provider()](https://codex.wordpress.org/Function_Reference/wp_oembed_add_provider) to add the site and URL format to the internal whitelist. ### Adding Support For A Non-oEmbed Site You’ll need to register a handler using [wp_embed_register_handler()](https://codex.wordpress.org/Function_Reference/wp_embed_register_handler) and provide a callback function that generates the HTML. ### Removing Support for An oEmbed-Enabled Site If you wish to remove an oEmbed-enabled provider, you’ll want to call [wp_oembed_remove_provider](https://codex.wordpress.org/Function_Reference/wp_oembed_remove_provider). ## What About oEmbed Discovery? As of version 4.4, WordPress supports oEmbed discovery, but has severe limitations on what type of content can be embedded via non-whitelisted sites. Specifically, the HTML and Video content is filtered to only allow links, blockquotes, and iframes, and these are additionally filtered to prevent insertion of malicious content. The HTML is then modified to be sandboxed and to have additional security restrictions placed on them as well. However, if you feel you are knowledgeable enough to not require this level of safety, you can give `unfiltered_html` users (Administrators and Editors) the ability to embed from websites that have oEmbed discovery tags in their ``. The oEmbed discovery content for “link” and “photo” types is not quite so heavily filtered in this manner, however it is properly escaped for security and to prevent any malicious content from being displayed on the site. ## External Resources * [oEmbed.com](http://oembed.com/) – Official oEmbed website with technical details of the spec * [Get Started With OEmbed](http://www.webmonkey.com/2010/02/get_started_with_oembed/)– by Webmonkey.com * [WordPress oEmbed Providers Registration Generator](http://generatewp.com/oembed/)– by GenerateWP.com * [Easy Embeds For WordPress 2.9](http://www.viper007bond.com/2009/10/13/easy-embeds-for-wordpress-2-point-9/)– by Alex Mills (Viper007Bond) * [How to Set oEmbed Max Width in WordPress 3.5 with $content_width?](http://www.wpbeginner.com/wp-themes/how-to-set-oembed-max-width-in-wordpress-3-5-with-content_width/)– by wpbeginner.com ## Changelog * [2.9](https://codex.wordpress.org/Version_2.9) : - Introduction of the builtin Embeds support. * [3.0](https://codex.wordpress.org/Version_3.0) : - Added: SmugMug, FunnyOrDie * [3.4](https://codex.wordpress.org/Version_3.4) : - Added: Twitter * [3.5](https://codex.wordpress.org/Version_3.5) : - Embed options were removed from the [Settings Media Screen](https://codex.wordpress.org/Settings_Media_Screen). - Added: Instagram, SoundCloud, SlideShare * [3.6](https://codex.wordpress.org/Version_3.6) : - Added: Rdio, Spotify * [3.9](https://codex.wordpress.org/Version_3.9) : - Removed: Qik (the service shutting down in April 2014) * [4.0](https://codex.wordpress.org/Version_4.0) : - Major reworking of the preview code showing embeds within the editor [wp.mce.views](https://codex.wordpress.org/wp.mce.views). - Added: CollegeHumor, Issuu, Mixcloud, YouTube playlists, TED talks - Removed: Viddler (removed due to the service shutting down their oEmbed endpoint) * [4.1](https://codex.wordpress.org/Version_4.1) : - Added: Vine * [4.2](https://codex.wordpress.org/Version_4.2) : - Added: Kickstarter, Tumblr - Removed: Revision3 * [4.4](https://codex.wordpress.org/Version_4.4) : - Added: ReverbNation, Cloudup, Reddit, SpeakerDeck, VideoPress - Removed: Blip * [4.4.1](https://codex.wordpress.org/Version_4.4.1) : - Removed: Rdio (Service shut down) * [4.5](https://codex.wordpress.org/Version_4.5) : - Added: Twitter Moment, collection * [4.7](https://codex.wordpress.org/Version_4.7) : - Added: Twitter profile, list, likes - Added: Facebook post, activity, photo, video, media, question, note * [5.1](https://codex.wordpress.org/Version_5.1) : - Renamed: PollDaddy service has been renamed to Crowdsignal