1. Knowledge Base
  2. >
  3. Results
  4. >
  5. WordPress: Facebook API Change - oEmbed

WordPress: Facebook API Change - oEmbed

On October 24, 2020, an API update will cause broken links for Facebook and Instagram feeds across the web.

To fix this and still use oEmbed, users must create a developer account and generate an app ID.

What is oEmbed?

For over ten years, Facebook oEmbed has made it simple for users to share media on websites and social networks without touching any code. Facebook security updates will now require users to get developer app credentials before embedding their content.

What is the Impact of the API Change?

While these changes don't necessarily impact your website, many plugins depend on oEmbed, which will affect unauthenticated content embedded from Facebook/Instagram to break.

How Do I Fix This?

If you notice that the embedded content has broken after the API change, you can install one of the three plugins listed below in the Recommended Plugins section. These plugins help restore Facebook and Instagram embeds either by providing a Facebook developer account and app id, or helping users generate their own.

Please note that the oEmbed Plus plugin will require you to create a Facebook developer account and create an app to generate the API credentials to configure this plugin.

Recommended Plugins

With WordPress, users have several different choices for addressing this issue, as always. Various plugins have built creative workarounds for the deprecation of oEmbed.


Jetpack collaborated with Facebook directly to handle the generation of developer IDs on the back-end. As outlined in this article, if a user installs Jetpack and links their website to their Facebook account, the plugin will handle the process of registering a developer account on Facebook, creating an app, and generating a token all through their service.

Smash Balloon

Since Smash Balloon already has a developer account, it has found a way to share it with their users. 
From this WP Beginner article: "...Since Smash Balloon has to register an API key to create custom feeds for both Facebook and Instagram, we didn’t need any additional authentication to restore this functionality.”

Users already using Smash Balloon simply have to update their plugin installation, and those who are interested in using Smash Balloon can follow these steps:

  1. On the WordPress dashboard, locate and select the Smash Balloon’s Facebook / Instagram feed plugin. 
  2. Click the oEmbed navigation menu.
  3. Hit Connect.

oEmbed Plus

This plugin assists users in registering a Facebook developer ID and creating an app to get the API credentials.

How to Create a Facebook Developer Account

  1. Navigate to Facebook and create your Developer Account.
  2. Register a Facebook app.
  3. Add the oEmbed product.
  4. Generate your App Access Token.
  5. Once you have generated your Token, oEmbed Plus can be installed and configured.

How to Use oEmbed Plus

  1. Users should install oEmbed Plus on their WordPress website.
  2. Navigate to your WordPress Admin Dashboard.
  3. Choose Settings, then select Writing.
  4. You will be prompted to provide your App ID and App Secret. Enter these details.
  5. Click Save Changes.

Once saved, the broken and existing embedded content for your website should continue to work, and new content will use the new APIs going forward.

To learn more about configuring oEmbed Plus, please see PHP.Watch's article: WordPress oEmbed Plus.