Docs    Facebook    Getting Started

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 Facebook Photos page, or from your Facebook page timeline.

Note: Displaying the Photos feed is not available for Groups. Groups can still display a timeline feed with photos.

Plugin Version 4.0 and above

From your Facebook Photos page

This method will pull the photos directly from your Photos page on Facebook and display them in a grid format similar to how they are displayed on Facebook, and as you can see in this demo, or in the Masonry layout. The photo description will be shown in the pop-up lightbox for the Gallery layout.

photos-page-screenshot

To display a video feed, when creating a new feed select the Photos Feed Type.

Select feed type photos

or editing an existing one under Facebook Feed > All Feeds > select Edit for the feed > Settings > Feed Type > click Change and select Photos.

From the timeline

When selecting the Feed Type, select Timeline. You can control which content to display in the Customize options for the feed later.

Select feed type video

For the created feed, go to Facebook Feed > All Feeds > select Edit for the feed > Settings > Filters >  Select Only specified posts and PhotosYou are also able to a combination of photos, albums, and videos.

Customize the Layout of the Photo Feed

To set the layout to be either Masonry or Grid, go to Facebook Feed > All Feeds > select Edit for the feed > Customize > Feed Layout > Select the layout you want to display. Here you can also further customize the number of posts or columns you want to display for different devices.

Please note, if you post multiple photos to Facebook then Facebook adds them to one of your albums (it could be ‘Mobile Uploads’ or ‘Timeline Photos’ depending on how they’re uploaded or which album you select to add them to when uploading). When doing this Facebook doesn’t add each individual photo to your timeline, it creates a single post that says that ‘__ added 10 photos to Timeline Photos’, or something similar. This is what the plugin then displays, as this is the information that’s passed to the plugin from Facebook. The plugin then classes these posts as “album” posts and so you’d need to also select the ‘Albums’ filter to display these.

Below Version 4.0

From your Facebook Photos page

This method will pull the photos directly from your Photos page on Facebook and display them in a grid format similar to how they are displayed on Facebook, and as you can see in this demo. The photo description will be shown in the pop-up lightbox.

photos-page-screenshot

You can display photos from your Photos page in two ways; using the plugin’s Settings pages or using the shortcode options.

Settings pages:

Click on the plugin’s ‘Customize’ page, and in the ‘Post Types’ section uncheck all other post types apart from ‘Photos’. You can then select to show photos from your ‘Photos Page’.

photos-page

Shortcode options:

Just set the post type to be ‘photos’ in your shortcode and then change the photo source to be your Facebook Photos Page, like so:

Comments Box SVG iconsUsed for the like, share, comment, and reaction icons
We're celebrating our rebranding and website relaunch with a huge Launch Party this week! Enter to win a pair of AirPods Pro for FREE and get huge discounts of up to 65% off our plugins! https://smashballoon.com/sale/

Each sale will also help support Save the Children, an amazing charity which helps children in need all around the world.
We have a new balloon to smash!

After 9 years it was time for a refresh! Our new logo is clean and simple, just like our plugins.
Like saving time? We’ve been listening to your feedback, and our new Feed Templates feature makes it much quicker and easier to get started creating your perfect feed! Just select a template with one click and let us do the work for you.

Update to v4.2 of the Custom Facebook Feed Pro plugin to use this new feature, and find out more details here: https://smashballoon.com/facebook-feed-templates-update/
Say hello to Instagram Feed 6!

Our biggest update to the plugin yet, with a brand new admin interface. We've redesigned the user experience from the ground up for simplicity, making it way easier to create, manage, and customize your feeds.

- See and edit all your feeds in one place (no more pesky shortcode options!)
- A brand new feed customizer with live feed preview.
- Redesigned settings pages to make it easier to find things.
- Easy color scheme settings to change all your colors in one place.
- Better Shoppable Feeds, import/export settings, and much more!

Check out our announcement post on our blog for more info:
https://smashballoon.com/new-update-instagram-feed-6/
We're turning Green Monday blue this year, and running a huge sale with deals of up to 65% off in support of the Ocean Conservancy who help to protect and clean the world's oceans.

This deal is for one day only, so claim yours and help support a great cause at the same time: https://smashballoon.com/sale/
Forget Black Friday, it's SMASH Friday!

We're thankful for all of our 1,600,000+ users who choose to use our plugins to power their social media feeds. To show our appreciation, we're offering up to 65% off all our plugins for Facebook, Instagram, Twitter, and YouTube.

Grab your deal now before it expires: https://smashballoon.com/black-friday/
Starting today, we're offering HUGE savings of up to 65% off Smash Balloon plugins — you don’t even have to wait till Friday! See all of our deals here, and enter to win a free MacBook too: https://smashballoon.com/black-friday/ 🎉

As the most user-friendly and highest-rated suite of social media feed plugins for Instagram, Facebook, Twitter and YouTube, Smash Balloon can help take your social media campaigns to the highest level.

Hurry! This limited-time deal won’t be around for long, so make sure you get it today!
What's better than a brand new MacBook Air?

WINNING a brand new MacBook Air, of course!

Smash Balloon is kicking off the holiday season with a FREE giveaway.

The prize? A brand new MacBook Air valued at $1,000!

Enter today to get a chance to win. No purchase required. And you can enter EVERY day until midnight on Dec 3rd.

Enter here today: https://smashballoon.com/black-friday/
Load more

 

From your Facebook timeline

This method will get a batch of posts from your Facebook timeline and then filter through them and only display the ones which are “photo posts”. They will be displayed in a “post” layout, as you can see in this demo, and will show the post text along with the likes and comments below each post.

timeline-photos-screenshot

You can display photos from your timeline in two ways; using the plugin’s Settings pages or using the shortcode options.

Settings pages:

Click on the plugin’s ‘Customize’ page, and in the ‘Post Types’ section uncheck all other post types apart from ‘Photos’. You can then select to show photos from your ‘Timeline’.

timeline-photos

Shortcode options:

Just set the post type to be ‘photos’ in your shortcode, like so:

Comments Box SVG iconsUsed for the like, share, comment, and reaction icons
We're celebrating our rebranding and website relaunch with a huge Launch Party this week! Enter to win a pair of AirPods Pro for FREE and get huge discounts of up to 65% off our plugins! https://smashballoon.com/sale/

Each sale will also help support Save the Children, an amazing charity which helps children in need all around the world.
We have a new balloon to smash!

After 9 years it was time for a refresh! Our new logo is clean and simple, just like our plugins.
Like saving time? We’ve been listening to your feedback, and our new Feed Templates feature makes it much quicker and easier to get started creating your perfect feed! Just select a template with one click and let us do the work for you.

Update to v4.2 of the Custom Facebook Feed Pro plugin to use this new feature, and find out more details here: https://smashballoon.com/facebook-feed-templates-update/
Say hello to Instagram Feed 6!

Our biggest update to the plugin yet, with a brand new admin interface. We've redesigned the user experience from the ground up for simplicity, making it way easier to create, manage, and customize your feeds.

- See and edit all your feeds in one place (no more pesky shortcode options!)
- A brand new feed customizer with live feed preview.
- Redesigned settings pages to make it easier to find things.
- Easy color scheme settings to change all your colors in one place.
- Better Shoppable Feeds, import/export settings, and much more!

Check out our announcement post on our blog for more info:
https://smashballoon.com/new-update-instagram-feed-6/
We're turning Green Monday blue this year, and running a huge sale with deals of up to 65% off in support of the Ocean Conservancy who help to protect and clean the world's oceans.

This deal is for one day only, so claim yours and help support a great cause at the same time: https://smashballoon.com/sale/
Forget Black Friday, it's SMASH Friday!

We're thankful for all of our 1,600,000+ users who choose to use our plugins to power their social media feeds. To show our appreciation, we're offering up to 65% off all our plugins for Facebook, Instagram, Twitter, and YouTube.

Grab your deal now before it expires: https://smashballoon.com/black-friday/
Starting today, we're offering HUGE savings of up to 65% off Smash Balloon plugins — you don’t even have to wait till Friday! See all of our deals here, and enter to win a free MacBook too: https://smashballoon.com/black-friday/ 🎉

As the most user-friendly and highest-rated suite of social media feed plugins for Instagram, Facebook, Twitter and YouTube, Smash Balloon can help take your social media campaigns to the highest level.

Hurry! This limited-time deal won’t be around for long, so make sure you get it today!
What's better than a brand new MacBook Air?

WINNING a brand new MacBook Air, of course!

Smash Balloon is kicking off the holiday season with a FREE giveaway.

The prize? A brand new MacBook Air valued at $1,000!

Enter today to get a chance to win. No purchase required. And you can enter EVERY day until midnight on Dec 3rd.

Enter here today: https://smashballoon.com/black-friday/
Load more

The default source of the photos will be from your timeline, but if you’ve changed this in the Post Types section of the settings page shown above then you can set it explicitly in the shortcode, like so:

Comments Box SVG iconsUsed for the like, share, comment, and reaction icons

3 months ago

Smash Balloon

We're celebrating our rebranding and website relaunch with a huge Launch Party this week! Enter to win a pair of AirPods Pro for FREE and get huge discounts of up to 65% off our plugins! smashballoon.com/sale/

Each sale will also help support Save the Children, an amazing charity which helps children in need all around the world.
... See MoreSee Less

Were celebrating our rebranding and website relaunch with a huge Launch Party this week! Enter to win a pair of AirPods Pro for FREE and get huge discounts of up to 65% off our plugins! https://smashballoon.com/sale/

Each sale will also help support Save the Children, an amazing charity which helps children in need all around the world.

Comment on Facebook

One of my emails, in a back and forth to this company, to ask questions about a product, before I actually buy it. The absurdity? By now, it would have been far easer just to ... errr. call me. Welcome to tech sales in the new generation: First tip? Banish the "I am sorry you feel that way" from your lexicon. You sound like Verizon customer service. Not the highly educated individual I presume I am dealing with. That is the perfect passive aggressive non answer that is all the rage in the '20s.. You aren't really apologizing, you just feel badly that in some form, i may feel hurt. I haven't purchased your product. As a self-employed journalist, for whom budget decisions always loom large, i avoid purchases from companies that are incapable of basic human interaction Let's see how this movie goes: I email you a few questions, you respond. That immediately triggers follow up questions, which I in turn ask of you. A Day or so later, we may have resolution. Or, 5 min of actually engaging in a back & forth, and you get a credit card. Sadly, tech companies are far more enamored of the method of information delivery, than results. I'm sure many deal with your company, based on the absence of any alternative. What would be a far more interesting analysis? How many consumers simply, when met with this "form of communication", simply walked away. BTW, my hosting provider, Blue Host, has actual trained sales people on the line.(Gasp! How positively 1990's of them!) As a result of exactly two brief (verbal) conversations, I have purchased a hosting package, as well as paid support.

I'm an existing customer with an All Access bundle. can I get 65% off renewal? it's due on the 29th March

4 months ago

Smash Balloon

We have a new balloon to smash!

After 9 years it was time for a refresh! Our new logo is clean and simple, just like our plugins.
... See MoreSee Less

We have a new balloon to smash!

After 9 years it was time for a refresh! Our new logo is clean and simple, just like our plugins.

4 months ago

Smash Balloon

Like saving time? We’ve been listening to your feedback, and our new Feed Templates feature makes it much quicker and easier to get started creating your perfect feed! Just select a template with one click and let us do the work for you.

Update to v4.2 of the Custom Facebook Feed Pro plugin to use this new feature, and find out more details here: smashballoon.com/facebook-feed-templates-update/
... See MoreSee Less

Like saving time? We’ve been listening to your feedback, and our new Feed Templates feature makes it much quicker and easier to get started creating your perfect feed! Just select a template with one click and let us do the work for you.

Update to v4.2 of the Custom Facebook Feed Pro plugin to use this new feature, and find out more details here: https://smashballoon.com/facebook-feed-templates-update/

5 months ago

Smash Balloon

Say hello to Instagram Feed 6!

Our biggest update to the plugin yet, with a brand new admin interface. We've redesigned the user experience from the ground up for simplicity, making it way easier to create, manage, and customize your feeds.

- See and edit all your feeds in one place (no more pesky shortcode options!)
- A brand new feed customizer with live feed preview.
- Redesigned settings pages to make it easier to find things.
- Easy color scheme settings to change all your colors in one place.
- Better Shoppable Feeds, import/export settings, and much more!

Check out our announcement post on our blog for more info:
smashballoon.com/new-update-instagram-feed-6/
... See MoreSee Less

Say hello to Instagram Feed 6!

Our biggest update to the plugin yet, with a brand new admin interface. Weve redesigned the user experience from the ground up for simplicity, making it way easier to create, manage, and customize your feeds.

- See and edit all your feeds in one place (no more pesky shortcode options!)
- A brand new feed customizer with live feed preview.
- Redesigned settings pages to make it easier to find things.
- Easy color scheme settings to change all your colors in one place.
- Better Shoppable Feeds, import/export settings, and much more!

Check out our announcement post on our blog for more info:
https://smashballoon.com/new-update-instagram-feed-6/

Comment on Facebook

Broke my feed. Shows my photo, bio and follow button but no actual images. Just a blank area. It was working fine for months before this!

its not showing any pictures with the new update using the divi theme builder did all that it says to do on your knowledge base.

Hey guys! I am a social media professional, and I would like to mention about Rannkly, a powerful social media tool that I recently stumbled upon. And well let me tell you that it is a lot better than Buffer.@https://www.facebook.com/reputationmanagement/

6 months ago

Smash Balloon

We're turning Green Monday blue this year, and running a huge sale with deals of up to 65% off in support of the Ocean Conservancy who help to protect and clean the world's oceans.

This deal is for one day only, so claim yours and help support a great cause at the same time: smashballoon.com/sale/
... See MoreSee Less

Were turning Green Monday blue this year, and running a huge sale with deals of up to 65% off in support of the Ocean Conservancy who help to protect and clean the worlds oceans.

This deal is for one day only, so claim yours and help support a great cause at the same time: https://smashballoon.com/sale/

7 months ago

Smash Balloon

Forget Black Friday, it's SMASH Friday!

We're thankful for all of our 1,600,000+ users who choose to use our plugins to power their social media feeds. To show our appreciation, we're offering up to 65% off all our plugins for Facebook, Instagram, Twitter, and YouTube.

Grab your deal now before it expires: smashballoon.com/black-friday/
... See MoreSee Less

Forget Black Friday, its SMASH Friday!

Were thankful for all of our 1,600,000+ users who choose to use our plugins to power their social media feeds. To show our appreciation, were offering up to 65% off all our plugins for Facebook, Instagram, Twitter, and YouTube.

Grab your deal now before it expires: https://smashballoon.com/black-friday/

Comment on Facebook

Hello! I've bought your facebook plugin, but it doesn't work correctly. I stream posts from my facebook page to my site, and if post contains several photos, only the first one shows at lightbox. If I click the next button, I see the photo from next post. But I presume that the next picture from this post have to be shown. How to fix it?

I've just bought your facebook pugin to show a facebook group i run, but it is not working. The group is private and i have all the relevent tokens

7 months ago

Smash Balloon

Starting today, we're offering HUGE savings of up to 65% off Smash Balloon plugins — you don’t even have to wait till Friday! See all of our deals here, and enter to win a free MacBook too: smashballoon.com/black-friday/ 🎉

As the most user-friendly and highest-rated suite of social media feed plugins for Instagram, Facebook, Twitter and YouTube, Smash Balloon can help take your social media campaigns to the highest level.

Hurry! This limited-time deal won’t be around for long, so make sure you get it today!
... See MoreSee Less

Starting today, were offering HUGE savings of up to 65% off Smash Balloon plugins — you don’t even have to wait till Friday! See all of our deals here, and enter to win a free MacBook too: https://smashballoon.com/black-friday/ 🎉

As the most user-friendly and highest-rated suite of social media feed plugins for Instagram, Facebook, Twitter and YouTube, Smash Balloon can help take your social media campaigns to the highest level.

Hurry! This limited-time deal won’t be around for long, so make sure you get it today!

Comment on Facebook

Disappointing how little you value renewing customers by taking away the renewal discount. Willing to offer huge discounts to get new customers but nothing for those that have been faithful users for years. Decent product but speaks volumes to how little you seem to care about long time customers.

7 months ago

Smash Balloon

What's better than a brand new MacBook Air?

WINNING a brand new MacBook Air, of course!

Smash Balloon is kicking off the holiday season with a FREE giveaway.

The prize? A brand new MacBook Air valued at $1,000!

Enter today to get a chance to win. No purchase required. And you can enter EVERY day until midnight on Dec 3rd.

Enter here today: smashballoon.com/black-friday/
... See MoreSee Less

Whats better than a brand new MacBook Air?

WINNING a brand new MacBook Air, of course!

Smash Balloon is kicking off the holiday season with a FREE giveaway.

The prize? A brand new MacBook Air valued at $1,000!

Enter today to get a chance to win. No purchase required. And you can enter EVERY day until midnight on Dec 3rd.

Enter here today: https://smashballoon.com/black-friday/

Comment on Facebook

Great prize!! 🥳 Would love to win for my kids to get to grips with design and coding too.

I WON 😍😎🤩 Thank you Smash Balloon.

I'd love a new Mac to continue my purpose at Cecil's Men's Hub :-)

Awesome Giveaway!

Fingers crossed 🤞🏻

View more comments

Load more

Please note, if you post multiple photos to Facebook then Facebook adds them to one of your albums (it could be ‘Mobile Uploads’ or ‘Timeline Photos’ depending on how they’re uploaded or which album you select to add them to when uploading). When doing this Facebook doesn’t add each individual photo to your timeline, it creates a single post which says that ‘__ added 10 photos to Timeline Photos’, or something similar. This is what the plugin then displays, as this is the information that’s passed to the plugin from Facebook. The plugin then classes these posts as “album” posts and so you’d need to also select the ‘Albums’ post type to display too, eg: type=”photos, albums”.

support

Couldn’t find your answer in the docs?

Contact Support