Instafeed.js is a simple way to display your Instagram photos on your website.

Version 2 of Instafeed.js is now available, powered by the new Instagram Basic Display API.

For help upgrading from v1, see the v2 migration guide.

Setting up Instafeed is pretty straight-forward - there are 3 main steps.

1. Create a Facebook app linked to Instagram, and add yourself as a test user. See Managing User Tokens.
2. Create an access token and provide it to an Instagram Token service
3. Add the instafeed.js script to your web page and provide some simple options. See Basic Usage

<script type="text/javascript" src="path/to/instafeed.min.js"></script>

Note: Instafeed.js is also compatible with require.js and commonJS exports

<div id="instafeed"></div>

<script type="text/javascript">
    var feed = new Instafeed({
      accessToken: 'your-token'
    });
    feed.run();
</script>

Instafeed will automatically look for a <div id="instafeed"></div> and fill it with linked thumbnails. Of course, you can easily change this behavior using standard options. Also check out the advanced options for some advanced ways of customizing Instafeed.js.

• A Facebook developer account, and an Instagram account with some media posted to it.
• A Facebook app linked to your Instagram account, and a token generated through that app.
• A service to keep your access token fresh

Here are some of the most commonly used options:

See Options in the wiki for the complete reference.

The easiest way to control the way Instafeed.js looks on your website is to use the template option. You can write your own HTML markup and it will be used for every image that Instafeed.js fetches. See Templating.

See CHANGELOG.md.