{"id":5563,"date":"2026-02-12T20:44:48","date_gmt":"2026-02-13T01:44:48","guid":{"rendered":"https:\/\/chubes.net\/?documentation=embed-blocks"},"modified":"2026-03-13T03:28:07","modified_gmt":"2026-03-13T07:28:07","slug":"embed-blocks","status":"publish","type":"documentation","link":"https:\/\/chubes.net\/docs\/wordpress-core\/core-blocks\/embed-blocks\/","title":{"rendered":"Embed Blocks"},"content":{"rendered":"<p>External content embedding via oEmbed.<\/p><h2 class=\"wp-block-heading\">core\/embed<\/h2><p>Universal embed block with provider variations.<\/p><p><strong>Attributes:<\/strong><\/p><ul class=\"wp-block-list\"><li><code>url<\/code> (string) \u2014 Content URL<\/li><li><code>caption<\/code> (rich-text) \u2014 Embed caption<\/li><li><code>type<\/code> (string) \u2014 Embed type (video, rich, photo, link)<\/li><li><code>providerNameSlug<\/code> (string) \u2014 Provider slug<\/li><li><code>allowResponsive<\/code> (boolean) \u2014 Allow responsive (default: true)<\/li><li><code>responsive<\/code> (boolean) \u2014 Is responsive<\/li><li><code>previewable<\/code> (boolean) \u2014 Can preview (default: true)<\/li><\/ul><p><strong>Supports:<\/strong> align, className, spacing<\/p><h2 class=\"wp-block-heading\">Embed Variations<\/h2><p>Each variation sets the <code>providerNameSlug<\/code> attribute:<\/p><h3 class=\"wp-block-heading\">Video Providers<\/h3><figure class=\"wp-block-table\"><table><thead><tr><th>Variation<\/th><th>Provider<\/th><th>URL Pattern<\/th><\/tr><\/thead><tbody><tr><td><code>youtube<\/code><\/td><td>YouTube<\/td><td>youtube.com, youtu.be<\/td><\/tr><tr><td><code>vimeo<\/code><\/td><td>Vimeo<\/td><td>vimeo.com<\/td><\/tr><tr><td><code>dailymotion<\/code><\/td><td>Dailymotion<\/td><td>dailymotion.com<\/td><\/tr><tr><td><code>videopress<\/code><\/td><td>VideoPress<\/td><td>videopress.com<\/td><\/tr><tr><td><code>tiktok<\/code><\/td><td>TikTok<\/td><td>tiktok.com<\/td><\/tr><tr><td><code>ted<\/code><\/td><td>TED<\/td><td>ted.com<\/td><\/tr><tr><td><code>animoto<\/code><\/td><td>Animoto<\/td><td>animoto.com<\/td><\/tr><tr><td><code>cloudup<\/code><\/td><td>Cloudup<\/td><td>cloudup.com<\/td><\/tr><tr><td><code>crowdsignal<\/code><\/td><td>Crowdsignal<\/td><td>crowdsignal.com<\/td><\/tr><\/tbody><\/table><\/figure><h3 class=\"wp-block-heading\">Social Providers<\/h3><figure class=\"wp-block-table\"><table><thead><tr><th>Variation<\/th><th>Provider<\/th><th>URL Pattern<\/th><\/tr><\/thead><tbody><tr><td><code>twitter<\/code><\/td><td>Twitter\/X<\/td><td>twitter.com, x.com<\/td><\/tr><tr><td><code>instagram<\/code><\/td><td>Instagram<\/td><td>instagram.com<\/td><\/tr><tr><td><code>facebook<\/code><\/td><td>Facebook<\/td><td>facebook.com<\/td><\/tr><tr><td><code>flickr<\/code><\/td><td>Flickr<\/td><td>flickr.com<\/td><\/tr><tr><td><code>pinterest<\/code><\/td><td>Pinterest<\/td><td>pinterest.com<\/td><\/tr><tr><td><code>reddit<\/code><\/td><td>Reddit<\/td><td>reddit.com<\/td><\/tr><tr><td><code>tumblr<\/code><\/td><td>Tumblr<\/td><td>tumblr.com<\/td><\/tr><tr><td><code>bluesky<\/code><\/td><td>Bluesky<\/td><td>bsky.app<\/td><\/tr><\/tbody><\/table><\/figure><h3 class=\"wp-block-heading\">Audio Providers<\/h3><figure class=\"wp-block-table\"><table><thead><tr><th>Variation<\/th><th>Provider<\/th><th>URL Pattern<\/th><\/tr><\/thead><tbody><tr><td><code>spotify<\/code><\/td><td>Spotify<\/td><td>spotify.com<\/td><\/tr><tr><td><code>soundcloud<\/code><\/td><td>SoundCloud<\/td><td>soundcloud.com<\/td><\/tr><tr><td><code>mixcloud<\/code><\/td><td>Mixcloud<\/td><td>mixcloud.com<\/td><\/tr><tr><td><code>pocketcasts<\/code><\/td><td>Pocket Casts<\/td><td>pocketcasts.com<\/td><\/tr><\/tbody><\/table><\/figure><h3 class=\"wp-block-heading\">Other Providers<\/h3><figure class=\"wp-block-table\"><table><thead><tr><th>Variation<\/th><th>Provider<\/th><th>URL Pattern<\/th><\/tr><\/thead><tbody><tr><td><code>wordpress<\/code><\/td><td>WordPress.com<\/td><td>wordpress.com<\/td><\/tr><tr><td><code>wordpress-tv<\/code><\/td><td>WordPress.tv<\/td><td>wordpress.tv<\/td><\/tr><tr><td><code>amazon-kindle<\/code><\/td><td>Amazon Kindle<\/td><td>amazon.com<\/td><\/tr><tr><td><code>issuu<\/code><\/td><td>Issuu<\/td><td>issuu.com<\/td><\/tr><tr><td><code>scribd<\/code><\/td><td>Scribd<\/td><td>scribd.com<\/td><\/tr><tr><td><code>slideshare<\/code><\/td><td>SlideShare<\/td><td>slideshare.net<\/td><\/tr><tr><td><code>speaker-deck<\/code><\/td><td>Speaker Deck<\/td><td>speakerdeck.com<\/td><\/tr><tr><td><code>kickstarter<\/code><\/td><td>Kickstarter<\/td><td>kickstarter.com<\/td><\/tr><tr><td><code>imgur<\/code><\/td><td>Imgur<\/td><td>imgur.com<\/td><\/tr><tr><td><code>wolfram-cloud<\/code><\/td><td>Wolfram Cloud<\/td><td>wolframcloud.com<\/td><\/tr><\/tbody><\/table><\/figure><h3 class=\"wp-block-heading\">How Variations Work<\/h3><div class=\"code-block-wrapper\"><div class=\"code-block-header\"><span class=\"code-block-language\">json<\/span><button class=\"code-copy-btn\" aria-label=\"Copy code\"><svg><use href=\"https:\/\/chubes.net\/wp-content\/themes\/chubes\/assets\/icons\/chubes.svg#icon-copy\"><\/use><\/svg><\/button><\/div><pre data-chubes-enhanced class=\"wp-block-code language-json\"><code class=\"language-json\">{\n  &quot;name&quot;: &quot;youtube&quot;,\n  &quot;title&quot;: &quot;YouTube&quot;,\n  &quot;icon&quot;: &quot;embed-video&quot;,\n  &quot;keywords&quot;: [&quot;video&quot;, &quot;music&quot;],\n  &quot;description&quot;: &quot;Embed a YouTube video.&quot;,\n  &quot;patterns&quot;: [&quot;https?:\/\/((m|www)\\.)?youtube\\.com\/.+&quot;, &quot;https?:\/\/youtu\\.be\/.+&quot;],\n  &quot;attributes&quot;: {\n    &quot;providerNameSlug&quot;: &quot;youtube&quot;,\n    &quot;responsive&quot;: true\n  }\n}<\/code><\/pre><\/div><p>The embed block detects the URL and automatically selects the appropriate variation.<\/p><h2 class=\"wp-block-heading\">oEmbed Flow<\/h2><ol class=\"wp-block-list\"><li>User pastes URL<\/li><li>Block sends URL to <code>\/wp-json\/oembed\/1.0\/proxy<\/code><\/li><li>WordPress fetches oEmbed data from provider<\/li><li>Embed HTML is cached in post meta<\/li><li>Block renders provider HTML in iframe\/figure<\/li><\/ol><h2 class=\"wp-block-heading\">Responsive Embeds<\/h2><p>Responsive embeds (videos) are wrapped:<\/p><div class=\"code-block-wrapper\"><div class=\"code-block-header\"><span class=\"code-block-language\">html<\/span><button class=\"code-copy-btn\" aria-label=\"Copy code\"><svg><use href=\"https:\/\/chubes.net\/wp-content\/themes\/chubes\/assets\/icons\/chubes.svg#icon-copy\"><\/use><\/svg><\/button><\/div><pre data-chubes-enhanced class=\"wp-block-code language-html\"><code class=\"language-html\">&lt;figure class=&quot;wp-block-embed is-type-video is-provider-youtube wp-block-embed-youtube wp-embed-aspect-16-9 wp-has-aspect-ratio&quot;&gt;\n  &lt;div class=&quot;wp-block-embed__wrapper&quot;&gt;\n    &lt;!-- provider embed HTML --&gt;\n  &lt;\/div&gt;\n  &lt;figcaption class=&quot;wp-element-caption&quot;&gt;Caption&lt;\/figcaption&gt;\n&lt;\/figure&gt;<\/code><\/pre><\/div><p>Aspect ratio classes:<\/p><ul class=\"wp-block-list\"><li><code>wp-embed-aspect-21-9<\/code><\/li><li><code>wp-embed-aspect-18-9<\/code><\/li><li><code>wp-embed-aspect-16-9<\/code><\/li><li><code>wp-embed-aspect-4-3<\/code><\/li><li><code>wp-embed-aspect-1-1<\/code><\/li><li><code>wp-embed-aspect-9-16<\/code><\/li><li><code>wp-embed-aspect-1-2<\/code><\/li><\/ul>","protected":false},"excerpt":{"rendered":"<p>External content embedding via oEmbed. core\/embed Universal embed block with provider variations. Attributes: url (string) \u2014 Content URL caption (rich-text) \u2014 Embed caption type (string) \u2014 Embed type (video, rich,&#8230;<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"footnotes":""},"tags":[],"project":[608],"project_type":[749],"class_list":["post-5563","documentation","type-documentation","status-publish","hentry","project-core-blocks","project_type-wordpress-reference"],"project_info":{"id":589,"name":"WordPress Core","slug":"wordpress-core"},"project_type_info":{"id":749,"name":"WordPress Reference","slug":"wordpress-reference"},"_links":{"self":[{"href":"https:\/\/chubes.net\/wp-json\/wp\/v2\/documentation\/5563","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/chubes.net\/wp-json\/wp\/v2\/documentation"}],"about":[{"href":"https:\/\/chubes.net\/wp-json\/wp\/v2\/types\/documentation"}],"version-history":[{"count":4,"href":"https:\/\/chubes.net\/wp-json\/wp\/v2\/documentation\/5563\/revisions"}],"predecessor-version":[{"id":9379,"href":"https:\/\/chubes.net\/wp-json\/wp\/v2\/documentation\/5563\/revisions\/9379"}],"wp:attachment":[{"href":"https:\/\/chubes.net\/wp-json\/wp\/v2\/media?parent=5563"}],"wp:term":[{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/chubes.net\/wp-json\/wp\/v2\/tags?post=5563"},{"taxonomy":"project","embeddable":true,"href":"https:\/\/chubes.net\/wp-json\/wp\/v2\/project?post=5563"},{"taxonomy":"project_type","embeddable":true,"href":"https:\/\/chubes.net\/wp-json\/wp\/v2\/project_type?post=5563"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}