Plugin how-tos · 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:
| Connection | How you log in | What it supports |
|---|---|---|
| Business Basic | Instagram login | Your own posts and basic feed features |
| Business Advanced | Facebook login, with a linked Facebook Page | Extra 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.
- Log in to your WordPress dashboard as an administrator.
- Open Plugins > Add New Plugin.
- Search for Smash Balloon Instagram Feed.
- Check the author is Smash Balloon.
- 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.
- Go to Instagram Feed > All Feeds.
- Click Add New.
- Choose User Timeline for your own posts.
- Click Add Source.
- Choose Business Basic or Business Advanced.
- Log in to Instagram or Facebook and approve access.
- 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.
| Setting | What it controls | Tip |
|---|---|---|
| Template | Starting design | Pick the closest match, then adjust |
| Layout | Grid, carousel, masonry or highlight | Some layouts need Pro |
| Posts and columns | How many images and per row | Use fewer columns on mobile |
| Header | Profile picture, name and bio | Hide it if the page already has a heading |
| Load More button | Lets visitors see older posts | Keeps initial load lighter |
| Follow button | Links to your Instagram profile | Good 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.
| Problem | Likely cause | Fix |
|---|---|---|
| Feed shows an error | Token expired or access removed | Reconnect the source under Add Source |
| Account will not connect | Personal account | Switch to a Business or Creator account |
| New posts missing | Feed or page cache | Clear both caches |
| Wrong feed appears | Shortcode has another feed ID | Copy the shortcode from All Feeds again |
| Hashtag feed empty | Business Basic connection | Use 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
- Smash Balloon Social Photo Feed WordPress.org
- How to convert your Instagram personal profile into a professional account Smash Balloon
- How to reconnect a personal Instagram account: Basic Display API deprecation Smash Balloon
- Shortcode block WordPress.org Documentation
- 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.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


