Docs    Facebook    Documentation

How to use the Carousel extension to display your Facebook feed as a carousel

How to install and activate the Carousel extension to display a Facebook feed as a sliding carousel.

Would you like to display your Facebook posts in a sliding carousel on your WordPress site?

This guide shows you how to use the Carousel extension to turn a feed into a carousel. We’ll also cover each carousel setting and the shortcode options you can use to override them.

Requirements: The Carousel layout comes from the Carousel extension. The extension is a separate plugin that must be installed and activated next to Facebook Feed Pro.

Before you get started, make sure Facebook Feed Pro is installed and activated on your WordPress site. You install the extension the same way as any other WordPress plugin.

Here is what we will cover.

To get started, we’ll turn on the extension in your plugin.

  1. First, install and activate the extension plugin on your site.
  2. Next, from your WordPress admin sidebar, go to Facebook Feed » Extensions.
  3. Then find the Carousel card. If it says Activate, click Activate. If it says Deactivate, the extension is already active and you can move on.
The Carousel card on the Facebook Feed Extensions page, with an arrow pointing at its Activate button

If the card shows an Add link instead of Installed, the extension plugin isn’t on your site yet. The link opens the extension page in a new tab. Once the extension plugin is on your site, return to this page and check the Carousel card again.

With the extension active, you can switch any feed to the Carousel layout in the feed builder.

  1. From your WordPress admin sidebar, go to Facebook Feed » All Feeds.
  2. Then open the feed you want to change.
  3. After that, click the Customize tab. Then click Feed Layout.
  4. Next to Layout, choose Carousel. The preview now shows your posts as a carousel.
  5. Finally, click Save in the top right.
The Feed Layout section with the Carousel layout selected and an arrow pointing at Carousel

If the extension isn’t active, choosing Carousel opens an upgrade message headed “Upgrade your License to get Carousel layout” instead. Turn the extension on as shown in the section above and try again. The Showcase Carousel and Simple Carousel feed templates open the same message until the extension is active. For the other templates, see our guide on using Facebook feed templates and themes.

Once the Carousel layout is selected, the Feed Layout section shows the carousel settings described below. A carousel feed doesn’t show the Load More button.

The following settings appear in the Feed Layout section, under Customize, while Layout is set to Carousel. After you change any of them, click Save in the top right.

The carousel settings in the Feed Layout section: Height of Carousel, Desktop Columns, Mobile Columns, Navigation Arrows Style, Show Pagination, Enable Autoplay and Interval Time
  • Height of Carousel. The options are “Always set to tallest post”, “Set to shortest post, button to expand” or “Automatically adjust height (forces 1 column)”. The default is “Always set to tallest post”. With the expand option, the carousel shows a button to expand it.
  • Desktop Columns. The number of posts shown side by side on a desktop screen. The default is one.
  • Mobile Columns. The number of posts shown side by side on a mobile screen. The default is one.
  • Navigation Arrows Style. The options are “Hide arrows”, “Display on sides of feed on hover” or “Below feed, on sides of pagination”. The default is “Hide arrows”.
  • Show Pagination. Turn this on to show dots that mark the position of the current slide, or turn it off to hide them. It is on by default.
  • Enable Autoplay. Turn this on to move through the posts automatically. It is off by default.
  • Interval Time. The time between slides, in milliseconds. The default is 5000. It only applies while Enable Autoplay is on. Autoplay never moves faster than one slide per second. A value under 1000 works the same as 1000.

If you are not sure which options to pick, keep the defaults. For a compact carousel, “Set to shortest post, button to expand” works well if you are happy for visitors to click a button to see the rest of a longer post. The “Automatically adjust height (forces 1 column)” option only suits designs that show one post at a time. For the arrows, “Display on sides of feed on hover” shows them only while a visitor’s pointer is over the feed. “Below feed, on sides of pagination” keeps them in view below the feed, one on each side of the pagination dots.

The Number of Posts setting in the same section controls how many posts the feed shows. Grid and masonry columns don’t apply to a carousel, so use Desktop Columns and Mobile Columns instead. To learn about columns on those layouts, read our guide on displaying Facebook posts in multiple columns.

You can also set carousel options directly in the feed’s shortcode. A shortcode option overrides the matching setting saved in the builder for that one place on your site. Here is an example shortcode.

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

Replace the number after feed with the ID of your feed. The options only work while the Carousel extension is active. If the plugin can’t use a height, arrow, column or interval value, it ignores it and uses the saved setting instead. For carousel, carouselpag and carouselautoplay, use true or false. A value the plugin doesn’t accept, such as yes, turns that option off.

NameAttributeOptionsDescriptionExample
Carousel Feedcarouseltrue, falseWhether to show this feed as a carousel.carousel="true"
Number of columnscarouselcolsA whole numberThe number of posts shown side by side on a desktop screen.carouselcols="3"
Number of columns for mobilecarouselmobilecolsA whole numberThe number of posts shown side by side on a mobile screen.carouselmobilecols="2"
Height of Carouselcarouselheighttallest, clickexpand, autoexpandHow the height of the carousel is set. These match the three options of Height of Carousel in the builder.carouselheight="clickexpand"
Arrow Navigationcarouselarrowsnone, onhover, belowHow the arrows are displayed.carouselarrows="onhover"
Paginationcarouselpagtrue, falseWhether to show the dots that mark the current slide.carouselpag="true"
Autoplaycarouselautoplaytrue, falseWhether the carousel moves through the posts automatically.carouselautoplay="true"
Autoplay Time IntervalcarouseltimeA whole numberThe number of milliseconds before the next post is shown. Autoplay never moves faster than one slide per second.carouseltime="5000"

To see every shortcode option for the plugin, read our shortcode reference.

That’s it! You now know how to display your Facebook feed as a carousel. To learn how to place the feed on your site, read our guide on displaying your Facebook feed on a page, post, or widget.

Frequently Asked Questions

Below, we’ve answered some of the most common questions about the Carousel extension.

Why does choosing Carousel open an upgrade message?

The Carousel layout needs the Carousel extension to be active. To check, go to Facebook Feed » Extensions and check the Carousel card. If it shows Activate, click it. If it shows Add, install and activate the extension plugin first.

Why doesn’t my carousel shortcode option change anything?

The carousel options in a shortcode only work while the Carousel extension is active. The plugin also ignores a height, arrow, column or interval value it can’t use and keeps the saved setting. For carousel, carouselpag and carouselautoplay, use true or false, because a value the plugin doesn’t accept turns that option off.

How do I show more than one post at a time?

To change this, open the feed and go to Customize » Feed Layout. With Layout set to Carousel, change Desktop Columns and Mobile Columns. Both are set to one by default.

Why does my carousel show only one column?

Desktop Columns and Mobile Columns both start at one. To show more posts side by side, raise them under Customize » Feed Layout. If the carousel still shows one column, check Height of Carousel. Its “Automatically adjust height” option is labeled as forcing one column. To use more columns, choose one of the other two height options.

How do I make the carousel move on its own?

Under Customize » Feed Layout, turn on Enable Autoplay and set Interval Time to the number of milliseconds between slides. Autoplay is off by default, and the carousel never moves faster than one slide per second.

Where is the Load More button in my carousel?

A carousel feed doesn’t show the Load More button. To set how many posts the carousel shows, use Number of Posts under Customize » Feed Layout.

support

Couldn’t find your answer in the docs?

Contact Support