Docs    instagram    All Docs

Instagram Feed WordPress Plugin Change Log

= Version 5.8.3 – October 26, 2020 = * Fix: Fixed an issue caused by an unannounced Instagram API change where video post thumbnails would not dis...

Displaying an Instagram Hashtag Feed on your website

Due to some major changes Instagram made on December 11, 2018, the process for displaying an Instagram feed on your website has changed.  Instagram...

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 Instagram Feed plugin click on the "Do...

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

On October 24th, 2020, WordPress is removing support for Facebook and Instagram oEmbeds. This will affect millions of WordPress users and result in...

Instagram Standalone Setup and Configuration

1) Once you've purchased the Instagram Feed Standalone Version you'll be presented with the purchase confirmation screen which displays your licens...

Setting up the Free Instagram Feed WordPress Plugin

1) Once you've installed the plugin click on the Instagram Feed item in your WordPress menu   2) Click on the large blue button to c...

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

If you have been asked to provide an Access Token by your Web Developer or Web Content Manager to set up a Facebook Feed using our plugin, or if yo...

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

If your Instagram photos aren't loading and all your see is a loading symbol then there are a few common reasons: [accord] Diagnosing with Deve...

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"

This indicates the older "id" shortcode option is being used like so: [[instagram-feed id="123456789"]] The "id" shortcode option is no longe...

My Profile Picture is Missing

Instagram no longer provides profile pictures for personal accounts through the API. In order for the plugin to be able to retrieve your profile pi...

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

You can grant other user roles access to the settings by using a plugin such as User Role Editor or by using the following filter: function sb_c...

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...

Updating Business or Creator Accounts to the New API

If your Instagram account is a "Business" or "Creator" account you might already be using the new API. Here are instructions to verify that your co...

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...

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": "T...

Reconnecting an Instagram Business Profile

If you are having issues with your Business Profile not connecting successfully inside the plugin, or errors trying to display a Hashtag feed, then...

Migrate to the new Instagram Hashtag API

1) In order to use the new Instagram Hashtag API you must first have an Instagram Business Profile. See here for directions on how to convert a Per...

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 has started removing videos from its API that contain copyrighted or potenti...

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

To display multiple feed types in a single feed, use type="mixed" in your shortcode and then add each user name or hashtag for each feed into the s...

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

If you would like to set up the plugin to work better with lazy-loading plugins/scripts, try enabling the setting "Disable JS image loading" found ...

My Instagram Feed page is loading slowly

There are a few different factors which could affect how quickly your Instagram feed loads. In version 5.0 (2.0 of the free version) of the plugin ...

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 "check for new po...

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 and the images in your feed are showing as an error or as blank, there may be an issue with the image r...

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

As of version 2.1 of the free plugin and 5.2 of the Pro plugin, the HTML for feeds can be customized using a setting and PHP files added to the act...

Vertically center Instagram caption on hover

Add this to the plugin's Custom JavaScript section (Instagram Feed > Customize > Advanced > Custom JavaScript): $('.sbi_hover_top').each(...

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

First, make sure the the Likes & Comments Icons are enabled in your settings, in either of the following locations: Instagram Feed > Customi...

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...

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?

Version 2.0 and above You can easily display posts from a User ID which contain certain hashtags by using the setting labeled 'Show photos conta...

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

Version 2.0 and above You can easily display posts from a user account which contain certain hashtags by using the setting labeled 'Remove photos ...

Updating your Instagram Access Token

To obtain a new Access Token from Instagram just follow the simple directions below: 1) Navigate to the Instagram Feed Settings page in your Wor...

Differences between Instagram feed free and Pro versions

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

Link Instagram photos to custom URLs

By default, the photos in the Instagram Feed will link to the photos on Instagram, however, you can use custom code snippets to link each photo to ...

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...

Browser Asks for Authentication on Pages With a Feed

Our plugin uses admin-ajax.php to retrieve feed data from the WordPress database. This is part of our caching system to prevent reaching the rate l...

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 Instagram Feed WordPress plugin and the Standalone version?

If your site is built on WordPress then it's recommended to use the WordPress plugin. Both versions of the plugin can display your feed in the same...

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

The "Pro" version and "free" version of Instagram Feed are separate plugins. A quick and easy way to check which version you might still be using i...

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 "Shoppable" feed, where the images in your feed link to other pages on your site rather than back to Instagram, then us...

Guide to Moderation Mode

Moderation mode was introduced in Instagram Feed Pro version 2.4 to create a more visual way to moderate feeds. Using this feature allows you to pr...

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 Instagram Feed that may need to be translated to fit your locale. Here are some different options on how you can tr...

Center Follow Button on Top of Feed

JavaScript $('#sb_instagram #sbi_images').prepend( $('.sbi_follow_btn') ); CSS #sbi_images { position: relative; } .sbi_follow_btn { ...

How Can I Show the Original Aspect Ratio?

Using the Masonry Layout (version 3.0 of the pro version and above) As of version 3.0 of the "Pro" plugin you can display images in their origin...

Add "Follow on Instagram" Button to a Hashtag Feed

Add the following to the plugin's "Custom JavaScript" setting, which can be found at: Instagram Feed > Customize > Advanced > Custom JavaS...

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

When you click on the big blue button on the Configure tab, the plugin will retrieve an access token associated with whatever account is currently ...

Posts are missing from my hashtag feed

Hashtag feeds only show publicly available posts. If your feed is missing posts, it's likely due to the post being from a "private" account. You ca...

Displaying photos from multiple user accounts in the same feed

Using Connected Accounts (version 2.10 and above) User Feeds In order to display multiple user feeds, you'll need to connect the Instagram accoun...

Random Sorting Doesn't Work On Every Page Load

To ensure that some features work properly and that the page loads quickly, Instagram Feed will only randomize posts after the feed's cache clears....

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)

This usually indicates that you're using an Ajax powered theme or plugin. This means that when navigating your site your theme loads new content in...

Can I display photos from someone else's Instagram account

As of April 4th, 2018, if you want to show posts from someone else's Instagram account, you will need his or her Access Token. You can retrieve thi...

How do I display multiple Instagram feeds?

We've included handy shortcode options in the plugin to allow you to display multiple different feeds, either on the same page or on multiple pages...

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

If you're using the latest version of the plugin then you can disable the mobile layout by checking the Disable mobile layout setting on the plugin...

How can I hide specific Instagram photos from my feed?

Using moderation mode (version 2.4 and above) To use a visual interface for hiding posts on the front-end of your site, log in as an admin and ena...

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

This happens occasionally with some WordPress themes. It is caused by the Access Token in the URL of the settings page, which is added after you've...

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?

Version 2.0 and above In version 2.0 and above the header will show up on all feeds, but only the header for a User ID feed will display the user ...

Where do I enter my Instagram Feed Pro license key?

Once you've uploaded and installed the Pro version of the plugin you can enter your license key by clicking on the License tab at the top of the pl...

Combine two different feed types into a single feed

Using feed type "mixed" (version 3.0 and above) As of version 3.0 of the "Pro" version you can use the shortcode setting type="mixed" to display...

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 just adding the following snippet to the plugin's Custom J...

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. ...

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

Version 2.0 and above To do this in version 2.0 and above simply use the checkboxes in the 'Information to display' setting to choose which inform...

Creating a carousel or slideshow from your Instagram photos

Version 2.0 and above Version 2.0 and above has a carousel/slideshow feature built right into it. Simply use the 'Carousel' settings on the plugin...

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

To display a feed using the Instagram Feed plugin you would simply need to create a "text" widget and paste in the shortcode [[instagram-feed]]. ...

Center the header of my Instagram feed

By default the header image and text is aligned to the left. We added a centered header option in version 3.0 of the Pro version which can be found...

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

By default the like and comment icons for each photo will remain the same color whether they are 0 or not. You can add a JavaScript snippet to the ...

Change the number of columns for small screens

CSS /* Media queries */ @media all and (max-width: 640px){ #sb_instagram.sbi_col_3 #sbi_images .sbi_item, #sb_instagram.sbi_col_4 #sbi_imag...

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 = $...

How do I create a single post feed?

Important: Due to changes in the Instagram API, single post feeds were deprecated on December 11, 2018.  It's unfortunately no longer be possible...

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

There is a setting available for this in the "Pro" version as of version 2.8. Although you can change the layout/number of columns on mobile, by de...

Will the plugin continue to work after my license expires?

We recommend you maintain a license (for the reasons stated below) but it is your choice as to whether or not you decide to renew a license. ​ Wh...

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

#sb_instagram .sbi_item .sbi_link { visibility: hidden; } #sb_instagram .sbi_item:hover .sbi_link { visibility: visible; background: rgb...

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)

Using moderation mode (version 2.4 and above) To use a visual interface for manually "approving" posts on the front-end of your site, log in as an...

The Instagram images are displaying blurry or pixelated

If your Instagram images are displaying blurry or pixelated in our Instagram Feed plugin then it's usually due to the plugin mistakenly selecting t...

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?

You can embed the feed directly into a template file by using the WordPress do_shortcode function: <?php echo do_shortcode('[[instagram-feed]]'...

How to Set Up a Backup Feed for the Standalone Version

As of version 3.0, a cached version of the posts for your feed is saved in a .txt file on your server. If your feed isn't updating, you may need t...

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 ...