Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared hosting Managed WordPress Cloud hosting VPS hosting By reader location Hosting finder
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Blog Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

Plugin how-tos · Guide

How to Use Smash Balloon Instagram Feed: A Beginner's Guide

How to Use Smash Balloon Instagram Feed: A Beginner's Guide

Short answer

Install the Smash Balloon Instagram Feed plugin, then open Instagram Feed and choose All Feeds. Click Add New, connect a Business or Creator Instagram account, customise the layout in the visual editor and save. Add the feed to a page with the Instagram Feed block or its shortcode.

Key takeaways

  • You need an Instagram Business or Creator account, not a personal one.
  • Feeds are built and previewed in a visual customiser.
  • Add feeds with the block, the shortcode or a widget.
  • Caching keeps feeds fast; clear it when new posts do not show.
  • Pro adds videos, a lightbox, hashtag feeds and more layouts.

How do you use Smash Balloon Instagram Feed?

Install the Smash Balloon Instagram Feed plugin, open Instagram Feed > All Feeds, connect a professional Instagram account, customise the feed in the visual editor, then add it to a page with the Instagram Feed block or shortcode.

Smash Balloon Instagram Feed shows your latest Instagram posts on your WordPress site. New posts appear automatically, so the feed stays fresh without extra work.

The free version is listed as Smash Balloon Social Photo Feed in the plugin directory. A Pro version adds more layouts and feed types.

This guide covers account requirements, setup, customisation, placement and fixes for common problems. For an overview of the company's other plugins, see our explainer on what Smash Balloon is.

What kind of Instagram account do you need?

You need an Instagram professional account, meaning a Business or Creator account, because Meta shut down the Basic Display API that personal accounts used in December 2024.

Before that change, any personal Instagram account could be connected. Now feed plugins use APIs that only serve professional accounts.

Switching is free and takes a minute in the Instagram app. Your posts and followers stay the same. Smash Balloon explains the switch in its guide to converting a personal profile into a professional account.

Smash Balloon offers two connection types:

ConnectionHow you log inWhat it supports
Business BasicInstagram loginYour own posts and basic feed features
Business AdvancedFacebook login, with a linked Facebook PageExtra data such as hashtag feeds and more details

Most simple feeds work with Business Basic. If you plan to use hashtag feeds or other advanced features in Pro, link a Facebook Page and choose Business Advanced.

Step 1: How do you install the plugin?

Go to Plugins > Add New Plugin, search for Smash Balloon Instagram, install the plugin by Smash Balloon, and activate it.

  1. Log in to your WordPress dashboard as an administrator.
  2. Open Plugins > Add New Plugin.
  3. Search for Smash Balloon Instagram Feed.
  4. Check the author is Smash Balloon.
  5. Click Install Now, then Activate.

A new Instagram Feed menu appears in the sidebar. It may open a short welcome screen the first time.

If you bought Pro, install the free plugin or upload the Pro zip from your Smash Balloon account, then enter your license key in the plugin's settings.

Step 2: How do you connect your Instagram account?

Open Instagram Feed > All Feeds, click Add New, choose a feed type, click Add Source, pick your connection type, log in and approve the permissions.

  1. Go to Instagram Feed > All Feeds.
  2. Click Add New.
  3. Choose User Timeline for your own posts.
  4. Click Add Source.
  5. Choose Business Basic or Business Advanced.
  6. Log in to Instagram or Facebook and approve access.
  7. Select the account and click Next.

The login happens on Meta's own pages. Smash Balloon receives an access token, not your password.

If you manage the account for a client, the client may need to log in or grant you access in Meta's settings. Plan this ahead, since it can slow down launch day.

Step 3: How do you customise the feed?

Pick a template, then use the visual customiser to set the layout, number of posts, columns, header, spacing and buttons, and click Save when the preview looks right.

The customiser shows a live preview on the right and settings on the left. Changes appear instantly.

SettingWhat it controlsTip
TemplateStarting designPick the closest match, then adjust
LayoutGrid, carousel, masonry or highlightSome layouts need Pro
Posts and columnsHow many images and per rowUse fewer columns on mobile
HeaderProfile picture, name and bioHide it if the page already has a heading
Load More buttonLets visitors see older postsKeeps initial load lighter
Follow buttonLinks to your Instagram profileGood for growing followers

The preview has desktop, tablet and mobile views. Check all three, since a six-column grid can look cramped on a phone.

The free version covers the basics. Pro adds options such as video playback, a pop-up lightbox, hashtag feeds and shoppable feeds. Check the Smash Balloon website for the current Pro features.

Step 4: How do you add the feed to a page?

Use the Instagram Feed block in the block editor, paste the feed's shortcode into any page or widget, or add the feed widget to a sidebar or footer.

Block editor. Edit the page, click the plus icon, search for Instagram Feed and insert the block. Choose your feed from the dropdown.

Shortcode. Copy the shortcode shown on the All Feeds screen, such as [instagram-feed feed=1], and paste it into a Shortcode block or a page builder's shortcode widget.

Widget. Go to Appearance > Widgets and add the Instagram Feed widget to a footer or sidebar area.

Elementor and other page builders can use the shortcode, and some also offer a dedicated Smash Balloon widget. Our guide on editing shortcodes in Elementor explains where to paste it.

How do caching and updates work?

The plugin stores your feed data in a cache and checks Instagram for new posts on a set schedule, which keeps pages fast and avoids hitting Meta's rate limits.

You can change how often the feed checks for new posts in the plugin settings. More frequent checks show new posts sooner but make more requests.

Your page caching plugin can also store the page with the feed. If new posts do not appear, clear the plugin's feed cache and your page cache.

Smash Balloon can also save resized copies of images locally. That helps speed and keeps images showing even if Instagram's links change.

How do you keep the feed fast?

Show a sensible number of posts, enable the Load More button, let the plugin store local images, and test the page in PageSpeed Insights before and after adding the feed.

Instagram feeds add images, scripts and styles. On a home page, that weight can affect your speed scores.

  • Limit posts. Six to nine images is plenty for most designs.
  • Use Load More. Visitors who want more can ask for it.
  • Avoid large carousels high on the page if speed matters.
  • Test. Run the page through PageSpeed Insights after adding the feed.

For general image tips, see our guide on optimizing images for WordPress.

What about privacy and cookies?

Instagram images and scripts can involve third-party requests, so many sites mention the feed in their privacy policy and check whether a consent banner is needed.

This section is general information, not legal advice. The rules depend on where your visitors are and what data is collected.

The plugin includes a privacy-focused setting that can change how the feed loads until visitors consent. It also works with several popular cookie consent plugins.

If you serve EU visitors, the European Commission's data protection pages are a good place to learn the basics.

Why is your Instagram feed not working?

Most problems come from an expired or disconnected account, a personal account that no longer works with the API, caching, or a feed placed with the wrong shortcode ID.

ProblemLikely causeFix
Feed shows an errorToken expired or access removedReconnect the source under Add Source
Account will not connectPersonal accountSwitch to a Business or Creator account
New posts missingFeed or page cacheClear both caches
Wrong feed appearsShortcode has another feed IDCopy the shortcode from All Feeds again
Hashtag feed emptyBusiness Basic connectionUse Business Advanced with a linked Facebook Page

If you see a note about reconnecting after the API change, Smash Balloon's Basic Display API guide walks through it.

Account changes at Meta, such as password resets or removed permissions, can also break the token. Reconnecting usually fixes it.

Should you use the free version or Pro?

The free version suits a simple grid of your own posts, while Pro makes sense if you want videos, a lightbox, carousels, hashtag feeds or shoppable posts.

Start free and see whether it meets your needs. Upgrading later keeps your feeds and settings.

If you also want feeds from Facebook or YouTube, Smash Balloon sells bundles. Only install the platforms you actually use, since each plugin adds weight.

If you sell products, also consider linking your store to Instagram directly. Our guide on connecting WooCommerce to Facebook and Instagram covers that.

Frequently asked questions

Can I use a personal Instagram account with Smash Balloon?

Not anymore. Meta shut down the Basic Display API in December 2024, which personal accounts relied on. You need to switch to a free Business or Creator account in the Instagram app, then connect it again in the plugin.

Is Smash Balloon Instagram Feed free?

Yes, there is a free version in the WordPress plugin directory that shows a grid of your own Instagram posts. Pro adds features such as video playback, lightbox, carousels and hashtag feeds. Check the vendor's pricing page for current plans.

How often does the feed update?

The plugin checks Instagram for new posts on a schedule you can change in the settings. Your page cache may also hold the old version, so if a new post does not appear, clear both the feed cache and your page cache.

Can I show more than one Instagram account?

Yes. Connect each account as a source, then either create separate feeds or combine accounts in one feed. Combining sources in a single feed may depend on your plan, so check the feed settings.

Does the Instagram feed slow down my site?

It adds images and scripts, so it can affect speed on the pages where it appears. Show fewer posts, use the Load More button, keep local image storage on and test the page with a speed tool after adding the feed.

Sources

  1. Smash Balloon Social Photo Feed WordPress.org
  2. How to convert your Instagram personal profile into a professional account Smash Balloon
  3. How to reconnect a personal Instagram account: Basic Display API deprecation Smash Balloon
  4. Shortcode block WordPress.org Documentation
  5. PageSpeed Insights Google

Is your product missing, or something out of date?

Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.

About the editors

Written and checked byWPLegible Editorial Team Independent WordPress reviews and guides

Researched from the primary sources listed above and checked against our editorial rules before publishing.