The Carousel extension allows you to create a customizable, carousel style slide show of your Facebook Posts.

Below are two examples of using the Carousel extension. Click here to see a live demo.

screenshot of Smash Balloon Carousel Extension for Custom Facebook Feed

Shortcode used above:
[custom-facebook-feed carousel="true"]

screenshot of Smash Balloon Carousel Extension for Custom Facebook Feed

Shortcode used above:
[custom-facebook-feed carousel="true" carouselcols=3 type="photos" photosource="photospage"]

Carousel Settings are located on the “Post Layout” tab on the plugin’s “Customize” page:

Screenshot of the Settings for the Carousel extension for the Custom Facebook Feed plugin

See the How to use tab above for directions on how to use the extension.

How to use


Extensions are installed just like any other WordPress plugin. You can follow the same process used when uploading and installing the Custom Facebook Feed Pro plugin.


Once activated, the extension will add a variety of settings to the “Post Layout” tab, which is on the plugin’s “Customize” page. These settings are shown below:



You can also set these settings directly in the shortcode. These are only required if you want to override the settings set on the plugin’s Settings page shown above. Here’s an example shortcode:

[custom-facebook-feed carousel="true" carouselcols=3]

Shortcode Options

Name Attribute Options Description Example
Carousel Feed carousel true
Whether or not to apply the carousel to this feed carousel=true
Number of columns carouselcols 1-6 The number of columns inside the carousel slide show carouselcols=3
Number of columns for mobile carouselmobilecols 1-6 The number of columns on mobile displays carouselmobilecols=2
Height of Carousel carouselheight tallest
How the height of the feed is set. Note: the “autoexpand” option only works when displaying 1 column in the carousel carouselheight="clickexpand"
Arrow Navigation carouselarrows none
How arrows are displayed for navigating through the carousel carouselarrows="onhover"
Pagination carouselpag true
Icons to indicate the relative position of the current slide carouselpag=true
Autoplay carouselautoplay true
Cycle through posts automatically when the feed loads carouselautoplay=true
Autoplay Time Interval carouseltime any number Number of milliseconds before a new post is shown carouseltime=5000

Change Log

= 1.2 =
* Tweak: Added spacing if the posts have the box-shadow setting applied or are displayed in multiple columns
* Fix: Fixed an issue with the navigation arrows not working when positioned below the carousel
* Fix: Fixed an issue where the navigation wouldn’t be displayed below the feed if the pagination was hidden

= 1.1.2 =
* Fix: When displaying events in the carousel the “Number of Posts” setting wasn’t working correctly
* Fix: Fixed an issue where empty carousel items may be displayed in photo carousels when using the ‘filter’ setting

= 1.1.1 =
* Tweak: Updated the plugin updater script to reduce requests on the WordPress Plugins page

= 1.1 =
* Compatible with version 3.0 of the Custom Facebook Feed Pro plugin

= 1.0 =
* Launched the Carousel Feed extension