{"id":12939840,"date":"2020-06-04T19:17:50","date_gmt":"2020-06-04T19:17:50","guid":{"rendered":"https:\/\/wordpress.org\/support\/?post_type=helphub_article&#038;p=12939840"},"modified":"2024-06-06T17:19:05","modified_gmt":"2024-06-06T17:19:05","slug":"instagram-embed","status":"publish","type":"helphub_article","link":"https:\/\/wordpress.org\/documentation\/article\/instagram-embed\/","title":{"rendered":"Instagram embed"},"content":{"rendered":"\n<p class=\"has-text-align-right has-small-font-size wp-block-paragraph\"><a href=\"https:\/\/wordpress.org\/documentation\/article\/blocks\/\">Go back to the list of <strong>Blocks<\/strong><\/a><\/p>\n\n\n\n<p class=\"has-black-color has-text-color has-background wp-block-paragraph\" style=\"background-color:#eaf3f9\">Due to Facebook&#8217;s <a href=\"http:\/\/Facebook announced updates to their Marketing API\">decision to close the oEmbed end <\/a>point for embedding Instagram links, the block will not work anymore after October 24, 2020. Publishers who want to embed Facebook links into their sites will require a developer account and an appid, and provide an authenication token with their call to the endpoint. Facebook Documentation:  <a href=\"https:\/\/developers.facebook.com\/docs\/apps\/\" data-type=\"URL\" data-id=\"https:\/\/developers.facebook.com\/docs\/apps\/\">create an app<\/a><\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><em>WordPress leadership reached out to Facebook but it seems the policy change is final. Apart from alerting users here and other place, WordPress contributors can&#8217;t do anything about it. <\/em><\/p>\n\n\n\n<hr class=\"wp-block-separator has-css-opacity\" \/>\n\n\n\n<p class=\"wp-block-paragraph\">The Facebook embed block was removed for the Gutenberg plugin version 9.0 and will be removed from the upcoming WordPress core version in 5.6<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">With the Instagram Embed block, you can embed Instagram posts on your posts and pages. You don\u2019t need an Instagram account to be able to use it. You can only embed public posts, though.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>An Example:<\/strong><\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"436\" height=\"525\" src=\"https:\/\/wordpress.org\/documentation\/files\/2020\/06\/first-instagram-embed.png\" alt=\"Screenshot of of an instagram post\" class=\"wp-image-12939886\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2020\/06\/first-instagram-embed.png 436w, https:\/\/wordpress.org\/documentation\/files\/2020\/06\/first-instagram-embed-249x300.png 249w\" sizes=\"auto, (max-width: 436px) 100vw, 436px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Steps to embed an Instagram Post<\/strong><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Find the URL of the post<\/strong><\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">FinNavigate to the Instagram post you want to embed on your page. Copy the link of that post by clicking on it, then on the more options button, and then on the Copy Link. The process is similar for mobile devices.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"691\" height=\"343\" src=\"https:\/\/wordpress.org\/documentation\/files\/2020\/06\/second-instagram-embed.png\" alt=\"The correct URL to copy to use the embed block\" class=\"wp-image-12939904\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2020\/06\/second-instagram-embed.png 691w, https:\/\/wordpress.org\/documentation\/files\/2020\/06\/second-instagram-embed-300x149.png 300w\" sizes=\"auto, (max-width: 691px) 100vw, 691px\" \/><\/figure>\n\n\n\n<ol class=\"wp-block-list\" start=\"2\">\n<li><strong>Go to your post or page<\/strong><\/li>\n\n\n\n<li><strong>Add the Instagram block<\/strong><\/li>\n\n\n\n<li><strong>Paste the link into the text box and click the \u201cEmbed\u201d button<\/strong><\/li>\n<\/ol>\n\n\n\n<figure class=\"wp-block-image aligncenter size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"716\" height=\"277\" src=\"https:\/\/wordpress.org\/documentation\/files\/2020\/06\/third-instagram-embed.png\" alt=\"Screenshot of Unstagramand the correct URL to copy to use the embed block.\" class=\"wp-image-12939964\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2020\/06\/third-instagram-embed.png 716w, https:\/\/wordpress.org\/documentation\/files\/2020\/06\/third-instagram-embed-300x116.png 300w\" sizes=\"auto, (max-width: 716px) 100vw, 716px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">If the link is embedded successfully, you\u2019ll see a preview in your editor.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"516\" height=\"583\" src=\"https:\/\/wordpress.org\/documentation\/files\/2020\/06\/fourth-instagram-embed.png\" alt=\"Preview of the embedded Instagram post within the WordPress editor.\" class=\"wp-image-12939974\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2020\/06\/fourth-instagram-embed.png 516w, https:\/\/wordpress.org\/documentation\/files\/2020\/06\/fourth-instagram-embed-266x300.png 266w\" sizes=\"auto, (max-width: 516px) 100vw, 516px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">If you\u2019re using a link that cannot be embedded, the block shows a message, \u201c<em>Sorry, this content could not be embedded.<\/em>\u201d<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">You will have two choices: Try again with a different URL or convert it to a link.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"608\" height=\"280\" src=\"https:\/\/wordpress.org\/documentation\/files\/2020\/06\/fifth-instagram-embed.png\" alt=\"Example of a URL that cannot be embedded. Two options are presented, try again or convert to link.\" class=\"wp-image-12939980\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2020\/06\/fifth-instagram-embed.png 608w, https:\/\/wordpress.org\/documentation\/files\/2020\/06\/fifth-instagram-embed-300x138.png 300w\" sizes=\"auto, (max-width: 608px) 100vw, 608px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>6. Click on \u201cPreview\u201d to see how it will look on the front-end.<\/strong><\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"432\" height=\"526\" src=\"https:\/\/wordpress.org\/documentation\/files\/2020\/06\/sixth-instagram-embed.png\" alt=\"Preview of the Instagram post \" class=\"wp-image-12939998\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2020\/06\/sixth-instagram-embed.png 432w, https:\/\/wordpress.org\/documentation\/files\/2020\/06\/sixth-instagram-embed-246x300.png 246w\" sizes=\"auto, (max-width: 432px) 100vw, 432px\" \/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Block Toolbar<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Besides the Mover and Drag &amp; Drop Handle, the Block Toolbar for the Instagram embed shows four buttons:<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"345\" height=\"198\" src=\"https:\/\/wordpress.org\/documentation\/files\/2020\/06\/seventh-instagram-embed.png\" alt=\"\" class=\"wp-image-12940003\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2020\/06\/seventh-instagram-embed.png 345w, https:\/\/wordpress.org\/documentation\/files\/2020\/06\/seventh-instagram-embed-300x172.png 300w\" sizes=\"auto, (max-width: 345px) 100vw, 345px\" \/><\/figure>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Transform to<\/li>\n\n\n\n<li>Change alignment<\/li>\n\n\n\n<li>Edit URL, and<\/li>\n\n\n\n<li>More Options.&nbsp;<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Transform to<\/strong>:<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"434\" height=\"308\" src=\"https:\/\/wordpress.org\/documentation\/files\/2020\/06\/eight-instagram-embed.png\" alt=\"Options to transform the Instagram block to Group.\" class=\"wp-image-12940008\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2020\/06\/eight-instagram-embed.png 434w, https:\/\/wordpress.org\/documentation\/files\/2020\/06\/eight-instagram-embed-300x213.png 300w\" sizes=\"auto, (max-width: 434px) 100vw, 434px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">You can transform an Instagram embed to a Group. This would give you the ability to change the background color around the Instagram embed.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"873\" height=\"537\" src=\"https:\/\/wordpress.org\/documentation\/files\/2020\/06\/ninth-instagram-embed.png\" alt=\"Editor view of a Instagram Embed as a group with Color Settings controls\" class=\"wp-image-12940015\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2020\/06\/ninth-instagram-embed.png 873w, https:\/\/wordpress.org\/documentation\/files\/2020\/06\/ninth-instagram-embed-300x185.png 300w, https:\/\/wordpress.org\/documentation\/files\/2020\/06\/ninth-instagram-embed-768x472.png 768w\" sizes=\"auto, (max-width: 873px) 100vw, 873px\" \/><figcaption class=\"wp-element-caption\">Editor view of an Instagram Embed as a group with Color Settings controls<\/figcaption><\/figure>\n\n\n\n<figure class=\"wp-block-image aligncenter size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"383\" height=\"491\" src=\"https:\/\/wordpress.org\/documentation\/files\/2020\/06\/tenth-instagram-embed.png\" alt=\"Instagram embed with a green background\" class=\"wp-image-12940031\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2020\/06\/tenth-instagram-embed.png 383w, https:\/\/wordpress.org\/documentation\/files\/2020\/06\/tenth-instagram-embed-234x300.png 234w\" sizes=\"auto, (max-width: 383px) 100vw, 383px\" \/><figcaption class=\"wp-element-caption\">Instagram embed with a green background<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Change Alignment <\/strong><\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"356\" height=\"259\" src=\"https:\/\/wordpress.org\/documentation\/files\/2020\/06\/eleven-instagram-embed.png\" alt=\"Alignment options for the Instagram block: align left, align center, and align right.\" class=\"wp-image-12940036\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2020\/06\/eleven-instagram-embed.png 356w, https:\/\/wordpress.org\/documentation\/files\/2020\/06\/eleven-instagram-embed-300x218.png 300w\" sizes=\"auto, (max-width: 356px) 100vw, 356px\" \/><\/figure>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Align left<\/strong> &#8211; Make the Instagram post left aligned<\/li>\n\n\n\n<li><strong>Align center<\/strong> &#8211; Make the Instagram post alignment centered<\/li>\n\n\n\n<li><strong>Align right <\/strong>&#8211; Make the&nbsp; Instagram post align right<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Edit URL<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Via the edit URL, you can change the Instagram Embed URL in the embed block. Overwrite the existing URL and click on the &#8220;Embed&#8221; Button.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"725\" height=\"332\" src=\"https:\/\/wordpress.org\/documentation\/files\/2020\/06\/twelth-instagram-embed.png\" alt=\"Editing the block URL via the &quot;edit&quot; option.\" class=\"wp-image-12940035\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2020\/06\/twelth-instagram-embed.png 725w, https:\/\/wordpress.org\/documentation\/files\/2020\/06\/twelth-instagram-embed-300x137.png 300w\" sizes=\"auto, (max-width: 725px) 100vw, 725px\" \/><\/figure>\n\n\n\n<p class=\"has-medium-font-size wp-block-paragraph\"><strong>More Options:<\/strong> <\/p>\n\n\n\n<p class=\"wp-block-paragraph\">These controls give you the option to copy, duplicate, and edit your block as HTML.<\/p>\n\n\n\n<p class=\"has-text-align-left has-background wp-block-paragraph\" style=\"background-color:#e5f5fa\"><a href=\"https:\/\/wordpress.org\/documentation\/article\/more-options\/\">Read about these and other settings.<\/a><\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Block Settings<\/h2>\n\n\n\n<p class=\"has-medium-font-size wp-block-paragraph\"><strong>Media Settings<\/strong><\/p>\n\n\n\n<figure class=\"wp-block-gallery has-nested-images columns-default is-cropped wp-block-gallery-1 is-layout-flex wp-block-gallery-is-layout-flex\">\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"406\" height=\"182\" data-id=\"12701737\" src=\"https:\/\/wordpress.org\/documentation\/files\/2020\/04\/Screen-Shot-2020-04-20-at-9.29.46-AM.png\" alt=\"Media settings for the embed block with the toggle OFF for resizing on smaller devices.\" class=\"wp-image-12701737\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2020\/04\/Screen-Shot-2020-04-20-at-9.29.46-AM.png 406w, https:\/\/wordpress.org\/documentation\/files\/2020\/04\/Screen-Shot-2020-04-20-at-9.29.46-AM-300x134.png 300w\" sizes=\"auto, (max-width: 406px) 100vw, 406px\" \/><\/figure>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"408\" height=\"197\" data-id=\"12701738\" src=\"https:\/\/wordpress.org\/documentation\/files\/2020\/04\/Screen-Shot-2020-04-20-at-9.29.55-AM.png\" alt=\"Media settings for the embed block with the toggle ON for resizing on smaller devices.\" class=\"wp-image-12701738\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2020\/04\/Screen-Shot-2020-04-20-at-9.29.55-AM.png 408w, https:\/\/wordpress.org\/documentation\/files\/2020\/04\/Screen-Shot-2020-04-20-at-9.29.55-AM-300x145.png 300w\" sizes=\"auto, (max-width: 408px) 100vw, 408px\" \/><\/figure>\n<\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Via the <em>Media Settings<\/em> you can control the behavior of your post embed when viewed from a smaller device, like on a  phone screen. <\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The Toggle switch turns on or off the resize functionality for smaller devices. The default setting is &#8220;on&#8221; or blue. <\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>&#8220;Off:&#8221;<\/strong> This embed may not preserve its aspect ratio when the browser is resized. In the off position the toggle switch is gray. <\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>&#8220;On:&#8221;<\/strong> This embed will preserve its aspect ratio when the browser is resized. The toggle switch turns blue in the &#8220;On&#8221; position. <\/p>\n\n\n\n<p class=\"has-medium-font-size wp-block-paragraph\"><strong>Advanced<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The advanced tab lets you add a CSS class to your block, allowing you to write custom CSS and style the block as you see fit.<br><\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-large\"><a href=\"https:\/\/wordpress.org\/documentation\/files\/2020\/04\/Screen-Shot-2020-04-22-at-10.33.35-AM.png\"><img loading=\"lazy\" decoding=\"async\" width=\"349\" height=\"191\" src=\"https:\/\/wordpress.org\/documentation\/files\/2020\/04\/Screen-Shot-2020-04-22-at-10.33.35-AM.png\" alt=\"\" class=\"wp-image-12714391\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2020\/04\/Screen-Shot-2020-04-22-at-10.33.35-AM.png 349w, https:\/\/wordpress.org\/documentation\/files\/2020\/04\/Screen-Shot-2020-04-22-at-10.33.35-AM-300x164.png 300w\" sizes=\"auto, (max-width: 349px) 100vw, 349px\" \/><\/a><figcaption class=\"wp-element-caption\">The advanced section lets you add a CSS class to your block.<\/figcaption><\/figure>\n\n\n\n<div class=\"wp-block-group changelog has-very-dark-gray-color has-very-light-gray-background-color has-text-color has-background is-layout-flow wp-block-group-is-layout-flow\">\n<h2 class=\"wp-block-heading has-medium-font-size\">Changelog <\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Updated 2022-11-27\n<ul class=\"wp-block-list\">\n<li>Removed redundant content<\/li>\n\n\n\n<li>Aligned images for mobile view<\/li>\n\n\n\n<li>Added alt text to images<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Updated 2020-09-21<\/li>\n\n\n\n<li>Updated 2020-08-18\n<ul class=\"wp-block-list\">\n<li>Replaced &#8216;More Options&#8217; \u2013 new screenshot<\/li>\n\n\n\n<li>Added &#8220;Move To&#8221; and &#8220;Copy&#8221; section under More Options<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Created 2020-06-05<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n<\/div>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Go back to the list of Blocks Due to Facebook&#8217;s decision to close the oEmbed end point for embedding Instagram links, the block will not work anymore after October 24, 2020. Publishers who want to embed Facebook links into their sites will require a developer account and an appid, and provide an authenication token with [&hellip;]<\/p>\n","protected":false},"author":15617619,"featured_media":0,"menu_order":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"advanced_seo_description":"","jetpack_seo_html_title":"","jetpack_seo_noindex":false},"category":[80,89],"class_list":["post-12939840","helphub_article","type-helphub_article","status-publish","hentry","category-customization","category-embed-blocks"],"revision_note":"","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/articles\/12939840","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/articles"}],"about":[{"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/types\/helphub_article"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/comments?post=12939840"}],"version-history":[{"count":4,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/articles\/12939840\/revisions"}],"predecessor-version":[{"id":16360327,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/articles\/12939840\/revisions\/16360327"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wporg\/v1\/users\/makewebbetter"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/media?parent=12939840"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/category?post=12939840"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}