Since WordPress 5.0, the WordPress block editor has an easy way to add videos, images, tweets, audio, and other content from third-party services into your WordPress site by embedding. An example of this is embedding a YouTube video in your post or page.
When you are embedding content, you don’t need to upload the content to your WordPress site. You are creating a link to the content, from within your post or page.
Using the generic Embed Block, you can paste the URL from the third-party site that you want to embed the content such as YouTube, Vimeo, TED, etc on your post or page.
You can also use Embed blocks build for specific third-party services such as YouTube Embed, Vimeo Embed, etc.
For a full list of embeds, check out the article: list of all embed blocks.
List of sites you can embed from
WordPress can embed content from the services listed below:
- Facebook and Instagram: Due to Facebook’s decision to close the oEmbed end point for embedding Facebook and Instagram links, the block will not work anymore after October 24, 2020. To embed Facebook and Instagram links into your site, you need a developer account and an appid, and provide an authentication token with their call to the endpoint. Refer to the Facebook Documentation.
- Tumblr – only posts (name.tumblr.com/post/etc) are recognized, not standalone images (name.tumblr.com/image)
- Twitter – older versions of WordPress have issues with https embeds. Remove the ‘s’ from the https to fix the issue.
- YouTube – only public and “unlisted” videos and playlists can be embedded. “private” videos cannot be embedded.
External resources
- oEmbed.com – Official oEmbed website with technical details of the spec
Embeds changelog
- 2.9 :
- Introduction of the builtin Embeds support.
- 3.0 :
- Added: SmugMug, FunnyOrDie
- 3.4 :
- Added: Twitter
- 3.5 :
- Embed options were removed from the Settings Media Screen.
- Added: Instagram, SoundCloud, SlideShare
- 3.6 :
- Added: Rdio, Spotify
- 3.9 :
- Removed: Qik (the service shutting down in April 2014)
- 4.0 :
- Major reworking of the preview code showing embeds within the editor 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 :
- Added: Vine
- 4.2 :
- Added: Kickstarter, Tumblr
- Removed: Revision3
- 4.4 :
- Added: ReverbNation, Cloudup, Reddit, SpeakerDeck, VideoPress
- Removed: Blip
- 4.4.1 :
- Removed: Rdio (Service shut down)
- 4.5 :
- Added: Twitter Moment, collection
- 4.7 :
- Added: Twitter profile, list, likes
- Added: Facebook post, activity, photo, video, media, question, note
- 5.1 :
- Renamed: PollDaddy service has been renamed to Crowdsignal
- 5.6 :
- Added section about the Block Editor for embeds, created a new column for Block Editor documentation links, note about Facebook and Instagram ending OAuth, updated Codex links, added a new changelog and reordered page.
- Added: TikTok
- Removed: Blip, Hulu, CollegeHumor, FunnyOrDie.com and Vine
- 6.0:
- Removed: Meetup.com, and Giphy,
- Added Screencast, Pinterest, Wolfram
- 6.1:
- Added: Pocket Casts
- 6.2:
- Added: YouTube provider for live URLs
Changelog
- Updated 2022-11-25
- Added Pocket Casts
- Updated 2022-08-16
- Removed Meetup.com, and Giphy, Added Screencast, Pinterest, Wolfram
- Removed oEmbed info and Usage info.
- Updated content and added ALT tags for the images
- Updated 2020-12-08
- Added section about the Block Editor for embeds, created a new column for Block Editor documentation links, noted about Facebook and Instagram ending OAuth, added new Changelog, updated Codex links, and reordered page.
- Added: TikTok
- Removed: Blip, Hulu, CollegeHumor, FunnyOrDie.com, and Vine; Some external links that violated our external linking policy or were out-of-date.
Was this article helpful? How could it be improved?
Log in to submit feedback. If you need support with something that wasn't covered by this article, please post your question in the support forums.