Docs    facebook    All Docs

Installing and Configuring the Custom Facebook Feed WordPress Plugin

Watch the videos below for an overview of how to setup and use the WordPress plugin, or scroll down for step-by-step written instructions. 30-Se...

How to get a Facebook Access Token

Known issue: Error: (#200): Due to some sudden Facebook changes the directions below will no longer work for new Facebook apps. You can now just ...

Date Formatting Reference

You can use the reference below to create your own custom date format. Below are a few examples and a reference for what each letter represents. ...

Custom Facebook Feed PHP Standalone Setup and Configuration

1) Once you've purchased the Custom Facebook Feed you'll be presented with the purchase confirmation screen which displays your license key and a l...

Setting up the Free Custom Facebook Feed WordPress Plugin

1) Once you've installed the plugin click on the Facebook Feed item in your WordPress menu   2) Click on the button labeled Connect ...

Custom Facebook Feed WordPress Plugin Shortcode Reference

Below is a list of available options to use within your shortcode. These options are not required, and if they are not specified then the default v...

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

On October 24th, 2020, WordPress is removing support for Facebook and Instagram oEmbeds. This will affect millions of WordPress users and result in...

Custom Facebook Feed PHP Standalone Settings Reference

Below is a list of optional settings you can use to customize your feed. Name Setting Options Description Example Settings ...

How to create an Access Token to Manually connect a Facebook Page

If you have been asked to provide an Access Token by your Web Developer or Web Content Manager to set up a Facebook Feed using our plugin, or if yo...

Specifying exact image sizes using the cff_resized_image_sizes filter

As Facebook only provides large image sizes in their API for timeline feeds then it often results in images being displayed in your feed which are ...

Receiving a Facebook PPCA Error Notice

If you are receiving a "PPCA Error" notice then it means that this feed will stop updating after September 4, 2020, due to changes in the Facebook ...

Link to the Facebook Page of Group after loading posts X number of times

First, add a class to the feed that you want to apply this to: [custom-facebook-feed class="cff-limit-clicks"] Then, add this to the plugin's...

Facebook API Change - Displaying Feeds from Facebook Pages you Don't Have Access to - September 4, 2020

In this article:  How Will This Affect Me? | PPCA Error | Does This Affect Facebook Groups? | Connecting Multiple Facebook Pages | Do I Need to Upd...

Display a Facebook Page and a Facebook Group

You can connect both pages and groups to the plugin and display each one on the same page or on different pages on your site using the steps below....

Unknown Error When Trying To Display Posts

If you are seeing an error message "Error: An unknown error has occurred.Type: OAuthException" this is due to a bug in Facebooks API related to ret...

Renew or extend an Events Access Token

It is now possible to permanently extend an Events Access Token so that it never expires. Just enter your existing 60-day Access Token into the too...

Adding our app to a Facebook Group

In order to display a feed of posts from a Facebook group an admin of the groups must first add our app in the Facebook group settings by doing the...

Display a Facebook Group Feed

With V3.9 of the Custom Facebook Feed Pro plugin it's now possible to display feeds from Facebook Groups. What can I display? You can display con...

Change text of Facebook post Call-To-Action buttons

$('.cff-cta-link a').each(function(){ if( $(this).text() == 'Book Travel' ) $(this).text('Book Now'); }); This will change the button text "Bo...

Changing the size of the Facebook author avatar

Add this to the plugin's Custom JavaScript section (Facebook Feed > Customize > Misc): $('.cff-author-img img').each(function(){ $(this)....

Add dates to Photo, Video, and Album feeds

Photo Feeds Add the following to the plugin's "Custom JavaScript" section, which can be found under Customize > Misc in the settings: function...

Can I use the plugin with the WordPress 5.0 block page editor (Gutenberg)?

Yes, we have an official Gutenberg block that can be used as shown below: You can also add the shortcode to any block in the Gutenberg page ...

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

There are a few common reasons why your feed might not be displaying. It's recommended to go through the following checks before requesting support...

Email Report Is Not Sending or Not Showing up in My Inbox

If your email report is not showing up in your inbox, even though there is an error occurring with a feed, it's likely that the message is being bl...

Displaying Facebook Events with the Facebook "Page Plugin" widget

Due to Facebook API changes, it is not currently possible to display events from Facebook pages that you're not an admin of using the Facebook API....

How to Prevent Your oEmbed Access Token From Expiring

To prevent your oEmbed token from expiring Facebook required you to create a Facebook page. The page does not have to be actively used or have any ...

Reauthorizing our Facebook App

If you need to reauthorize our plugin app (or you'd like to remove it altogether) then you can do so by going to the app settings within your Faceb...

Image not included when sharing post from Instagram to Facebook Feed

Update: This issue should be fixed in v3.9 of the Custom Facebook Feed Pro WordPress plugin If you are sharing a post from your Instagram accoun...

Create a custom title in your Facebook posts

There are a few ways to do this: Use the first line of the post text Add the following to the plugin's Custom CSS section (Facebook Feed > Cus...

Extending a Group Access Token so it never expires

In order for your Groups Access Token to never expire you must first be an admin of a Facebook "Page".  This is because Facebook Page tokens never ...

Add captions text to Photos grid layout

setTimeout(function(){ $('.cff-album-item').each(function(){ $self = $(this); $self.append( '<p style="padding:5px;height:100px;overflow:hidd...

Filtering your Facebook posts

The Custom Facebook Feed plugin has a post filtering feature built into it which allows you to filter your posts by a specific string or hashtag. Y...

Images are not displaying in the feed.

Possible Causes: Possible Cause #1 - The Free version of the plugin is still installed and activated. You can quickly check this by going ...

I'm having trouble updating a Pro WordPress plugin

If you're unable to update a Pro plugin via your WordPress Plugins page then there could be a few reasons why: Your license key isn't activated on...

WordPress Plugin Installation and Configuration

You can view this article by clicking here.

PHP Standalone Setup and Configuration

You can view this article by clicking here.

PHP Standalone Settings Reference

You can view this article by clicking here.

Displaying Facebook Videos using the WordPress Plugin

There are two main ways in which you can use the Custom Facebook Feed WordPress plugin to display videos from your Facebook page; from your Faceboo...

Displaying Facebook Photos using the WordPress Plugin

There are two main ways in which you can use the Custom Facebook Feed WordPress plugin to display photos from your Facebook page; from your Faceboo...

Displaying Facebook Events using the WordPress plugin

Due to some recent Facebook API changes there it is currently only possible to display events that you are a host of and are from a Facebook "Pag...

Displaying Facebook Albums Using the WordPress Plugin

There are three main ways in which you can use the Custom Facebook Feed WordPress plugin to display albums from your Facebook page; from your Faceb...

Getting a Facebook Access Token

You can view this article by clicking here.

My license key won't activate

If you're unable to activate your license key on your website then there could be a few reasons why. Contents: 1. Incorrect License Key 2. Exc...

Custom Facebook Feed Pro WordPress Plugin Change Log

= VERSION 3.16 - October 9, 2020 = * New: Added support for Facebook oEmbeds. When you share a link to a Facebook post or video, WordPress automat...

No Facebook posts displayed - unable to connect to Facebook API

If you're not seeing any Facebook posts in your feed then the issue may be that your website isn't currently able to connect to Facebook's API. You...

My Facebook feed appears to have stopped updating, or some posts are missing

If your Facebook feed isn't updating then it could be due to one of the following reasons: 1) Posts are shared to your Facebook Page from a user's...

The formatting of my Facebook feed is incorrect or messed up

There could be a number of causes for this: 1) The plugin's CSS file is not being loaded into your page. You can check this by right clicking on ...

The popup lightbox doesn't display photos and displays a thin line instead

The most common reason for this is that either your theme or another plugin is replacing the lightbox photo with a 1x1 pixel placeholder image. Thi...

How do I customize my Facebook feed?

WordPress plugin You can customize the feed by setting the options on the Customize page, which can be found under the Facebook Feed menu in your ...

Using shortcode options to customize your Facebook feeds

If you're only displaying one Facebook feed on your site - even if you're using it in multiple places - then you don't need to use our shortcode op...

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

There is now a built-in setting to create a multi-column masonry layout for your feed. Just use the setting in the following location: Facebook Fee...

Custom Snippets

CSS WordPress Plugin: Copy and paste these into the Custom CSS section, found under the Misc tab on the plugin's Customize page. Standalone Plugi...

Create a “pinned post” in your Custom Facebook Feed

The Facebook API doesn't include whether or not a post is pinned, however you can achieve the same result by manually moving a post to the top of y...

Display Posts Based on Shares and/or Likes

Javascript: $('#cff .cff-item').each(function(){ $self = $(this); var likes = parseInt($self.find('.cff-likes .cff-count').text()), s...

Set Height and/or Width of Each Image Cropped and Centered

1) Set a static height with a fluid width for each image: Add the following to the relevant custom code sections in the following location: Facebo...

Remove a particular string or hashtag from the post text

Just add the following to the plugin's "Custom JavaScript" section (Facebook Feed > Customize > Misc): $('#cff .cff-item').each(function(){ ...

Free WordPress Plugin Setup

You can view this article by clicking here.

Facebook pages I'm admin of aren't listed after authorizing plugin

If you've used the "Connect a Facebook account" button in the plugin to authorize the Smash Balloon Facebook app but some of the Facebook pages whi...

Add an "Invite" link to the bottom of your events

$('#cff .cff-event').each(function(){ $self = $(this); $self.find('.cff-post-links').prepend('<a class="cff-viewpost" href="'+$self.find('...

Facebook API Error Message Reference

If you receive an error message when trying to display your posts then you can use the table below to diagnose the issue and find the relevant solu...

The post text limit is not shortening the text correctly

This issue occurs with some WordPress themes due to them using their own content formatting function which overrides the WordPress default function...

Use full size images in Facebook Photo grid feed

Just add this to the plugin's "Custom JavaScript" section, which can be found at Facebook Feed > Customize > Misc. setTimeout(function(){ $...

Post author name/avatar not displayed in Facebook group posts

Due to privacy restrictions, it isn't possible to get the author information of a post in a Facebook group unless that group member chooses to allo...

How to only display the Like Box by itself

The Facebook "Like Box" widget can be optionally included in your feed, but if you'd like to only display the Like Box and not any posts then you c...

Reverse the order of comments beneath your Facebook posts

$('.cff-item').each(function(){ var $list = $(this).find('.cff-comments-wrap'); var $listItems = $list.children('.cff-comment'); $list.app...

Checking what Facebook Page an Access Token is from

To check which Facebook page your Access Token is for, you can enter it into the tool here.  It will show the Facebook page that the Access Token i...

Is it possible to display Facebook "offer" posts

Unfortunately not. Facebook doesn't allow you to retrieve and display offer posts from your Facebook page.

Only show events from the next 30 days

setTimeout(function(){ $('.cff-event').each(function(){ var $event = $(this), event_date = $event.find('.cff-date > .cff-start-date k...

Custom Facebook Feed - GDPR Compliance

Important: If you are using our Custom Facebook Feed plugin on your website then please refer to our GDPR disclosure for full details regarding com...

Add Facebook event details to the lightbox

First, make all of the event details visible in the feed by ensuring the following setting is enabled: Facebook Feed > Customize > Post Layou...

Comments and/or thumbnails in the lightbox are not loading

This is usually due to either a security plugin or a setting on your web server that is blocking the plugin from accessing the files needed to load...

I Just Upgraded to Pro But Can't Use the New Features

The "Pro" version and "free" version of Instagram Feed are separate plugins. A quick and easy way to check which version you might still be using i...

Displaying a stacked event date format

There are two different formats you can achieve; just the date and the month, or the entire date. See below for directions for each:   Dis...

Change the size of the Load More button

#cff .cff-load-more{ float: none; position: relative; width: 105px; margin: 10px auto; top: 10px; }

Reversing the order of items in a photo, video, or album feed

Add the following to the plugin's Custom JavaScript section (Facebook Feed > Customize > Misc): var postsWrap = $('.cff-posts-wrap'); var items...

Insert your own content every X number of posts

var number_of_posts = 5, content_to_add = 'Add content here', i = 1; $('#cff .cff-item').each(function(){ if( i % number_of_posts == ...

Change Border Color Around Post Box on Hover (3D Effect)

CSS: This snippet creates a 5px black border around the Post. #cff .cff-item.cff-box { box-shadow: 0 0 5px 0 rgba(0,0,0,0.5); -moz-box-shadow: ...

Change the Share Tool Tip Box

CSS: Background color:#cff .cff-share-tooltip{ background: yellow; } Icon color:#cff .cff-share-tooltip a { color: red !important;} Icon color o...

Change Background Colors and Opacity

You need to use a CSS snippet instead of using the built in color setting. You can use the color picker tool here to create a color. Then copy and...

Center the Like Box

1) Set the width of the Like Box to be 500 in the following location: Facebook Feed > Customize > General > Like Box / Page Plugin > Custom Like Bo...

Change the Header Text and Author Icon

CSS: This will center the author icon and hide the text in the header:#cff .cff-header .fa{ float: none; }#cff .cff-header span{ display: none; } ...

Automatically link the photo in each feed to a custom URL in the post text

$('#paste_post_id_here').find('.cff-photo').attr('href', 'http://custom-link-here'); You'd need to add the code snippet to the following section...

Change the background color and text color of the lightbox.

CSS .sbi_lb-dataContainer { background: #33c6a7 !important; } .sbi_lb-caption, .sbi_lightbox_username p, .sbi_lightbox_action a, .sbi_lb-num...

Display an icon when hovering over a photo or video

#cff .cff-photo-hover .fa{ display: block; } You can change the icon to be any icon listed here. To change the icon, simply add the following to...

The font in my Facebook feed isn't inherited from my website

Be default your Facebook feed should inherit the font from your website. If this isn't the case then it's possible that something in the theme is p...

Manually updating the Custom Facebook Feed plugin

If you're experiencing an issue updating the plugin automatically via your WordPress Plugins page then you can manually update the plugin in one of...

Creating a slideshow, slider, or carousel from your Facebook posts

If you're using the Pro version of the Custom Facebook Feed WordPress plugin then you can use our Carousel extension to create sliding carousels ou...

The plugin's CSS and JavaScript files aren't being included in my page

If your Custom Facebook Feed appears to be unstyled or none of the interactive elements in the feed are working (comments box isn't opening, lightb...

Changing the font in your Facebook feed & using Google Fonts

The plugin is designed to naturally inherit the font that's used on your website or WordPress theme so that it fits seamlessly into your site. You ...

How do I display the Facebook feed in my WordPress page, post or widget?

Simply paste the following shortcode into your page, post or widget – wherever you want the feed to show up: [custom-facebook-feed]. If you are usi...

Can I display feeds from multiple Facebook pages?

Due to some recent Facebook API changes it is currently only possible to display posts from a Facebook "Page" that you are assigned a role for su...

How do I migrate my settings from the free version of the WordPress plugin to the Pro version?

As the free version and the Pro version are two separate versions of the plugin then you need to deactivate the free version prior to activating th...

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

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

Can I display the feed from a Facebook group?

It is possible to display group feeds in the plugin using version 3.9 or higher of the Pro version and version 2.10 or higher of the Free version. ...

Can I comment on the Facebook posts directly on my website?

Unfortunately Facebook doesn't actually allow you to comment on Facebook posts outside of Facebook and so we're not able to include that functional...

Display posts from multiple Facebook pages

The Custom Facebook Feed plugin is very flexible and allows you to display posts from as many different Facebook pages as you like on either the sa...

Display posts from multiple Facebook pages in one single feed

It's possible to use the core Custom Facebook Feed plugin to display posts from different Facebook pages in different feeds, but in order to merge ...

Where do I enter my Custom Facebook Feed license key?

WordPress plugin You enter your license under the 'License' tab, which is on the Settings page, as shown in the screenshot below: Ple...

Creating a Masonry grid layout from your Facebook posts

If using v3.8+ of the Pro plugin and v2.11 of the free plugin, then there is a built-in setting to create a multi-column masonry layout for your fe...

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

You can embed the feed directly into a template file by using the WordPress do_shortcode function: <?php echo do_shortcode('[custom-facebook-fe...

What if I have an issue or need to ask a question?

The best course of action is to first search through our FAQ and Troubleshooting questions here as we've put together a list of the most common iss...

Can I display a feed from a private Facebook page?

We’re afraid not. As the plugin allows you to display your Facebook feed publicly on your website for the whole world to see then posts from privat...

Displaying Facebook Events

Due to some recent Facebook API changes there it is currently only possible to display events that you are a host of and are from a Facebook "Pag...

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 posts from a personal profile, but rather only from a Facebook page o...

What’s an 'Access Token' and do I need one?

An Access Token is required by Facebook in order to access their public data API.  We've made it easy to get one by simply using the big blue Faceb...

Will the plugin continue to work after my license expires?

We recommend you maintain a license (for the reasons stated below) but it is your choice as to whether or not you decide to renew a license. ​ Wh...

The shortcode options aren't working

The most common causes of this are: 1) There's HTML tags within the shortcode which are preventing it from working correctly If you copied an...

Uploading the plugin: PCLZIP_ERR_BAD_FORMAT (-10) : Unable to find End of Central Dir Record signature

The PCLZIP_ERR_BAD_FORMAT (-10) : Unable to find End of Central Dir Record signature error is usually displayed by WordPress as a result of one of ...

Photos and 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 (often Firefox) is blocking the photos being ...

Display / Merge events from multiple Facebook pages into one single feed

You can merge posts or events from multiple Facebook pages into one single feed by using our handy Multifeed Extension. Simply install the extensio...

My Facebook Feed page is loading slowly

There are a few different factors which could affect how quickly your Facebook feed loads. In version 3.0 of the plugin we've made the plugin faste...

Facebook Group not showing photos in some posts or some posts are missing

The reason that some photos or posts may not be displayed in your Facebook group or page feeds for some users, is that some users may have the Priv...

Only a few of my posts are showing up, or I’m only getting "___ is now friends with ___" posts

This is usually because you're trying to display posts from a personal Facebook profile. The plugin can only be used to display posts from a Facebo...

How do I display the Facebook feed using the PHP Standalone version of the plugin?

Once you've defined your settings in the fbfeed-settings.php file then simply use the fbFeed($settings); function wherever you want the feed to be ...

Is the content of my feed crawlable by search engines and how does it help improve my SEO?

Unlike other Facebook plugins which use iframes to embed your feed into your page once it’s loaded, the Custom Facebook Feed uses server-side code ...

Receiving a Facebook error: Unauthorized source IP address:

That error message means that your web server's IP address has been blacklisted by Facebook, most likely because someone else using the same IP add...

Some "Visitor Posts" aren't showing up in my feed

If some posts by visitors to your page aren't showing up in the feed on your website then this is likely due to one of the following two reasons: ...

Change Dates to Relative "Time Ago" Time

if (!Date.now) { Date.now = function() { return new Date().getTime(); } } var sbiDateIcon = '<svg class="svg-inline--fa fa-clock fa-w-16...

Which version of the Custom Facebook Feed plugin is right for me? The WordPress plugin or the PHP Standalone version?

If your site is built on WordPress then we'd definitely recommend the WordPress plugin. Both versions can display your feed in the same way and don...

Are there any technical/server requirements for running the plugin?

Your web server should have either cURL or the PHP allow_url_fopen function enabled. If you don't know what these are then don't worry as they're e...

I need to activate my Personal license on a development site prior to launch. Can I do this and still activate on my live site after launch?

Answer: A Personal license can only be activated on 1 domain at any given time and cannot be activated on two different domains at the same time (u...

Does the WordPress plugin work with W3 Total Cache or other caching plugins?

The Custom Facebook Feed plugin should work in compatibility with most, if not all, caching plugins, but you may need to tweak the settings in orde...

How do I renew my license?

Renewing your license is super easy, there's two ways to do it: View your Account page and click on the renew link next to your license. En...

There's a large gap beneath the embedded videos in my feed

This is most likely because the WordPress theme you're using has responsive video functionality built into it which is conflicting with the respons...

I need an invoice/receipt for my purchase. Where can I get one?

When you purchase a product you'll be presented with a purchase confirmation screen which contains all of your purchase information along with a li...

My Facebook event times are displaying incorrectly or using the wrong timezone

This may be because your web site has a different timezone setting applied than the timezone set on your events on Facebook. You can change the tim...

The comments box and "Share" link don't expand when I click them

There are two main reasons why this issue could be occurring: 1) The plugin's JavaScript file isn't being included in your page. If your Word...

How does the plugin handle text and language translation?

Custom Facebook Feed is able to be fully translated into any language. There are different types of text that are included within the plugin - s...

The Load More button isn't working

There are a few reasons why this could be happening: 1) The plugin's JavaScript file isn't being included in your page. If your WordPress theme i...

Differences between the free version and Pro version of the Custom Facebook Feed plugin

The main differences between the free version and Pro version of the Custom Facebook Feed plugin are listed below. The extra features available in ...

Displaying Facebook Reviews

In order to display Facebook reviews you would need the Pro version of the plugin plus the Reviews extension. You can find out how to use the Revie...

Translate the months of the date using JavaScript

In the WordPress plugin the date will be displayed in whichever language your WordPress installation is in. Sometimes you may have multiple feeds o...

Date Formatting Reference

You can use the reference below to create your own custom date format. Below are a few examples and a reference for what each letter represents. ...

Can I display a dedicated feed of my Facebook Notes?

Unfortunately Facebook deprecated their Notes API on April 30th 2015, and so it's no longer possible to display a dedicated feed of your Facebook N...

Is it possible to display only my own posts in my group?

When displaying posts from a Facebook "Page" it's easy to do this as when the owner/admin of a Facebook page posts to the page they are posting as ...

Move shared links to display at the top of the Facebook post

$('.cff-item').each(function(){ $(this).prepend( $(this).find('.cff-shared-link') ); });

Dequeing the plugin files

To dequeue the files for each of the plugins, add the following to your plugin's functions.php file. Make sure they're placed within PHP tags: <...

Styling Facebook posts by different authors

If multiple people are posting to your Facebook page or if you're using our Multifeed extension to display posts from multiple different Facebook p...

Can I display photos from a Facebook Group "Photos" page?

Facebook deprecated version 2.0 of their API on August 8th, 2016, which means that it's unfortunately no longer be possible to display photos from ...

Display video grids in 16:9 format

$('.cff-album-item .cff-video').each(function(){ $(this).add( $(this).find('.cff-lightbox-link') ).css('height', $(this).innerWidth()/(16/9) ); });

Change the layout of shared link posts to match photo/video posts

By default the shared link posts have a different layout to photo and video posts, but you can change this to match by following the directions bel...

Fixing the Salient theme conflict

There is a known issue with the Salient WordPress theme where it causes links within plugins to be opened as a new page in the theme, which trigger...

Video sizing issue in the Salient theme

The salient theme wraps embedded videos (such as YouTube) in an element which causes an issue with sizing in our plugin. To fix this, simply add th...

The pop-up lightbox keeps directing/opening the raw image file

When using the Custom Facebook Feed Pro plugin, if there is an image with the lightbox not successfully opening the image then it could be due to o...

Change your Facebook profile image/avatar

$('#cff .cff-author-img img').attr('src', 'http://path-to-your-image.jpg');

Creating a dynamic Like Box

Add a Like Box for the author of the first post shown in the feed 1) First add a class to your feed by adding the following to the shortcode cla...