InstagramFeed by justb3a

Represents the instagram feed of a user.

WARNING: This repository is no longer maintained

This repository will not be updated. The repository will be kept available in read-only mode.

Instagram Feed

Represents the instagram feed of any user or recently tagged media.


Register your app on Instagram

First you have to register your application on Instagram.

Enter a name, description and (really important) the correct redirect url. You can add more than one. If you want to generate the code and access token to authenticate against instagram from the ProcessWire module setting page, you have to add a url similar as: Just install the module and copy the url inside the address bar.

Register your app on Instagram

When you've done you'll receive a Client ID and a Client Secret.

Receive Client ID and Secret

Install module

Next you have to install the module and enter at least Client ID and Client Secret in module settings.

Click submit.

Generate access token

There are a few steps involved in the authentication process:

  • You get directed to the Instagram website to allow access to your application
  • You get a code back from Instagram
  • This code is used to send a request to Instagram to get an access_token

If you entered the correct redirect url (instagram) and saved Client ID as well as Client Secret (ProcessWire module settings), you only have to click the link get Access Token in module settings.

If everything went well you'll see an access token in module settings.

The access token does not specify an expiration time. Either the user revokes access, or Instagram expires the token after some period of time. Just click the link again to create a new access token.

Generate Access Token

Note: Since 1. of June 2016 every new app created starts in Sandbox mode (Apps are restricted to 10 users, data is restricted to the 10 users and the 20 most recent media from each of those users). read more

More settings..

You can specify some more settings:

  • Username: Instagram username to display content from (default: self)
  • Image Count: Count of media to return

... and use it!

For example:

<?php $feed = $modules->get('InstagramFeed')->getRecentMedia(); ?>

<div class="instagram">
  <?php foreach ($feed as $media): ?>
    <?php if ($media['type'] === 'image'): ?>
      <a href="<?=$media['link']; ?>" class="instagram-item">
          <source media="(min-width: 55rem)" srcset="<?=$media['images']['standard_resolution']['url']; ?>">
          <source media="(min-width: 45rem)" srcset="<?=$media['images']['low_resolution']['url']; ?>">
          <source srcset="<?=$media['images']['thumbnail']['url']; ?>">
          <img src="<?=$media['images']['thumbnail']['url']; ?>" alt="">
    <?php else: ?>
      // output video
    <?php endif; ?>
  <?php endforeach; ?>


You can output any value explained here.

If you want to output another feed, you can pass a username:

  • $modules->get('InstagramFeed')->getRecentMedia('username');


  1. argument passed by
  2. username entered in module settings
  3. default 'self', to get the most recent media published by the owner of the access token

Available endpoints

Get the instagram feed of any user

  • getRecentMedia($username = 'self')
<?php $feed = $modules->get('InstagramFeed')->getRecentMedia(); ?>

Get a list of recently tagged media

  • getRecentMediaByTag($tagname)
<?php $feed = $modules->get('InstagramFeed')->getRecentMediaByTag('processwire'); ?>

Get a list of recent comments on a media object.

  • getRecentComments($media)
<?php $comments = $modules->get('InstagramFeed')->getRecentComments($media); ?>

For example:

$feed = $modules->get('InstagramFeed')->getRecentMedia(); ?>

<div class="instagram>
  <?php foreach ($feed as $media): ?>
    <?php if ($media['type'] === 'image'): ?>
      <a href="<?=$media['link']; ?>" class="instagram-item">
        <img src="<?=$media['images']['thumbnail']['url']; ?>" alt="">

      // display comments
      $comments = $modules->get('InstagramFeed')->getRecentComments($media); ?>
      <?php if ($comments): ?>
          <?php foreach ($comments as $comment): ?>
          <?php endforeach; ?>
      <?php endif; ?>
    <?php endif; ?>

  <?php endforeach; ?>

Override the imageCount value

  • setImageCount($int)

This is a way of setting the imageCount value when initialising the module. It might come in handy if you want to show different number of images on different pages.

<?php $feed = $modules->get('InstagramFeed')->setImageCount(2)->getRecentMedia();  ?>


Install and use modules at your own risk. Always have a site and database backup before installing new modules.

Twitter updates

  • New blog: Debugging tools built-in to ProcessWire. ProcessWire's core comes with a lot of helpful debugging tools and capabilities built-in. In this post we'll cover some of these useful tools and how to use them… More
    1 July 2022
  • A review of weekly core updates, plus a simple recipe for a very effective listing cache—More
    24 June 2022
  • Weekly update: Making ProcessWire render pages at old WordPress URLs (or building a simple/custom URL router in PW): More
    17 June 2022

Latest news

  • ProcessWire Weekly #424
    In the 424th issue of ProcessWire Weekly we'll check out the latest weekly update from Ryan, introduce a new third party module, and more. Read on! / 25 June 2022
  • Debugging tools built into ProcessWire
    ProcessWire's core comes with a lot of helpful debugging tools and capabilities built-in. In this post we'll cover some of these useful tools and how to use them.
    Blog / 1 July 2022
  • Subscribe to weekly ProcessWire news

“We were really happy to build our new portfolio website on ProcessWire! We wanted something that gave us plenty of control on the back-end, without any bloat on the front end - just a nice, easy to access API for all our content that left us free to design and build however we liked.” —Castus, web design agency in Sheffield, UK