Docs        Troubleshooting

How to fix the broken Facebook and Instagram oEmbed issue in WordPress

WordPress removed Facebook and Instagram oEmbed support on 24 October 2020, breaking existing embeds. How to fix yours.

Would you like to fix Facebook and Instagram links that no longer show as embedded posts in WordPress?

In this guide, we’ll walk you through turning on oEmbeds in the Smash Balloon plugins. Your Facebook and Instagram links then display as posts again. You need admin access to your WordPress site.

Before you get started, make sure the Facebook Feed plugin or the Instagram Feed plugin is installed and activated on your WordPress site. Both the free and the paid versions include the oEmbeds page.

Here is what we will cover.

Why Did Embeds Stop Working?

When you paste a link to a Facebook or Instagram post into WordPress, it normally shows the post instead of the link. That is called an oEmbed.

After API changes from Facebook, WordPress can no longer embed these posts on its own. The Smash Balloon plugins can handle these embeds for you through a page called oEmbeds. Next, you’ll turn on oEmbeds for each network.

Fixing Facebook oEmbeds

To get started, we’ll turn on Facebook oEmbeds.

  1. Go to Facebook Feed » oEmbeds in your WordPress dashboard.
  2. In the Facebook box, click Enable.
  3. You leave your site for a moment to connect your account. Follow the directions on the screen. When you finish, you return to the oEmbeds page.
  4. Check that the page shows “oEmbed account successfully connected” and that the Facebook box says “Facebook oEmbeds are turned on”.

All your existing and new Facebook embeds should now work with no other input required. The plugin handles links to Facebook posts, photos, videos, and Watch videos.

If you only have the Instagram Feed plugin, use the Facebook box on its oEmbeds page instead. The Instagram Feed plugin then asks you to install and activate the free Facebook Feed plugin. Once it is active, follow the steps above.

If you also embed Instagram posts, you’ll turn those on next.

Fixing Instagram oEmbeds

If you already turned on Facebook oEmbeds, Instagram oEmbeds may be on too, because the connection is saved for both plugins. If the Instagram box says “Instagram oEmbeds are turned on”, there’s nothing more to do. Otherwise, follow these steps.

  1. Go to Instagram Feed » oEmbeds in your WordPress dashboard.
  2. In the Instagram box, click Enable.
  3. You leave your site for a moment to connect your account. Follow the directions on the screen. When you finish, you return to the oEmbeds page.
  4. Check that the page shows “oEmbed account successfully connected” and that the Instagram box says “Instagram oEmbeds are turned on”.

All your existing and new Instagram embeds should now work with no other input required. The plugin handles links to Instagram posts, Reels, and TV videos.

If you only have the Facebook Feed plugin, you can still use its oEmbeds page. Then click Enable in the Instagram box. The plugin asks you to install and activate the free Instagram Feed plugin first. Once it is active, follow the steps above.

That’s it! Your Facebook and Instagram links now show as embedded posts.

Frequently Asked Questions

Below, we’ve answered some of the most common questions about Facebook and Instagram oEmbeds.

Do I need the paid version to fix oEmbeds?

No. The oEmbeds page is in both the free and the paid versions of the Facebook Feed and Instagram Feed plugins.

Do I need both plugins?

Only if you want both kinds of embeds. Facebook oEmbeds need the Facebook Feed plugin and Instagram oEmbeds need the Instagram Feed plugin. If you click Enable for the one you are missing, the plugin offers to install or activate it.

If I connect in one plugin, is the other one connected too?

Yes. The connection you make is saved for both plugins. The other plugin’s oEmbeds page can then use it.

How do I turn oEmbeds off?

To turn oEmbeds off, click Disable in the Facebook box or the Instagram box on the oEmbeds page. Each Disable button turns off only that network and removes its saved connection. To turn it back on, click Enable and follow the directions again.

Which links can I embed with the plugin?

For Facebook, links to posts, photos, videos, and Watch videos, including fb.watch links. For Instagram, links to posts, Reels, and TV videos.

support

Couldn’t find your answer in the docs?

Contact Support