Image Widget – WordPress plugin Free download

Click to Download

Image Widget


Image Widget is a simple plugin that uses the native WordPress media manager to add image widgets to your site.

Need to add slideshows, lightboxes, or random images?
Check out Image Widget Plus!

Image Widget Features

MU Compatible
Handles image resizing and alignment
Link the image
Add title and description
Versatile – all fields are optional
Upload, link to external image, or select an image from your media collection
Customize the look & feel with filter hooks or theme overrides
Additional features available with Image Widget Plus

Quality You Can Trust

Image Widget is developed and maintained by Modern Tribe, the same folks behind The Events Calendar, Event Tickets, and a full suite of premium plugins.

This plugin is actively supported by our team and contributions from community members. If you see a question in the forum you can help with or have a great idea and want to code it up or submit a patch, that would be awesome! Not only will we shower you with praise and thanks, it’s also a good way to get to know us and lead into options for paid work if you freelance.

Image Widget Plus!

Image Widget Plus features include:

Multiple image support
Random image

Check out Image Widget Plus now!

Pull Requests & Translations

Check us out on GitHub to pull request changes.

Translations can be submitted here on


The built-in template can be overridden by files within your template.

Default vs. Custom Templates

The Image Widget comes with a default template for the widget output. If you would like to alter the widget display code, create a new folder called “image-widget” in your template directory and copy over the “views/widget.php” file.

Edit the new file to your hearts content. Please do not edit the one in the plugin folder as that will cause conflicts when you update the plugin to the latest release.

New in 3.2: You may now also use the “sp_template_image-widget_widget.php” filter to override the default template behavior for .php template files. Eg: if you wanted widget.php to reside in a folder called my-custom-templates/ and wanted it to be called my-custom-name.php:

add_filter('sp_template_image-widget_widget.php', 'my_template_filter');
function my_template_filter($template) {
    return get_template_directory() . '/my-custom-templates/my-custom-name.php';


There are a number of filters in the code that will allow you to override data as you see fit. The best way to learn what filters are available is always by simply searching the code for ‘apply_filters’. But all the same, here are a few of the more essential filters:


This is actually a pretty typical filter in widgets and is applied to the widget title.


Another very typical widget filter that is applied to the description body text. This filter also takes 2 additional arguments for $args and $instance so that you can learn more about the specific widget instance in the process of filtering the content.


Filters the attachment id of the image.
Accepts additional $args and $instance arguments.


Filters the url of the image displayed in the widget.
Accepts additional $args and $instance arguments.


Filters the display width of the image.
Accepts additional $args and $instance arguments.


Filters the display height of the image.
Accepts additional $args and $instance arguments.


Filters the inline max-width style of the image. Hint: override this to use this in responsive designs 🙂
Accepts additional $args and $instance arguments.
Return null to remove this css from the image output (defaults to ‘100%’).


Filters the inline max-height style of the image.
Accepts additional $args and $instance arguments.
Return null to remove this css from the image output (defaults to null)


Filters the selected image ‘size’ corresponding to WordPress registered sizes.
If this is set to ‘tribe_image_widget_custom’ then the width and height are used instead.
Accepts additional $args and $instance arguments.


Filters the display alignment of the image.
Accepts additional $args and $instance arguments.


Filters the alt text of the image.
Accepts additional $args and $instance arguments.


Filters the url that the image links to.
Accepts additional $args and $instance arguments.


Filters the link target of the image link.
Accepts additional $args and $instance arguments.


Filters a list of image attributes used in the image output. Similar to ‘wp_get_attachment_image_attributes’
Accepts $instance arguments


Filters a list of attributes used in the image link. Similar to ‘wp_get_attachment_image_attributes’
Accepts $instance arguments

Have You Supported the Image Widget?

If so, then THANK YOU! Also, feel free to add this line to your wp-config.php file to prevent the image widget from displaying a message after upgrades.


For more info on the philosophy here, check out our blog post


Image Widget admin screen.
Media manager integration.
Image Widget on the front of a plain WordPress install.



Getting started with Image Widget is a breeze!

Click to Download and install the Image Widget plugin
From your WordPress admin screen, select Plugins from the menu
Activate the Image Widget plugin
Go to Appearance > Widget to place the widget in your sidebar in the Design

If you run into any questions or have suggestions, please visit the forum to post questions or comments.


PHP 5.2 or above
WordPress 3.5 or above


How do I log into my site to install this plugin?

Visit the WordPress codex for help with login troubles.

Can I display Image Widget on only one page?

Yes you can, however, this is not controlled through the Image Widget plugin directly – it is usually managed through a page-specific sidebar display.

There are several solutions available to accomplish this. A quick search for “WordPress page-specific sidebar display” can help you find the best option for your site.

Is there a demo available?

Though we do not have a demo available, we do have screenshots available here.

How can I add lightbox, slider, or random image capabilities?

These features are part of our Image Widget Plus plugin. You can learn more about Image Widget Plus on our website.

Where do I go to file a bug or ask a question?

Please visit the forum to post questions or comments.


Leave a Reply

Your email address will not be published. Required fields are marked *