Smash Balloon Social Post Feed


Display Facebook posts on your website. Completely customizable, responsive and search engine crawlable Facebook feeds. Display multiple Facebook feeds from any public Facebook page, and completely match the look and feel of the site with tons of Facebook feed customization options!

“The perfect Facebook plugin with amazing support! What else do you want? Get it!”JoeJeffries

“I honestly cannot recommend this Facebook plugin enough. The plugin itself is gorgeous and super customizable, and if you run into trouble…support will get you out of it. Five Stars across the board.”pamsavoybarnett

Please note: This free Facebook plugin allows you to display text and links from Facebook posts. To display photos, videos, comments, and more, we offer a Pro version of the plugin. See the Pro Version section below for more information.

Facebook Feed Features

  • Super simple to set up – 1 minute quick setup with no Facebook Developer App required
  • Display feeds from ANY Facebook page – even Facebook pages you aren’t an admin of
  • Completely Customizable – By default the Facebook feed will adopt the style of your website, but your Facebook feeds can be completely customized to look however you like – with tons of styling and customization options!
  • Facebook feed content is crawlable by search engines adding SEO value to your site – other Facebook plugins embed the feed using iframes which are not crawlable
  • Completely responsive and mobile optimized Facebook feeds – layout looks great on any screen size and in any container width
  • Display feeds from multiple different Facebook pages and use the shortcode to embed your Facebook feeds into a page, post or widget anywhere on your site
  • Caching means that your Facebook posts load lightning fast. Set your own caching time – check for new posts on Facebook every few seconds, minutes, hours or days. You decide.
  • Show and hide certain parts of each Facebook post
  • Show or hide the Facebook profile picture and name of the author above each Facebook post
  • Display Facebook posts by just the page owner, everyone who posts on your Facebook page, or only other people
  • Control the width, height, padding and background color of your Facebook feed
  • Customize the size, weight and color of text in your Facebook posts
  • Choose to set a background color and rounded corners on your Facebook posts
  • Supports Facebook tags – creates links when using the @ symbol to tag people in your Facebook posts
  • Automatically links hashtags used in posts to the hashtag page on Facebook
  • Select the number of Facebook posts to display in your Facebook feed
  • Use the shortcode options to style multiple Facebook feeds in completely different ways
  • Set a maximum character length for both the text and descriptions of your Facebook posts
  • Create a customizable Facebook header with a range of icons for your Custom Facebook Feed
  • Localization/i18n support to allow every part of the Facebook feed to be displayed in your language
  • Add your own custom CSS

Pro Version (Custom Facebook Feed Pro)

In order to maintain the free version of the Custom Facebook Feed plugin on an ongoing basis, and to provide quick and effective support for free, we offer a Pro version of the plugin. Custom Facebook Feed Pro allows you to display photos, videos, the number of likes, shares, reactions and comments for each Facebook post, choose from multiple layout options, filter Facebook posts by type or #hashtag/string, load more Facebook posts into your feed, and more. Click here for a full list of all differences between the Custom Facebook Feed free and Pro versions.


  • Increase social engagement between you and your users, customers, or fans
  • Save time by using the Custom Facebook Feed to generate dynamic, search engine crawlable content on your website
  • Get more likes by displaying your Facebook content directly on your site
  • Improve your SEO as all of that quality keyword-rich Facebook content from posts and Facebook comments is directly embedded into your website
  • Display your Facebook content your way to perfectly match your website’s style
  • No Coding Required – choose from tons of built-in customization options to create a truly unique feed of your Facebook content.
  • The Custom Facebook Feed plugin is updated regularly with new features, bug-fixes and Facebook API changes
  • Support is quick and effective
  • We’re dedicated to providing the most customizable, robust and well supported Facebook feed plugin in the world!

How to use the Custom Facebook Feed plugin

One of our main priorities has always been to make our Custom Facebook Feed plugin as easy as possible to setup and use. Once you’ve installed the plugin there are only a few steps to get up and running:

  • 1) Click the big blue Facebook button on the plugin settings page. This will prompt you to log into your Facebook account to authorize the plugin.
  • 2) Once you’ve connected your Facebook account, save the plugin settings.
  • 3) Then simply copy and paste the [custom-facebook-feed] shortcode onto any page, post, or widget where you want the Facebook feed to be displayed.

That’s it! You can then customize the Facebook feed as needed using the settings on the Facebook Feed > Customize page.

For full step-by-step setup directions with screenshots, see here.

Requesting support

Customer support is a huge deal to us. We pride ourselves on always providing quick, effective, and courteous support to all of our users. If you’re having an issue using the Custom Facebook Feed plugin then just let us know and we’ll be there to help as soon as possible. You can either open a ticket on the support forum on, or directly on the Custom Facebook Feed section of our website. We also have a large collection of help documentation and FAQs on our website for all common issues related to the Custom Facebook Feed plugin.

Who’s behind this plugin?

We’re Smash Balloon; a fun-loving WordPress plugin development company birthed into existence in early 2013. We specialize in creating social media plugins that are not only intuitive and simple to use, but also designed to integrate seamlessly into your website and allow you to display your social media content in powerful and unique ways. Over 1 million awesome people have decided to actively use our free plugins, which is an incredible honor that we don’t take lightly. This compels us to try to provide the quickest and most effective customer support that we can, blowing users away with the best customer service they’ve ever experienced.

To find out more about the team, see here.

Check out our other free plugins for Instagram, Twitter, and YouTube.

At Smash Balloon we have two goals:

  1. Creating and maintaining the most useful, functional, customizable, robust and down-right awesomist Facebook feed plugin your website has ever seen.
  2. To provide the quickest, friendliest and most mind-blowingly amazing product support you have ever experienced.


  • By default the Facebook feed inherits your theme's default styles and the Facebook feed is completely responsive
  • Completely customize the way your Facebook feed looks to perfectly match your site
  • Use custom CSS to customize every part of the Facebook feed
  • Display Facebook events in your Facebook feed
  • Configuring the Custom Facebook Feed plugin
  • General Facebook Feed options - Custom Facebook Feed Layout and Style page
  • Facebook Feed Typography options - Custom Facebook Feed Layout and Style page
  • Misc Facebook Feed options - Custom Facebook Feed Layout and Style page
  • It's super easy to display your Facebook feed in any page or post


This plugin provides 1 block.

Custom Facebook Feed


  1. Install the Custom Facebook Feed either via the WordPress plugin directory, or by uploading the files to your web server (in the /wp-content/plugins/ directory).
  2. Activate the plugin through the ‘Plugins’ menu in WordPress.
  3. Navigate to the ‘Facebook Feed’ settings page to configure your feed.
  4. Use the shortcode [custom-facebook-feed] in your page, post or widget to display your feed.
  5. You can display multiple feeds of different Facebook pages by specifying a Page ID directly in the shortcode: [custom-facebook-feed id=smashballoon num=5].


For a full list of FAQs and help with troubleshooting please visit the FAQ & Troubleshooting section of the Smash Balloon website

How do I find the Page ID of my Facebook page?

If you have a Facebook page with a URL like this: then the Page ID is just smashballoon. If your page URL is structured like this: then the Page ID is actually the number at the end, so in this case 123654123654123.

Due to recent changes to the Facebook API it is unfortunately no longer possible to display a feed from a Facebook Group.

Copy and paste the ID into the Pro demo to test it.

Are there any limitations on which Facebook page or group feeds I can display?

The Facebook feed you’re trying to display has to be from a publicly accessible Facebook page. This means that you can’t display the feed from your own personal Facebook profile or Facebook group. This is to do with Facebook’s privacy policies. You can’t display a non-public Facebook feed publicly.

If your Facebook page has any restrictions on it (age, for example) then it means that people have to be signed into Facebook in order to view your page. This isn’t desirable for most Facebook pages as it means that it isn’t accessible by people who don’t have a Facebook account and that your Facebook page can’t be crawled and indexed by search engines.

An easy way to determine whether your Facebook page is set to public is to sign out of your Facebook account and try to visit your page. If Facebook forces you to sign in to view your page then it isn’t public. You can change your Facebook page to public in your Facebook page settings simply by removing any age or location restrictions you have on it (screenshot), which will then allow the Custom Facebook Feed plugin to access and display your feed.

Can I display feeds from multiple Facebook pages?

You can set your default Facebook Page ID on the Custom Facebook Feed settings page within the WordPress admin, you can then define different page IDs in the shortcodes you use to show multiple feeds from different Facebook pages. Just use the id option in your shortcode like so: [custom-facebook-feed id=another_page_id]. You can use as many shortcodes as you like with as many different IDs as you like.

Can I display the feed from a personal Facebook profile?

Due to Facebook’s privacy policy you’re not able to use the plugin to display all of your posts from a personal profile, only from a public page, as posts from a personal profile are protected for privacy reasons. You may have limited success in displaying certain posts from a personal profile but most posts are not able to be displayed.

If you’re using the profile to represent a business, organization, product, public figure or the like, then we’d advise converting your profile to a page per Facebook’s recommendation, as there are many advantages to using pages over profiles.

Once you’ve done so, the plugin will be able to retrieve and display all of your posts.

Can I show photos and videos in my Custom Facebook feed?

This free plugin only allows you to display text from your Facebook posts. To display photos and videos in your feed you would need to upgrade to the Pro version of the plugin. Try out a demo of the Pro version on the Custom Facebook Feed website, and find out more about the Pro version here. Click here for a full list of all differences between the free version and Pro version.

Can I show the comments, shares and likes associated with each Facebook post?

This is a feature of the Pro version of the plugin. To display comments, shares and likes you would need to upgrade from the free version to the Pro version.

Is the content of my Custom Facebook Feed crawlable by search engines?

It sure is. Unlike other Facebook plugins which use iframes to embed your Facebook feed into your page once it’s loaded, the Custom Facebook Feed uses PHP to embed your Facebook feed content directly into your page. This adds dynamic, search engine crawlable content to your site.

How do I embed the Custom Facebook Feed directly into a WordPress page template?

You can embed your Facebook feed directly into a template file by using the WordPress do_shortcode function: <?php echo do_shortcode('[custom-facebook-feed]'); ?>.

My Facebook feed posts are not showing up, or all I can see is the Facebook Like box but no posts

Please refer to this FAQ for potential solutions on how to resolve this issue.

Create a basic slideshow from your Facebook posts

The Custom Facebook Feed plugin doesn’t currently have a slideshow feature built into it, but it’s possible to achieve a basic slideshow by doing the following:

1) Add a class to the shortcode of the Facebook feed that you want to convert into a slideshow:

[custom-facebook-feed class="slideshow"]

2) Set the number of posts to display to be the number of Facebook posts you want to include in the slideshow (10 for example). You can do this by using the num shortcode option:

[custom-facebook-feed class="slideshow" num=10]

3) Add the following to the plugin’s Custom JavaScript section, which is under the ‘Misc’ tab on the plugin’s ‘Customize’ page. Please note, if you change the class option in the shortcode above to be anything but “slideshow” then make sure to change that on the first line of the snippet below:

var shortcodeClass = 'slideshow',
    cffSpeed = 5000, 
    $cff = $('#cff.'+ shortcodeClass);
    $cffItem = $cff.find('.cff-item'),
    cffNum = $cffItem.length,
    cffCur = 0;
setTimeout(function(){ $cff.find('.cff-item').eq(0).show(); }, 200);
    $cff.find('.cff-item').eq(cffCur).fadeOut( "fast", function() {
        if( cffCur == cffNum-1 ) cffCur = -1;
}, cffSpeed);

4) You can change the speed of the transition by editing the cffSpeed = 5000 value at the top of the snippet. 5000 is equal to 5 seconds (5000ms).

Changing the font in your Facebook feed and using Google Fonts

Please refer to this FAQ for directions on how to use Google fonts in your Facebook posts.

Can I display my Facebook posts horizontally or in multiple columns?

Please refer to this FAQ for directions on how to display your Facebook posts in multiple columns.

My Facebook feed appears to have stopped updating / working

If your Facebook feed doesn’t appear to be showing the most recent Facebook posts then the most likely explanation is that the recent Facebook posts in your feed may be shared from a user’s personal Facebook profile. Facebook’s privacy policy doesn’t allow posts that you share from personal Facebook profiles to be shared outside of Facebook as the posts don’t technically belong to your Facebook page, they belong to the user who posted it to their personal Facebook profile. There’s an example of a post shared from a user’s personal Facebook profile here.

Please note, this isn’t a limitation of our plugin, it’s a restriction which Facebook places on it’s content in order to protect the privacy of their Facebook users.

Potential solutions

  • You could re-post the Facebook post to your page rather than sharing it to your Facebook page. If you re-post the content as your own post on your Facebook page then the content now originates from your Facebook page and will be displayed in the Facebook feed on your website.

  • If you were to share a post from another Facebook page or public source, rather than sharing it from someone’s personal Facebook profile, then it would show up in your feed outside of Facebook, but by default any posts that originate from a personal Facebook profile are protected by Facebook’s privacy policy and is the private content of that Facebook profile owner.

I’m receiving an error message when trying to display my Facebook posts

Please refer to our Error Message Reference page for information on how to resolve common error messages.

Creating a Masonry grid layout from your Facebook posts

Please refer to this FAQ for directions on how to create a Masonry grid layout from your Facebook feed posts.

How do I customize my Facebook feed?

You can customize the Facebook feed by setting the options on the Customize page, which can be found under the Facebook Feed menu in your left hand WordPress admin menu. If you need even deeper customization than the built in options allow then you can add your own CSS to the plugin in the Custom CSS section under the Misc tab to further customize your Facebook feed.

You can also override these styles for individual Facebook feeds by setting options within the shortcode. For example, you can change the height of a specific Facebook feed like so: [custom-facebook-feed height=500px].

The Custom Facebook Feed shortcode options aren’t working

The most common causes of this are:

1) There’s HTML tags within the [custom-facebook-feed] shortcode which are preventing it from working correctly

If you copied and pasted the shortcode into the Visual editor on your WordPress page/post editor then it may have inadvertently included some HTML tags from the page that you copied it from. The easiest way to check this is to view the ‘Text’ view in your WordPress editor and see whether there are any stray HTML tags in the shortcode itself.

2) The shortcode includes curly single quote characters

If your shortcode includes single quotes then check that they are the standard single quotes and not the curly kind.

3) Typo in the shortcode option

Ensure that there aren’t any spelling errors in the shortcode options that you’re using and that the format is consistent with that demonstrated on the Shortcode Options reference page.

Facebook avatar pictures aren’t showing up in my Facebook feed

The most common reason for this is that an add-on or extension you have installed in your web browser is blocking the pictures being loaded from Facebook. Try checking to see whether you have any add-ons or extensions installed in your browser and, if so, try disabling them to see whether that solves the problem and displays the pictures from Facebook.


May 22, 2020
Had an issue with a license key, problem resolved in less then 12 hours! Highly recommended. Thank You Smash Balloon
May 13, 2020
My FB "Deals" group needed a way to cross-post to my website but none of the plugins I found did what SB does. Smash Balloon does everything it says it does and more! Best yet is the tech support that I received after encountering an issue after I updated some plugins. I inadvertently messed everything up so I reached out to SB Tech Support and within hours I recvd the help I needed. I was very impressed with the level of detail they went into (some providers force you to go back n forth with numerous emails explaining and asking questions and explaining and asking questions) but not these guys. I highly recommend SB for your social media feed needs. EJM Been There, Bought That (FB)
Read all 1,212 reviews

Contributors & Developers

“Smash Balloon Social Post Feed” is open source software. The following people have contributed to this plugin.


“Smash Balloon Social Post Feed” has been translated into 3 locales. Thank you to the translators for their contributions.

Translate “Smash Balloon Social Post Feed” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • Fix: Some connection error notices not clearing automatically.


  • New: Email alerts for critical Facebook feed issues. If there’s an issue with a Facebook feed on your website which hasn’t been resolved yet then you’ll receive an email notification to let you know. This is sent once per week until the issue is resolved. These emails can be disabled by using the following setting: Facebook Feed > Customize > Misc > Feed Issue Email Report.
  • New: Admin notifications for critical Facebook feed issues. If there is an error with a Facebook feed, admins will see notices in the dashboard and on the front-end of the site along with instructions on how to resolve the issue. Front-end admin notifications can be disabled by using the following setting: Facebook Feed > Customize > Misc > Disable Admin Error Notice.
  • New: Added a WordPress ‘Site Health’ integration. If there is a critical error with your feeds, it will now be flagged in the site health page.
  • New: Added “About Us” page for those who would like to learn more about Smash Balloon and our other products. Go to Facebook Feed -> About Us in the dashboard.


  • New: Added a “Custom Facebook Feed” Gutenberg block to use in the block editor, allowing you to easily add a Facebook feed to posts and pages.
  • New: Added support for translations.


  • Tested with upcoming WordPress 5.4 update.
  • Tweak: Updated Facebook API calls
  • Fix: Minor bug fixes


  • Tweak: Added a text link in the Facebook Feed settings page footer to our new free YouTube plugin
  • Tweak: When reconnecting a Facebook account on the settings page, if there’s an issue with the existing Facebook access token then it’ll be automatically replaced.
  • Tweak: Added ‘rel=”noopener”‘ to all external links and added ‘rel=”noreferrer”‘ to all non-Facebook links. Thanks to Dev VIP for the suggestion.
  • Fix: Fixed an issue with some Facebook call-to-action link URLs when a link protocol wasn’t included
  • Fix: Fixed a JavaScript conflict with the Forminator plugin
  • Fix: Fixed duplicate Facebook post message displaying due to ellipsis HTML character
  • Fix: If a shared Facebook link post had no post text then the link title was used causing it to be displayed twice in the Facebook post


  • Fix: Fixed a JavaScript error in the admin caused by the previous update. Apologies for any inconvenience.


  • Fix: Fixed an issue with Facebook post date timezones due to changes in the WordPress 5.3 update
  • Fix: Fixed a rare issue where a JavaScript error would occur in the WordPress admin if a Facebook account was manually connected and the Facebook Page ID used was the full URL
  • Fix: Fixed a JavaScript error in the admin when using older web browsers
  • Tweak: Improved the manual account connection process
  • Tweak: Some minor UI tweaks to match the new WordPress 5.3 UI style


  • New: Added a backup cache so the Facebook feed will still display even if there’s an error from the Facebook API.
  • New: You can now easily manage multiple Facebook page or group accounts on the Facebook Feed plugin settings page allowing you to easily add them to other Facebook feeds on your site. When you connect a Facebook page or group you will now see it listed in the “Connected Accounts” section. You can add it to the primary Facebook feed or to another Facebook feed by using the new account shortcode option.
  • Tweak: Added a filter which can be used to filter the Facebook API data when returned; cff_filter_api_data.
  • Tweak: Updated Facebook API error messages
  • Fix: Fixed an issue with some @tag links in Facebook post text due to a Facebook API change
  • Fix: Fixed a rare issue with ellipsis chracter symbols in Facebook shared link descriptions causing the entire link description not to be displayed


  • Tweak: Added the link source URL below the title for Facebook shared link posts
  • Fix: Some themes would prevent the Facebook “Share” link from working successfully
  • Fix: Fixed an issue with the “Feed Columns” setting not working if the minified versions of the Custom Facebook Feed plugin CSS/JavaScript files were being used


  • New: Added a “Feed Columns” setting to allow you to display your Facebook feed in multiple columns. This can be found under the “General” tab on the “Customize” page, or by using the cols and colsmobile shortcode settings.
  • New: Updated to use v4.0 of the Facebook API


  • New: Facebook Groups are making their long-awaited return to the Custom Facebook Feed plugin! Just click the ‘Log in and get my Facebook Access Token’ button on the Facebook Feed Settings page and select ‘Facebook Group’. Follow the prompts to connect your Facebook Group and display your feed.
  • Fix: Fixed an issue where a lists of Facebook groups or pages wouldn’t be displayed when retrieving a Facebook Access Token due to a server configuration issue
  • Fix: Photo icons weren’t showing for Facebook album posts
  • Tweak: Now uses the Facebook visitor_posts endpoint to display visitor Facebook post feeds


  • New: Added support for v3.3 of the Facebook API.
  • Fix: The Facebook Access Token selection area was being cut off on small screens when a lot of Facebook pages were listed.


  • New: You can now select between a “Regular” or “Boxed” Facebook post style. Settings for this can be found at: Facebook Feed > Customize > Style Posts > Post Item. A Box Shadow setting has been added to the “Boxed” Facebook post style.
  • New: Added some settings to control the size and color of the Facebook shared link URLs and descriptions. These can be found at: Facebook Feed > Customize > Style Posts > Shared Link Boxes.
  • New: Improved the Facebook Access Token retrieval process to make it more intuitive.
  • Tweak: Facebook avatar images are now circular to match Facebook.
  • Tweak: Animated the social media icons when the Facebook “Share” button is clicked.
  • Tweak: Changed the way the Facebook Like Box loads to avoid a conflict with the Facebook Messenger widget. It no longer uses the Facebook JavaScript SDK.
  • Tweak: Changed the elements used for icons from <i> to <span> to aid accessibility.
  • Tweak: Removed the Google+ share option as the platform has been deprecated.
  • Tweak: Removed the social media share widgets from the footer of the admin so that they’re only loaded when the “Share the plugin” button is clicked.
  • Fix: The Custom Facebook Feed plugin now uses the built-in WordPress HTTP API to get data from Facebook instead of making it’s own cURL requests to the Facebook API.
  • Fix: Fixed an issue where the Facebook avatars of people posting to the Facebook page weren’t being displayed. Individual Facebook API requests for avatars have now been removed and bundled into the main Facebook API request.
  • Fix: If the link to the Facebook profile of a visitor posting to your page is not available then remove the link from the Facebook avatar and author name.
  • Fix: Fixed an accessibility error caused by the Facebook share icons being empty links.
  • Fix: Removed the use of the ENT_HTML5 constant as it isn’t supported in PHP 5.4.
  • Fix: Fixed a rare issue with Facebook tags in Facebook post stories when the locale was set to be Greek.


  • New: Added support for Facebook Notes in timeline feeds. If your Facebook timeline feed contains a note then the Custom Facebook Feed plugin will now get the content from the note and display it within the Facebook post.
  • New: Facebook call-to-action buttons – such as “Learn More”, “Shop Now”, and “Message Facebook Page” – are now supported in your Facebook posts. These text strings can be translated using the settings at: Facebook Feed > Customize > Custom Text/Translate
  • New: Added a setting that you can enable if you are displaying Facebook posts from a restricted (non-public) Facebook page. This will allow the Facebook page avatar to be displayed, and is located at: Facebook Feed > Customize > Misc > Misc Settings > Is Facebook Page restricted?
  • New: If a Facebook visitor posts to your Facebook page then their avatar will now be displayed and cached for 6 months. To clear the cache of these Facebook avatar images use the button located at: Facebook Feed > Customize > Misc > Misc Settings > Clear Avatar Cache
  • Tweak: The Timezone setting can now be set in the Custom Facebook Feed shortcode. Eg: timezone="America/Los_Angeles"
  • Tweak: Minor UI changes to the Facebook Feed admin pages
  • Tweak: Reduced some of the Facebook data in the System Info
  • Fix: If you backdate a Facebook post it will now be ordered correctly in your Facebook feed
  • Fix: Fixed a theme conflict related to the Color Picker in the Facebook Feed admin section
  • Verified compatibility with WordPress 5.0 and Gutenburg


  • Important: If you are displaying a Facebook feed from a Facebook page which you are not an admin of then it is advised that you obtain a new Facebook Access Token in the plugin using the “Log in and get my Access Token” button. This will switch you from using the “SlickRemix” app to using our own “Smash Balloon” Facebook app which was recently approved by Facebook, and will prevent you from experiencing any potential interuptions in your Facebook feeds going forward. This will be the final time this is required.
  • Fix: Fixed a rare issue caused by some themes including the JavaScript file incorrectly


  • Tweak: Made some adjustments to the Facebook Access Token login process


  • New: Now easily get your own Facebook Access Token to avoid any Facebook connection issues. Simply click the blue Facebook “Log in and get my Facebook Access Token” button on the Custom Facebook Feed settings page and connect your Facebook account to get your token. The Facebook Access Token will work to get Facebook posts from ANY Facebook page. Thanks to our friends at SlickRemix for powering our new login and getting the Custom Facebook Feed plugin back up and running again!
  • Tweak: Removed the minimum caching time if you’re using your own Facebook Page Access Token


  • Important: If you are displaying Facebook posts from a Facebook page that you are an admin of then it is now highly recommended that you retrieve your own Facebook Access Token for that Facebook page to avoid any Facebook API rate limit errors. Simply follow these step-by-step instructions to obtain one.


  • Fix: Fixed an issue where Facebook API errors were being cached


  • Fix: Replaced all HTTP links in the Facebook feed with HTTPS
  • Fix: Fixed a rare issue which affected the layout of other Facebook widgets
  • Fix: Automatically remove slashes at the end of the Facebook Page ID as it caused an error
  • Fix: The API response test in the System Info now only tests with your Facebook token if you have the “Use my own Facebook Access Token” setting enabled
  • Fix: Fixed an issue which caused an occasional Facebook API rate limit error


  • Fix: Removed an unnecessary Facebook API call
  • Fix: Removed a PHP notice which was displayed under rare circumstances
  • Fix: Minor Facebook bug fixes


  • Fix: Fixed an issue connecting to the Facebook API caused by a recent Facebook platform change
  • Tweak: Increased the minimum caching time to be 15 minutes to reduce Facebook API requests


  • Important: Due to sudden changes in the Facebook API it is no longer possible to display Facebook posts from a Facebook Group. Please see here for more information. We apologize for any frustration or inconvenience this has caused.
  • Removed: Due to Facebook API restrictions, it is no longer possible to display information about a Facebook event when it is posted or shared to your Facebook Page timeline.


  • Fix: Prevented a PHP notice which would be displayed under rare circumstances in the Facebook feed
  • Fix: Replaced a function due to a deprecation in PHP 7.2


  • New: Added the Facebook post story as part of the page/author name at the top of the Facebook post
  • New: Added an option to use minified versions of the plugin CSS and JavaScript files: Facebook Feed > Customize > Misc > Misc Settings > Minify CSS and JavaScript files
  • New: Added support for clearing the cache of major caching plugins when the Facebook feed cache is cleared. You can enable this by setting the following setting to be “Yes”: Facebook Feed > Customize > Misc > Misc Settings > Force cache to clear on interval
  • Tweak: Improved the text truncation so that it applies to both the Facebook post text and Facebook description as one block of text and accounts for HTML link tags
  • Tweak: Added an “Auto” option to the Facebook Post Limit setting where it will automatically adjust the post limit based on the number of Facebook posts you choose to display in your Facebook feed
  • Tweak: Reorganized the Custom Facebook Feed settings pages to be more intuitive
  • Tweak: Added aria-hidden=true to icons to help improve accessibility
  • Tweak: The icon font stylesheet handle has been renamed so it will only be loaded once if another of our social media plugins is installed
  • Tweak: Facebook error messages are now only shown to admins
  • Tweak: Added a setting to workaround a theme issue that affects the shortening of the Facebook post text. If you’re experiencing an issue with the shortening of Facebook post text then you can enable the following setting: Facebook Feed > Customize > Misc > Misc Settings > Fix Facebook text shortening issue
  • Fix: Included a fallback in case the Facebook author name and avatar aren’t available in visitor Facebook posts
  • Fix: Fixed an issue with apostrophes in the Facebook feed header not being escaped correctly
  • Fix: Fixed an issue with the Facebook icons when Font Awesome 5 was added to a site
  • Fix: Added support for the @[ID:page-name] Facebook tagging format
  • Fix: The Facebook post description is now able to be displayed even if the Facebook post text is hidden

See changelog for all versions.