Embeds

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.

Embedding content using the Embed block.

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:

ServiceBlockEmbed TypeSince
Amazon Kindle Amazon Kindle BlockVideosWordPress 4.9
AnimotoAnimato BlockVideosWordPress 4.0
CloudupCloudup BlockVideos, Galleries, ImagesWordPress 4.4
Crowdsignal Crowdsignal BlockPolls & SurveysWordPress 3.0
DailyMotionDailyMotion BlockVideosWordPress 2.9
FacebookFacebook BlockPost, activity, photo, video, media, question, noteWordPress 4.7
FlickrFlickr BlockVideos & ImagesWordPress 2.9
ImgurImgur BlockImagesWordPress 3.9
InstagramInstagram BlockImagesWordPress 3.5
IssuuIssuu BlockDocumentsWordPress 4.0
KickstarterKickstarter BlockProjectsWordPress 4.2
MixcloudMixcloud BlockMusicWordPress 4.0
PhotobucketImagesWordPress 2.9
PinterestImages
Pocket CastsPocket Casts PodcastsWordPress 6.1
RedditReddit BlockPosts & CommentsWordPress 4.4
ReverbNationReverbNation BlockMusicWordPress 4.4
ScreencastScreencast BlockVideo
ScribdScribd BlockDocumentsWordPress 2.9
SlideShareSlideShare BlockPresentation slideshowsWordPress 3.5
SmugMugSmugMug BlockVariousWordPress 3.0
SoundCloudSoundCloud BlockMusicWordPress 3.5
Speaker DeckSpeaker Deck BlockPresentation slideshowsWordPress 4.4
SpotifySpotify BlockMusicWordPress 3.6
TEDTED BlockVideosWordPress 4.0
TikTokTikTok BlockVideosWordPress 5.4
TumblrTumblr BlockVariousWordPress 4.2
TwitterTwitter BlockTweet, profile, list, collection, likes, MomentWordPress 3.4
VideoPressVideoPress BlockVideosWordPress 4.4
VimeoVideosWordPress 2.9
WolframWolfram BlockVarious
WordPressWordPress BlockVariousWordPress 4.4
WordPress.tvWordPress.tv BlockVideosWordPress 2.9
YouTubeYouTube BlockVideosWordPress 2.9

  • 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 :
  • 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.2:
    • Added: YouTube provider for live URLs

Changelog

  • 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?

First published

Last updated