Back to Community

Why Your Instagram Feed Images Aren't Showing (And How to Fix It)

Content

If your Smash Balloon Instagram feed is displaying placeholders, broken images, or just a spinning loader, you're not alone. This is one of the most common issues users face. Based on community reports and solutions, here are the most frequent causes and their fixes.

Why This Happens

The plugin relies on several components working together: your WordPress theme's code, JavaScript files, and proper communication with Instagram's servers. When one of these elements is blocked, missing, or conflicted, the images fail to load correctly.

Top Solutions to Try

1. Check Your Theme's Code

Many issues occur because the plugin's necessary JavaScript and CSS files cannot load. This is often due to a custom-built theme that is missing the essential WordPress functions wp_head() and wp_footer(). These functions must be present in your theme's header.php and footer.php files for plugins to add their scripts and styles.

2. Disable Script Blocking in GDPR/Privacy Plugins

A very common culprit is a GDPR or privacy consent plugin. These plugins often have a "script blocker" feature that can mistakenly prevent the Smash Balloon plugin's JavaScript from running. To check this, go to your GDPR plugin's settings and look for a section managing script blocking. Ensure that "Instagram," "Smash Balloon," or "Social Feed" is added to the allow list or that blocking is disabled for it.

3. Address Browser Extensions and Firefox Privacy Settings

Privacy-focused browser extensions, especially ad blockers and Facebook containers, can block images sourced from Instagram. Firefox's built-in Enhanced Tracking Protection and Facebook Container extension are known to cause this.

  • Fix: Try disabling extensions or whitelisting your site. Alternatively, enable the "Favor local images" setting in the plugin (Instagram Feed > Customize). This forces the plugin to use images saved on your server instead of fetching them from Instagram, bypassing most privacy blockers.

4. Clear Caches and Retry

Sometimes, the issue is simply stale data. Clear these caches in order:

  • Browser Cache: Hard refresh (Ctrl+F5) or clear your browser's cached images and files.
  • Plugin Cache: Go to Instagram Feed > Settings > click Clear All Caches.
  • Site Cache: Clear any cache from your caching plugin (e.g., WP Rocket, W3 Total Cache) or server-level cache.

5. Enable AJAX Loading

If images are cut off or only partially loading, a JavaScript conflict might be interrupting the process. A simple fix is to enable AJAX loading.

  • Fix: Go to Instagram Feed > Customize > Misc. Enable the setting "Load initial posts with AJAX" and click Save Changes.

6. Check for Plugin or Theme Conflicts

Another plugin or your theme could be causing a conflict. To test this, temporarily switch to a default WordPress theme like Twenty Twenty-Four. If the feed works, the issue is with your theme. If not, temporarily deactivate all other plugins except Smash Balloon. If the feed works, reactivate your plugins one by one to identify the conflicting one. Common conflict sources include lazy loading plugins, image optimizers, and other social feed plugins.

7. Verify the Instagram Account and Access Token

If the account connected to the feed is set to Private on Instagram, the feed will not display images unless you are using an access token generated while logged into that specific private account. Ensure the account is public, or generate a new access token for a private account.

When to Investigate Further

If none of the above solutions work, the issue might be more technical, such as a problem with your server's image processing capabilities. Error messages about missing folders, database tables, or an unavailable image editor (like Imagick) indicate a server-level issue that may require your web host's assistance.

By methodically working through these common solutions, you should be able to resolve most issues causing your Instagram feed images not to display.

Related Support Threads Support