Instagram Embed

Go back to the list of Blocks

Due to Facebook’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 their call to the endpoint. Facebook Documentation: create an app

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’t do anything about it.

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

With the Instagram Embed block, you can embed Instagram posts on your posts and pages. You don’t need an Instagram account to be able to use it. You can only embed public posts, though.

An Example:

Steps to embed an Instagram Post

  1. Find the URL of the post

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.

  1. Go to your post or page
  2. Add the Instagram block
  3. Paste the link into the text box and click the “Embed” button

If the link is embedded successfully, you’ll see a preview in your editor.

If you’re using a link that cannot be embedded, the block shows a message, “Sorry, this content could not be embedded.

You will have two choices: Try again with a different URL or convert it to a link.

6. Click on “Preview” to see how it will look on the front-end.

Block Toolbar

Besides the Mover and Drag & Drop Handle, the Block Toolbar for the Instagram embed shows four buttons:

  • Transform to
  • Change alignment
  • Edit URL, and
  • More Options. 

Transform to:

You can transform an Instagram embed to a Group. This would give you the ability to change the background color around the Instagram embed.

Editor view of an Instagram Embed as a group with Color Settings controls
Instagram embed with a green background

Change Alignment – use reusable Block 

  • Align left – Make the Instagram post left aligned
  • Align center – Make the Instagram post alignment centered
  • Align right – Make the  Instagram post align right

Edit URL

Via the edit URL, you can change the Instagram Embed URL in the embed block. Overwrite the existing URL and click on the “Embed” Button.

More Options:

Hide Block Settings

The Hide Block Settings option hides (or shows) the Block Setting panel in the editor’s sidebar.


Copy can be used to copy a selected block and then you can paste it wherever you want in the editor.


Duplicate can be used to duplicate selected block.

Insert Before

Insert a new block before the selected block(s).

Insert After

Insert a new block after the selected block(s).

Move To

If you select Move To, you will get a blue line inside your content, you can then use the arrows to move that line up and down to where you want the selected content to be moved into, hitting return on your keyboard at that point moves the block to that position.

Edit as HTML

The Edit as HTML option allows you to modify the HTML code of the embed block.

Add to Reusable blocks

Using the Add to Reusable blocks option lets you add the selected block to a list of reusable blocks, so you can use them on other posts or pages as well.


Select the Group option if you want to create a group of blocks and treat them as a unit. You can for instance add a common background color or other blocks to the group.

Remove Block

With the Remove Block option, you can delete the selected block from your content.

Top ↑

Block Settings

Media Settings

Via the Media Settings you can control the behavior of your post embed when viewed from a smaller device, like on a phone screen.

The Toggle switch turns on or off the resize functionality for smaller devices. The default setting is “on” or blue.

“Off:” This embed may not preserve its aspect ratio when the browser is resized. In the off position the toggle switch is gray.

“On:” This embed will preserve its aspect ratio when the browser is resized. The toggle switch turns blue in the “On” position.


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.

The advanced section lets you add a CSS class to your block.

Top ↑


  • Updated 2020-09-21
    • Announcement of discontinuation of Instagram blocks in v. 9.0 and WordPress 5.6
  • Updated 2020-08-18
    • Replaced ‘More Options’ – new screenshot
    • Added “Move To” and “Copy” section under More Options
  • Created 2020-06-05

Was this article helpful? How could it be improved?