Plugin Directory

WP Instagram Widget

WP Instagram widget is a no fuss WordPress widget to showcase your latest Instagram pics.

Hooks & Filters

The plugin has five filters. The first allows you adjust that cache time for retrieving the images from Instagram:

add_filter('null_instagram_cache_time', 'my_cache_time');

function my_cache_time() {
    return HOUR_IN_SECONDS;

The second allows you to filter video results from the widget:

add_filter('wpiw_images_only', '__return_true');

The rest allow you to add custom classes to each list item, link or image:

add_filter( 'wpiw_item_class', 'my_instagram_class' );
add_filter( 'wpiw_a_class', 'my_instagram_class' );
add_filter( 'wpiw_img_class', 'my_instagram_class' );

function my_instagram_class( $classes ) {
    $classes = "instagram-image";
    return $classes;

In version 1.3 you also have two new hooks for adding custom output before and after the widget:


In version 1.4 and above you can also customise the image loop completely by creating a parts/wp-instagram-widget.php file in your theme.

Requires: 3.0 or higher
Compatible up to: 4.4
Last Updated: 2015-9-27
Active Installs: 50,000+


4.6 out of 5 stars


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

Got something to say? Need help?


Not enough data

0 people say it works.
0 people say it's broken.

0,1,0 100,2,2