Docs    instagram    All Docs

How to add support for Smash Balloon GDPR setting in unsupported GDPR plugins

How does automatic GDPR plugin integration work in Smash Balloon's plugins? Smash Balloon's plugins include an automatic integration with sever...

Using a Plugin to Add Custom Templates with Instagram Feeds

Some themes and frameworks, such as the Oxygen Builder framework, do not work properly with how Instagram Feeds detects custom templates in a chil...

How to force CRON jobs to run on my server to update my feeds?

CRON jobs are like scheduled tasks for your website. They automatically perform specific actions at set times, such as updating content or fetchin...

How to fix the error "Your activity off Meta technologies is currently turned off"

This error usually shows up when connecting your Instagram account using our plugin. The issue is related to a setting called "off-Facebook activi...

Temporary Login Link

We recognize the sensitivity of introducing a feature that creates temporary login capabilities, and we want to assure you that this feature has b...

Change the date format displayed when hovering over a post

You can use a custom function on your functions.php file that will not affect your page speed and will allow you to modify the date format display...

What are Instagram Collab Posts and Can I Show These in My Feed?

What is a Collab Post? An Instagram Collab (Collaborative) Post is a single post that appears in two different Instagram accounts. The creator ...

Instagram CSS Layout Changes

With Instagram Feeds 6.3 we have changed the CSS code that determines how your feeds are laid out as well as how your images are cropped and cente...

How to fix a blank or empty plugin interface

This guide will help you if you are facing an issue where the plugin interface or feed preview appears blank or empty, like in the example below. ...

Manually Connect your Instagram Account using an Access Token.

Unfortunately, due to changes in Meta/Instagram's data protection policies, we are no longer able to offer our tool for retrieving an access token...

Manually connect an Instagram Profile using an Access Token

Unfortunately, due to changes in Meta/Instagram's data protection policies, we are no longer able to offer our tool for retrieving an access token...

Instagram Legacy Feeds

If you updated from an older version of the plugin to version 6.0 or above, all the previously created feeds would be considered Legacy Feeds. They...

How to add an Instagram feed using Elementor

To add your feed using Elementor’s native blocks, follow the steps below: 1- Create a new Instagram feed; if you need more information, follow ...

My feed does not update unless I manually clear the cache.

This usually happens when there is an issue with the "CRON" set up on your web server. This is used to run scheduled background tasks that allow ou...

How to fix the error "No Accounts Found. Couldn't find Business Profile"

The error "No Accounts Found. Couldn't find Business Profile" usually indicates that your Instagram Business Profile is not correctly linked to a F...

How to fix the error “API error 190: Error validating access token”

The API error 190 means that your Instagram Access Token is no longer valid, and the feed can't get new images from your account. This usu...

How to reconnect your source to fix the error "Action Required Within 7 Days"

If you received an email or see an error on your plugin settings stating that: "An account admin has deauthorized the Smash Balloon app used t...

Why do I see fewer likes on the posts in my feed than I see on Instagram?

If you see fewer likes on the posts in the Instagram feed on your site than you see directly on Instagram, this is likely due to using Paid Marketi...

I can't click the play button to open video posts on mobile devices

If you are unable to click on the play button to open video posts when you are on a mobile device, this is most commonly caused by CSS conflict...

How to get the System Info from our plugins (Support Request)

To help us troubleshoot the issue you're having, it is important that you share your System Info this way, we are more likely to be able to provid...

Using Custom CSS code in our plugins

Since WordPress 4.7, users can now add custom CSS directly from the WordPress admin area. This is super-easy, and you would be able to see your cha...

Error 999: Access token could not be decrypted.

The issue is being caused by the encryption that Instagram/Facebook requires in regards to access tokens. This encryption relies on the Salt hashes...

Using Custom JavaScript code in our Instagram Feed plugin

To use Custom JavaScript snippets in our Instagram Feed plugin, we recommend using the following approach: 1) Install the WPCode plugin (formerly ...

Why are deleted images still showing up in my Instagram feed?

[new-ig-docs] This issue is related to two settings within your plugin settings. The "Optimize Images" setting allows the plugin to create and st...

Instagram Feed Option Features – PRO vs. Free

The following table depicts the different plugin setting option differences when comparing between the PRO vs Free version of the Instagram Feeds p...

Allow Site Developer to obtain Instagram Access Token without allowing access to your Instagram Account

​The easiest way for a site manager/developer/designer is to connect a client's Instagram account without having them jeopardize their Instagram us...

Licenses Explained!

Contents: Licenses explained! How are 5 site and 10 site licenses distributed? Do you have an option to purchase one single license for all your pl...

Instagram Feed WordPress Plugin Change Log

= 6.3.5 January 2, 2023 = * Tweak: Improved and hardened our code base to improve reliability. * Fix: Fixed the shoppable feeds not working when th...

Displaying an Instagram Hashtag Feed on your website

Instagram's API requires that you use a Business Profile connection to be able to create a Hashtag feed with our plugin. If you don't have an Insta...

Instagram API Error Message Reference

If you receive an error message when trying to display your posts then you can use the table below to diagnose the issue and find the relevant solu...

Instagram Standalone Settings Reference

Below is a list of optional settings you can use to customize your feed. Name Setting Options Description Example Settings ...

Setting up the Instagram Feed Pro WordPress Plugin

Note: Setup directions for the Free Instagram Feed plugin can be found here. 1) Once you've purchased the Custom Facebook Feed plugin click on the...

How to fix the broken Facebook and Instagram oEmbed issue in WordPress

On October 24th, 2020, WordPress removed support for Facebook and Instagram oEmbeds. This affected millions of WordPress users and resulted in brok...

Add a gap between posts in the carousel

To add padding space between the posts in a Carousel feed (or any other feed layout), go to WordPress Dashboard > Instagram Feed > All Feeds ...

Instagram Standalone Setup and Configuration

Note: We no longer offer a Standalone version of this plugin. All plugins are now only available as a WordPress plugin. 1) Once you've purchased...

Setting up the Free Instagram Feed WordPress Plugin

Version 6.0 and above 1) To upload the plugin click Add New at the top of your WordPress Plugins page. 2) Click Upload at the top. 3) Browse ...

How to delete all platform data

To delete all of your Instagram platform data (connected accounts, cached posts and images) please go to WordPress Dashboard > Instagram Feed &g...

How to create an Access Token and User ID to Manually connect an Instagram Account

Unfortunately, due to changes in Meta/Instagram's data protection policies, we are no longer able to offer our tool for retrieving an access token...

My Feed Stopped Working, or is Displaying an Empty Feed with no Posts

[new-ig-docs] Version 6.0 and above If your Instagram photos aren't loading and all your see is a loading symbol then there are a few common reas...

Instagram Likes, Comments, and Followers not Working

Instagram no longer provides details for likes, comments, and followers for personal accounts through the API. In order for the plugin to be able t...

Error: "There is no connected account for the user"

[new-ig-docs] Version 6.0 and above This error should not occur for version 6.0, if you see this error please update your plugin to the latest ve...

My Profile Picture is Missing

Version 6.0 and above Instagram does not provide profile pictures (avatars) for personal accounts through the API. In order for the plugin to be ab...

How can I allow editors access to the Instagram plugin settings?

You can grant other user roles access to the feed settings by using a plugin such as User Role Editor and giving a role the manage_instagram_feed_...

Instagram API Changes - June 29, 2020

Update: The original deprecation date of March 2nd has now been changed by Instagram to June 29, 2020. As of June 29, 2020, Instagram will no lo...

I'm Unable to Update My Connected Account

If you are trying to reconnect your account but the notice to reconnect keeps appearing, the old version of the JavaScript file for the plugin may ...

Differences between an Instagram Personal and Business account

Instagram has two main different account types; Personal and Business*.  Below are the specific differences between the two account types and what ...

Instagram Connection Error - Error Connecting an Instagram Account

If you are unable to connect an account using the big blue button on the "Configure" tab or connect an account manually, you may be using an older ...

Reauthorizing our Instagram/Facebook App

If you need to reauthorize our plugin app (or you'd like to remove it altogether) then you can do so by going to the app settings within your Faceb...

Will This Plugin Continue to Work After March 2020?

Update Feb 4, 2020:  An update for the Pro version is now available (change log). Yes. The Instagram Feed plugin has already started supporting ...

Some Instagram Business Pages aren’t listed after authorizing plugin

If you're trying to connect an Instagram account using the "Business" option but some of the Instagram Business accounts are not listed then this i...

Legacy: Instagram Hashtag API error: "The requested resource does not exist"

- Updated Dec 27, 2018. Some users are experiencing the following error message when trying to use the new Instagram Hashtag API: "message": "The ...

Reconnecting an Instagram Business Profile

Version 6.0 and above If you are having issues with your Instagram Business Profile not connecting successfully inside the plugin, errors tryin...

Migrate to the new Instagram Hashtag API

[new-ig-docs] Version 6.0 and above While the Instagram Hashtag API is no longer new, you will need to ensure you are connected as a Business Pro...

Instagram Business Profiles (required for Hashtag and Tagged feeds)

What is an Instagram Business Profile, and why would I need one? An Instagram Business Profile is required by Instagram in order to access some fee...

Video Posts are Missing or Only Show Thumbnail

Your videos are being flagged for copyright issues Recently Instagram removes videos from its API that contain copyrighted or potentially copyright...

Email Report Is Not Sending or Not Showing up in My Inbox

If your email report is not showing up in your inbox, even though there is an error occurring with a feed, it's likely that the message is being bl...

Combining multiple types of Instagram feeds

[new-ig-docs] Version 6.0 and above To display multiple feed types in a single feed, click the "Add Another Source Type" button.   ...

How Can I Use a Lazy-Loading Plugin with my Instagram Feed

[new-ig-docs] If you would like to set up the plugin to work better with lazy-loading plugins or scripts, please go to WordPress Dashboard > Ins...

My Instagram Feed page is loading slowly

There are a few different factors that could affect how quickly your Instagram feed loads. In version 6.0 (Free and Pro) we've made the plugin fast...

How to Prevent Your oEmbed Access Token From Expiring

To prevent your oEmbed token from expiring Facebook required you to create a Facebook page. The page does not have to be actively used or have any ...

My Feed Updates Slowly or Not at All

Here are some common reasons that your feed may not be updating or takes longer to update than the time you have specified in the Caching setting l...

Instagram Photos not Displaying in Firefox

This is most likely being caused by an add-on or extension, for example, the "Facebook Container" Extension made by Mozilla. As of version 5.0 o...

The Images in My Feed Are Missing or Showing Errors

If you are displaying a recent hashtag feed or are using GDPR related features and the images in your feed are showing as an error or as blank, the...

Admin AJAX Requests are Not Working

The use of the admin-ajax.php file by our plugin is necessary for certain features to work. This includes loading more posts with the "Load More" b...

Instagram API Changes - December 11, 2018

On December 11, 2018, Instagram made some major changes to their existing API which affected certain parts of our Instagram Feed Pro plugin. Some p...

Instagram API Changes - April 4, 2018

Due to some sudden changes that Instagram has made to their API on April 4th, 2018, some features of our Instagram Feed plugin will no longer be av...

Guide to Creating Custom Templates

The HTML for feeds can be customized using a setting and PHP files added to the active theme's folder. Please note that using custom templates may ...

Vertically center Instagram caption on hover

To vertically center the Instagram caption text when hovering over a post, you can add the following JavaScript to your site. This can be done manu...

How Does Image Resizing and Optimization Work?

The image files that come from Instagram's API are a very large 1080 pixel resolution. To optimize the size of the images in your feed and keep you...

Add Like and Comment counts to the Instagram lightbox

Use this snippet to add like & comment counts to the popup lightbox. First, make sure the Likes & Comments Icons are enabled in your setti...

I Can't Switch Accounts and Connect a Second Instagram Account

The Instagram App for mobile devices allows a single log-in for multiple Instagram accounts. This can cause our plugin to be unable to connect othe...

What GDPR Consent Plugins does the Plugin Work With?

The following third-party GDPR related plugins are compatible with the latest versions of our plugins: Cookie Notice by dFactory GDPR Cookie C...

I Can't Connect or Manage Accounts on the Instagram Feed Settings Page

If you are unable to connect an account or delete an account, you may have a JavaScript error occurring on the page that is preventing some feature...

Updating the Instagram Feed Pro WordPress plugin

If you have activated your plugin license key on your website then you should see a plugin update available on your WordPress Plugins page. If y...

Can I display photos from a specific hashtag only from a specific user account?

You can easily display posts from an Instagram account that contain certain hashtags by using the setting labeled 'Only show post containing' which...

Hide / Block photos from a certain username

As of December 11, 2018, filtering out posts made by users is no longer possible unfortunately due to limitations of the Instagram API.

Hide duplicate Instagram photos

Version 2.0 and above Version 2.0 and above of the plugin will now automatically remove duplicate photos from your feed. Less than version 2.0 I...

Hide photos which contain a specific word or hashtag

You can easily hide posts that contain certain hashtags from your Instagram feed by using the setting labeled 'Do not show post containing'.  This ...

Updating your Instagram Access Token

To obtain a new Access Token from Instagram just follow the simple directions below: [new-ig-docs] Version 6.0 and above 1) Go to WordPress Dashbo...

Differences between Instagram feed free and Pro versions

The main differences between the free version and the Pro versions of the Instagram Feed plugin are listed below. The extra features available in t...

Link Instagram photos to custom URLs

By default, the photos in the Instagram Feed will link to the photos on Instagram or our Lightbox, however, you can use custom code snippets to lin...

Instagram Feed - GDPR Compliance

Important: If you are using our Instagram Feed plugin on your website then please refer to our GDPR disclosure for full details regarding complianc...

How do I make my feed span the whole page in a single row?

If your feed is set to be 100% width but still isn't spanning the entire width of the page, you may need to make some changes to your theme in orde...

What's the difference between the WordPress plugin and the Standalone version?

We no longer offer a Standalone version of this plugin. All plugins are now only available as a plugin for WordPress platform.

I Just Upgraded to Pro But Can't Use the New Features

The "Pro" version and "free" version are separate plugins. A quick and easy way to check which version you might still be using is to go to the plu...

I Have Extra White Space Above the Feed and Can't Remove it

Since WordPress 4.8, text widgets may occasionally add an extra paragraph <p> HTML element above the feed. This can add unwanted white space....

Make a Shoppable Feed

If you would like to create a "Shoppable" feed, where the images in your feed link to other pages on your site rather than back to Instagram, then ...

Guide to Moderation Mode

Version 6.0 and above Moderation mode was introduced in Instagram Feed Pro version 2.4 to create a more visual way to moderate feeds. Using this fe...

How Do I Use the Custom Javascript and CSS Areas?

The Instagram Feed plugin comes with a lot of settings to customize the feed. If you need even more customization, using the Custom JavaScript and ...

How to Manage Translations in the Feed

There are a few bits of text in the Instagram Feed that may need to be translated to fit your locale. Here are some different options on how you ca...

Center Follow Button on Top of Feed

To center the "Follow" button over the images in the feed, add the following JavaScript to your site. This can be done manually using a custom Java...

How Can I Show the Original Aspect Ratio?

[new-ig-docs] Version 6.0 and above Using the Masonry Layout You can display images in their original aspect ratio using the masonry layout. To us...

Add "Follow on Instagram" Button to a Hashtag Feed

If you would like to add a "Follow on Instagram" button below a hashtag feed, use this snippet customized to what account you want to link it to. ...

Includewords, Excludewords, or White List Feature Not Working

If you are using the setting show/remove posts that contain these words or phrases, otherwise known as the includewords/excludewords settings, you ...

How to Get an Instagram Access Token From Another Account

[new-ig-docs] Version 6.0 and above When you click on the "Connect" button on the Manage sources section, the plugin will retrieve an access toke...

Posts are missing from my hashtag feed

There are some limitations when displaying an Instagram Hashtag feed on your website. When displaying a "Recent" feed, Instagram only returns the m...

Displaying photos from multiple user accounts in the same feed

[new-ig-docs] Version 6.0 and higher User Feeds To show photos from multiple user accounts in one feed, first connect the accounts at WordPress Das...

Random Sorting Doesn't Work On Every Page Load

[new-ig-docs] Version 6.0 and higher To ensure that some features work properly and that the page loads quickly, Instagram Feed will only randomize...

The Images in my Posts are Distorted, There is White Space or Parts are Cut Off

By default, our plugin creates square cropped and centered photos for each post. There are a few reasons that this may not look exactly as you need...

My photos don't show up sometimes unless I refresh my page (Ajax theme/plugin)

[new-ig-docs] Version 6.0 and above This usually indicates that you're using an Ajax-powered theme or plugin. This means that when navigating you...

Can I display photos from someone else's Instagram account

[new-ig-docs] If you want to show posts from someone else's Instagram account, you will either need access to log into their account or they will ...

How do I display multiple Instagram feeds?

[new-ig-docs] Version 6.0 and above We've included handy options in the plugin to allow you to display multiple different feeds, either on the sa...

Can I disable the mobile/responsive layout of the Instagram feed?

[new-ig-docs] Version 6.0 and above To disable the responsive layout you can use the same number of columns on Mobile as in the Desktop configura...

How can I hide specific Instagram photos from my feed?

Using Moderation Mode To use a visual interface for hiding posts on the front-end of your site, log in as an admin and Navigate to Instagram Feed &...

Manually updating the Instagram Feed plugin

If you're experiencing an issue updating the plugin via your WordPress Plugins page then you can manually update the Instagram Feed plugin in one o...

Saving my Instagram Feed Settings takes me to a 404 error page

  [new-ig-docs] Version 6.0 This happens occasionally with some WordPress themes. It is caused by the Access Token in the URL of the settings page,...

Make the Feed Span the Whole Content Area

CSS @media all and (min-width: 640px) { #sbi_images, .sbi_item { padding: 0 !important; } #sb_instagram #sbi_images .sbi_item { width: 1...

How do I add the "verified" checkmark to my feed?

The Instagram API does not offer any information about whether a feed is from a verified account or not so this is something you would need to add ...

The header and Follow button aren't showing up. Why not?

[new-ig-docs] The header is included by default in all feeds, but only User and Tagged Posts feeds will show the user information. Public Hashtag ...

Where do I enter my Instagram Feed Pro license key?

Once you have uploaded and installed the Instagram feed plugin you can enter your license key by navigating to the License Field at the top of the ...

Combine two different feed types into a single feed

To combine more than one type of feed into a single feed, simply select more than one feed type while you are creating your feed. Then click Nex...

Move the 'Follow on Instagram' button to the top of your feed

You can move the 'Follow on Instagram' button from the bottom of your feed to the top by adding the following JavaScript to your site. This can be ...

My Instagram Access Token Keeps Expiring

If your feed has previously been displaying just fine then randomly seems to stop working, it is most likely due to your access token expiring. [n...

I'm trying to display a user feed or hashtag feed but it won't work

You might be missing the "type" setting in the shortcode. If the type of feed you are trying to display is different than than the type of feed sav...

Carousel isn't working

1) You do not have enough posts in the carousel In order for the carousel to work properly, you need to have more photos in the feed than the numb...

Display photo caption when hovering over photo

[new-ig-docs] Version 6.0 and above To do this use the checkboxes in the 'Information to display' setting to choose which information to show whe...

Creating a carousel or slideshow from your Instagram photos

[new-ig-docs] Version 6.0 and above To create a Carousel or Slideshow style feed, simply select one of the carousel templates while creating your f...

I want to display the feed in a Widget Area but it's not working

[new-ig-docs] Version 6.0 and above To display a feed using the Instagram Feed plugin you would simply need to create a "text" widget and paste i...

Center the header of my Instagram feed

By default, the header image and text are aligned to the left. In the Pro version of the plugin you can center the header by going Instagram Feed &...

The Instagram images in my feed aren't visible

If your WordPress theme is using lazy-loading (or something similar) then it usually sets the opacity on images to be zero which hides them until y...

The pop-up lightbox keeps redirecting to the raw image file

When using the Instagram Feed Pro plugin, if clicking on a photo launches the pop-up lightbox and then immediately redirects you to the raw image i...

jQuery is not defined and no posts shown

The Instagram Feed Standalone Version (and WordPress plugin) requires jQuery to work on your site. It also must be added to the page before the jav...

How to change the color of the icons when a photo has a like or comment

[new-ig-docs] Version 6.0 and above By default, each photo's like and comment icons will remain the same color, whether they are 0 or not. You ca...

Legacy: Change the number of columns for small screens

Note: This document was created for an older version of the plugin and may not work as expected in version 6.0 and above. In version 6.0 we introdu...

Disable Lightbox but keep the hover effect intact

Javascript: Important! Do not disable the lightbox before adding this code. $('#sb_instagram .sbi_item').each(function(){ $sbi_link_area = $...

I have Cloud Flare installed and my feed isn't working correctly

Cloud Flare and Rocket Script is known to cause some issues with WordPress plugins: http://snippets.webaware.com.au/snippets/stop-cloudflare-rocket...

Only show a few Instagram photos on mobile

You can easily change the number of posts that appear in your Instagram feed for desktop and mobile by going to WordPress Dashboard > Instagram ...

Will the plugin continue to work after my license expires?

When a license expires, the plugin will still continue to display your feeds as it did before your license expired, however, you will lose access t...

Add Lightbox Nav Arrows for Mobile Devices

CSS @media all and (max-width: 640px) { #sbi_lightbox .sbi_lb-prev, #sbi_lightbox .sbi_lb-next, #sbi_lightbox .sbi_lb-nav { display:...

Change the Opacity of the Hover Overlay

Add the following to your preferred custom CSS location or stylesheet. One option is the default additional CSS location found at WordPress Dashboa...

Auto-Refresh the Feed Every "x" Seconds

You can create an auto-refreshing feed using an iframe, a special shortcode, and a JavaScript snippet. First, add a shortcode to a page that your v...

Log in and get my Access Token and User ID Button Not Working

If you are not receiving an access token after clicking the big blue Instagram button on the "Configure" tab, try the following: 1) Click on the...

Images Grayscale to Color on Hover

CSS #sbi_images .sbi_item { filter: url("data:image/svg+xml;utf8,<svg xmlns=\'http://www.w3.org/2000/svg\'><filter id=\'grayscale\'>...

Add rounded corners or display photos as circles

To add rounded corners to your photos simply add the following to the plugin's Custom CSS section (Instagram Feed > Customize > Custom CS...

Only display photos with specific IDs (creating a whitelist)

[new-ig-docs] Version 6.0 and higher You can display only specific posts in your Instagram feed by using our moderation features. This will allow y...

The Instagram images are displaying blurry or pixelated

[new-ig-docs] If your Instagram images are displaying blurry or pixelated in our Instagram Feed plugin then it's usually due to the plugin mistaken...

Display the Instagram Feed in a Carousel layout only on mobile devices

In the Pro version of the plugin it is possible to display a regular grid layout on desktop devices but then switch to a carousel layout on smaller...

How do I embed the Instagram feed directly into a WordPress page template?

[new-ig-docs] Version 6.0 and above You can embed the feed directly into a template file by using the WordPress do_shortcode function, ensuring y...

Only include the plugin files on specific pages

By default the Smash Balloon plugins will include its CSS and in some cases JavaScript file on every page, as, due to browser caching, once the fil...

How to Set Up a Backup Feed for the Standalone Version

Note: We no longer offer a Standalone version of this plugin. All plugins are now only available as a WordPress plugin.

Use an Image as the Background of the Load More Button

CSS#sb_instagram #sbi_load .sbi_load_btn { background-image: url("http://localhost/demo.local/wp-content/uploads/2013/08/5plantbg.png"); } T...

Hide Posts Based on Number of Likes

Javascript var minimum_likes = 100; jQuery('#sb_instagram .sbi_item').each(function(){ var likes = parseInt(jQuery(this).find('.sbi_likes').te...

How Can I Hide My License Key on the License Page?

In versions 5.5.1+ you can use a PHP filter to hide the license key page. Here is a basic example: function sb_custom_license_output( $output, $...

How Do I Integrate Mediavine Ads?

If your website is a part of Mediavine ad management service, you can easily incorporate ads in your Instagram Feeds. Here are the simple steps to ...