Troubleshooting
Smash Balloon Instagram Feed Not Working: Causes and How to Fix It

Short answer
A Smash Balloon Instagram feed usually stops working because the account connection expired, the account is a personal type Instagram no longer supports, or a cache or JavaScript optimisation is getting in the way. Read the admin-only error notice, reconnect a Business or Creator account, clear all caches, then check scripts and plugin conflicts.
Key takeaways
- Smash Balloon shows error details only to logged-in admins on the page.
- Expired or invalid connections are fixed by reconnecting the account in the plugin settings.
- Personal Instagram accounts lost API access in December 2024; switch to Business or Creator.
- Clear the feed cache, page cache and CDN after any fix.
- JavaScript delay, minify and Rocket Loader settings often break the feed.
Why is your Smash Balloon Instagram feed not working?
Most broken Smash Balloon Instagram feeds come down to an expired or invalid account connection, an account type Instagram no longer supports, a cache showing old posts, or a JavaScript optimisation setting that stops the feed from loading.
Less often, the cause is a plugin conflict, missing WP-Cron runs, a privacy or consent setting, or an API limit on Instagram's side.
The plugin usually tells you which one. Start by reading the error message, then work through the matching section below.
Where do you find the error message?
Log in as an admin and view the page with the feed, because Smash Balloon shows error notices on the front end only to logged-in admins, and also lists problems in the plugin's settings area.
Visitors just see an empty space or old posts. You see a box explaining what went wrong.
Also open Instagram Feed in your dashboard and look for notices at the top of the screens and next to your connected sources.
Smash Balloon keeps a reference of Instagram API error messages that explains what each code means and how to fix it. Note the exact wording before you change anything.
Has your Instagram connection expired?
Often, yes. Instagram access tokens can expire or become invalid after a password change, a security check, or a change to the account or its linked Facebook Page.
When that happens, the feed stops pulling new posts or shows an invalid source style error.
To fix it:
- Go to Instagram Feed > Settings and open the sources section.
- Find the account showing a warning.
- Click to reconnect and log in to Instagram again.
- Approve the permissions requested, especially access to the account's media.
Smash Balloon's guide to fixing an invalid source and reconnecting your account walks through the same steps with screenshots.
After reconnecting, clear the feed cache so the new data loads straight away.
Is your Instagram account type still supported?
Check it, because Meta retired the Instagram Basic Display API in December 2024, which ended access for personal accounts through that route and broke many older feeds.
Feeds now need a professional account, meaning an Instagram Business or Creator account. Switching is free and done inside the Instagram app under your account settings.
Once the account is professional, reconnect it in Smash Balloon. Some connection methods also need the account linked to a Facebook Page, so follow the prompts the plugin shows.
Meta's Instagram Platform documentation describes the current APIs and which account types they support.
| Account type | Works with current Instagram APIs | What to do |
|---|---|---|
| Personal | No | Switch to Creator or Business in the Instagram app |
| Creator | Yes | Reconnect in Smash Balloon if needed |
| Business | Yes | Reconnect in Smash Balloon if needed |
Is the feed showing old posts because of caching?
Probably, if the feed loads but new posts are missing. Smash Balloon caches feed data for a set period, and page caches and CDNs can add a second layer on top.
First clear the plugin's own cache. In the Instagram Feed settings, look for the option to clear the feed cache, then reload the page.
Next, purge your page cache and CDN. Our guide on how to clear cache in WordPress covers the main caching plugins and hosts.
You can also shorten how often the feed checks for new posts in the plugin settings. A shorter interval means more API calls, so do not set it lower than you need.
Is WP-Cron failing to refresh the feed?
It can be. Smash Balloon relies on scheduled background tasks to refresh feed data and tokens, and on sites where WP-Cron does not run, the feed can fall behind or stop updating.
This happens on low-traffic sites, sites with DISABLE_WP_CRON set but no real server cron, and some cached setups where visits never reach PHP.
Check scheduled events with a tool such as WP Crontrol. If events are overdue, see our guide on fixing WP-Cron not running.
Is a speed plugin or CDN breaking the feed's JavaScript?
Very often, yes. Settings that delay, defer, combine or minify JavaScript can stop the feed script from running, leaving a blank area, a spinner or unstyled images.
Try these steps one at a time:
- Turn off JavaScript delay or defer in your speed plugin and test.
- Exclude the Instagram Feed script files from minify and combine.
- Disable Cloudflare Rocket Loader, which changes how scripts load.
- Clear all caches after each change.
Smash Balloon has a specific article for feeds not working with Cloudflare. Cloudflare's own Rocket Loader documentation explains how to turn the feature off.
Check your browser console too. Right-click the page, choose Inspect, open the Console tab and look for red errors that mention the feed or jQuery.
Are images missing while the posts are listed?
Missing images usually mean the local image copies failed to save, a privacy or consent setting is blocking images from Instagram, or a security rule is blocking image requests.
Smash Balloon can store resized copies of images on your server. If the uploads folder is not writable, those copies fail and images break.
Check these points:
- Your wp-content/uploads folder is writable by the web server.
- The plugin's image resizing option is on, or try toggling it off and on.
- A cookie consent plugin is not blocking Instagram content until visitors accept.
- The plugin's GDPR-related setting matches how your consent tool works.
If images are broken across the whole site, not just the feed, our guide on fixing images not showing in WordPress covers permissions and URL issues.
Could another plugin or your theme be causing it?
Yes. Other social feed plugins, script managers, and themes that load an old jQuery version or block AJAX can all stop the feed from loading.
The quickest test is on a staging copy:
- Switch to a default theme such as Twenty Twenty-Five.
- Deactivate every plugin except Smash Balloon.
- Check whether the feed loads.
- Reactivate plugins one by one until it breaks again.
Our guide on finding a plugin conflict explains this process safely.
Have you hit an Instagram rate limit?
Sometimes. Instagram limits how many API requests an account or app can make in a period, and very short refresh intervals, many feeds, or several sites sharing one account can trigger temporary errors.
Rate limit errors usually clear on their own after a while. In the meantime, the plugin should show cached posts.
To reduce the risk, use a longer refresh interval, combine feeds where possible, and avoid connecting the same Instagram account to many busy sites.
Is the shortcode or block set up correctly?
Make sure the page uses the current feed shortcode or block with the right feed ID, because older shortcodes or deleted feeds can display nothing.
In recent versions, feeds are created under Instagram Feed > All Feeds, and each feed has its own ID. The shortcode looks similar to this:
[instagram-feed feed=1]
Copy the exact shortcode from the feed list, or use the Instagram Feed block in the editor. Our guide on how to use Smash Balloon Instagram Feed shows the full setup from scratch.
What should you do if nothing works?
Update the plugin and WordPress, reconnect the account, clear every cache, check the debug log for PHP errors, and then contact Smash Balloon support with the error text and your system information.
The plugin includes system information you can copy from its support or about screens. Support teams can solve most feed problems faster with that report.
Free users can search the Instagram Feed support forum on WordPress.org, where many of these issues are answered.
Our guide on enabling debug mode shows how to log PHP errors without displaying them to visitors.
Frequently asked questions
Why is my Smash Balloon Instagram feed empty?
An empty feed usually means the account connection is invalid, the account type is not supported, or the feed script did not run. Log in as an admin and view the page to see the error message, then reconnect the account or disable script optimisation to test.
Can I use Smash Balloon with a personal Instagram account?
Not anymore for most setups. Meta retired the API that personal accounts relied on in December 2024. Switch the account to a free Creator or Business account in the Instagram app, then reconnect it in the plugin settings.
Why is my feed not showing new Instagram posts?
The feed data is cached for a set interval, and page caches or CDNs may add another layer. Clear the plugin's feed cache, purge your page cache and CDN, and check that WP-Cron is running so background refreshes happen on time.
How often do I need to reconnect my Instagram account?
Smash Balloon refreshes tokens in the background where it can, so many sites rarely reconnect. You will need to reconnect after password changes, security checks, permission changes, or when the plugin shows an expired or invalid connection notice.
Does Cloudflare break Smash Balloon feeds?
It can, mainly through Rocket Loader and aggressive script or HTML optimisation. Turn off Rocket Loader for the site or the feed page, purge the Cloudflare cache, and test again. Smash Balloon documents this issue in its own help articles.
Sources
- My Instagram Feed Stopped Working, or is Displaying an Empty Feed Smash Balloon
- Instagram API Error Message Reference Smash Balloon
- Fix an Invalid Source Error and Reconnect Your Account Smash Balloon
- Smash Balloon Social Photo Feed WordPress.org Plugins
- Instagram Platform Meta for Developers
- Rocket Loader Cloudflare Docs
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.


