WordPress.org

Plugin Directory

Test out the new Plugin Directory and let us know what you think.

Instagram Feed

Display beautifully clean, customizable, and responsive feeds from multiple Instagram accounts

Can I display multiple Instagram feeds on my site or on the same page?

Yep. You can display multiple Instagram feeds by using our built-in shortcode options, for example: [instagram-feed id="12986477" cols=3].

Can I display photos from more than one Instagram account in one single feed?

Yep. You can just separate the IDs by commas, either in the User ID(s) field on the plugin's Settings page, or directly in the shortcode like so: [instagram-feed id="12986477,13460080"].

How do I find my Instagram Access Token and User ID

We've made it super easy. Simply click on the big blue button on the Instagram Feed Settings page and log into your Instagram account. The plugin will then retrieve and display both your Access Token and User ID from Instagram.

You can also display photos from other peoples Instagram accounts. To find their Instagram User ID you can use this tool.

My Instagram feed isn't displaying. Why not!?

There are a few common reasons for this:

  • Your Access Token may not be valid. Try clicking on the blue Instagram login button on the plugin's Settings page again and copy and paste the Instagram token it gives you into the plugin's Access Token field.
  • Your Instagram account may be set to private. Your Instagram account may be set to private. Instagram doesn't allow photos from private Instagram accounts to be displayed publicly.
  • Your User ID may not be valid. Be sure you're not using your Instagram username instead of your User ID. You can find your Instagram User ID by using this tool.
  • The plugin's JavaScript file isn't being included in your page. This is most likely because your WordPress theme is missing the WordPress wp_footer function which is required for plugins to be able to add their JavaScript files to your page. You can fix this by opening your theme's footer.php file and adding the following directly before the closing tag: <?php wp_footer(); ?>
  • Your website may contain a JavaScript error which is preventing JavaScript from running. The plugin uses JavaScript to load the Instagram photos into your page and so needs JavaScript to be running in order to work. You would need to remove any existing JavaScript errors on your website for the plugin to be able to load in your feed.

If you're still having an issue displaying your feed then please open a ticket in the Support forum with a link to the page where you're trying to display the Instagram feed and, if possible, a link to your Instagram account.

Are there any security issues with using an Access Token on my site?

Nope. The Access Token used in the plugin is a "read only" token, which means that it could never be used maliciously to manipulate your Instagram account.

Can I view the full-size photos or play Instagram videos directly on my website?

This is a feature of the Pro version of the plugin, which allows you to view the photos in a pop-up lightbox, support videos, display captions, display photos by hashtag + more!

How do I embed my Instagram Feed directly into a WordPress page template?

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

My Feed Stopped Working – All I see is a Loading Symbol

If your Instagram photos aren't loading and all your see is a loading symbol then there are a few common reasons:

1) There's an issue with the Instagram Access Token that you are using

You can obtain a new Instagram Access Token on the Instagram Feed Settings page by clicking the blue Instagram login button and then copy and pasting it into the plugin's 'Access Token' field.

Occasionally the blue Instagram login button does not produce a working access token. You can try this link as well.

2) Your Instagram User ID is incorrect or is from a private Instagram account

Please double check the Instagram User ID that you are using. Please note that your Instagram User ID is different from your Instagram username. To find your Instagram User ID simply enter your Instagram username into this tool.

If your Instagram User ID doesn't show any Instagram photos then it may be that your Instagram account is private and that the Instagram photos aren't able to be displayed.

3) The plugin's JavaScript file isn't being included in your page

This is most likely because your WordPress theme is missing the WordPress wp_footer function which is required for plugins to be able to add their JavaScript files to your page. You can fix this by opening your theme's footer.php file and adding the following directly before the closing tag:

4) There's a JavaScript error on your site which is preventing the plugin's JavaScript file from running

You find find out whether this is the case by right clicking on your page, selecting 'Inspect Element', and then clicking on the 'Console' tab, or by selecting the 'JavaScript Console' option from your browser's Developer Tools.

If a JavaScript error is occurring on your site then you'll see it listed in red along with the JavaScript file which is causing it.

5) The feed you are trying to display has no Instagram posts

If you are trying to display an Instagram feed that has no posts made to it, a loading symbol may be all that shows for the Instagram feed or nothing at all. Once you add an Instagram post the Instagram feed should display normally

6) The shortcode you are using is incorrect

You may have an error in the Instagram Feed shortcode you are using or are missing a necessary argument.

What are the available shortcode options that I can use to customize my Instagram feed?

The below options are available on the Instagram Feed Settings page but can also be used directly in the [instagram-feed] shortcode to customize individual Instagram feeds on a feed-by-feed basis.

  • General Options
  • id - An Instagram User ID - Example: [instagram-feed id=AN_INSTAGRAM_USER_ID]
  • width - The width of your Instagram feed. Any number - Example: [instagram-feed width=50]
  • widthunit - The unit of the width of your Instagram feed. 'px' or '%' - Example: [instagram-feed widthunit=%]
  • height - The height of your Instagram feed. Any number - Example: [instagram-feed height=250]
  • heightunit - The unit of the height of your Instagram feed. 'px' or '%' - Example: [instagram-feed heightunit=px]
  • background - The background color of the Instagram feed. Any hex color code - Example: [instagram-feed background=#ffff00]
  • class - Add a CSS class to the Instagram feed container - Example: [instagram-feed class=feedOne]
  • Photo Options
  • sortby - Sort the Instagram posts by Newest to Oldest (none) or Random (random) - Example: [instagram-feed sortby=random]
  • num - The number of Instagram posts to display initially. Maximum is 33 - Example: [instagram-feed num=10]

  • cols - The number of columns in your Instagram feed. 1 - 10 - Example: [instagram-feed cols=5]

  • imageres - The resolution/size of the Instagram photos. 'auto', full', 'medium' or 'thumb' - Example: [instagram-feed imageres=full]
  • imagepadding - The spacing around your Instagram photos - Example: [instagram-feed imagepadding=10]
  • imagepaddingunit - The unit of the padding in your Instagram feed. 'px' or '%' - Example: [instagram-feed imagepaddingunit=px]
  • disablemobile - Disable the mobile layout for your Instagram feed. 'true' or 'false' - Example: [instagram-feed disablemobile=true]
  • Header Options
  • showheader - Whether to show the Instagram feed Header. 'true' or 'false' - Example: [instagram-feed showheader=false]
  • headercolor - The color of the Instagram feed Header text. Any hex color code - Example: [instagram-feed headercolor=#333]
  • 'Load More' Button Options
  • showbutton - Whether to show the 'Load More' button. 'true' or 'false' - Example: [instagram-feed showbutton='false']
  • buttoncolor - The background color of the button. Any hex color code - Example: [instagram-feed buttoncolor=#000]
  • buttontextcolor - The text color of the button. Any hex color code - Example: [instagram-feed buttontextcolor=#fff]
  • buttontext - The text used for the button - Example: [instagram-feed buttontext="Load More Photos"]
  • 'Follow on Instagram' Button Options
  • showfollow - Whether to show the 'Follow on Instagram' button. 'true' or 'false' - Example: [instagram-feed showfollow=true]
  • followcolor - The background color of the 'Follow on Instagram' button. Any hex color code - Example: [instagram-feed followcolor=#ff0000]
  • followtextcolor - The text color of the 'Follow on Instagram' button. Any hex color code - Example: [instagram-feed followtextcolor=#fff]
  • followtext - The text used for the 'Follow on Instagram' button - Example: [instagram-feed followtext="Follow me"]

For more shortcode options, check out the Pro version.

For more FAQs related to the Instagram Feed plugin please visit the FAQ section on our website.

Requires: 3.0 or higher
Compatible up to: 4.7.3
Last Updated: 3 weeks ago
Active Installs: 300,000+

Ratings

5 out of 5 stars

Support

9 of 31 support threads in the last two months have been marked resolved.

Got something to say? Need help?

Compatibility

+
=
Not enough data

1 person says it works.
0 people say it's broken.

100,1,1 100,1,1 100,1,1
100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,2,2 100,1,1
100,1,1
67,3,2 50,2,1 100,1,1 100,1,1 100,1,1
100,1,1 100,1,1
100,1,1 100,1,1 100,1,1
83,6,5 100,1,1 100,1,1 100,2,2
100,1,1
100,3,3
100,2,2
100,1,1
100,2,2 80,5,4 100,3,3 100,3,3
100,4,4
100,2,2
100,3,3
75,4,3
100,1,1
50,2,1 100,1,1 100,1,1 100,1,1 100,1,1
100,2,2 100,5,5 100,2,2
100,2,2 100,1,1
100,3,3
100,2,2
100,1,1
100,1,1
100,1,1