Image Widget

Wordpress Plugin
Download latest - 4.4.8

Download Stats

Today 528
Yesterday 836
Last Week 5,407
All Time 3,748,167
Banner 772x250

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

  • Responsive
  • 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 The Events Calendar, 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, its 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
  • Slideshow
  • Lightbox

Check out Image Widget Plus now!

Pull Requests & Translations

Check us out on GitHub to pull request changes.

Translations can be submitted here on

Releases (69 )

Version Release Date Change Log
4.4.8 2022-05-06
4.4.7 2017-12-12
4.4.6 2017-09-12
4.4.5 2017-06-16
4.4.4 2017-06-01
4.4.3 2017-05-15
  • Fix - Fixed bug where selecting an image failed to trigger a Save & Publish in the Customizer (props to dsaric-dev for the fix)
  • Tweak - Roll-back to sidebar_admin_setup to enqueue resources for optimal plugin compatibility (props to megamenu for the heads up)
4.4.2 2017-05-11
  • Fix - fixed compatibility with WordPress versions prior to 4.4
  • Fix - proportional scaling of image within the widget editor
  • Fix - fix validation by avoiding empty attributes and only specifying sizes with srcset (thanks Zodiak1978)
4.4.1 2017-04-17
  • Fix - fixed some broken links
4.4 2017-04-17
  • Feature - Add srcset and size attribute support (props @philwp)
  • Tweak - Readme adjustments
  • Tweak - Additional refinements to notice code.
4.3.1 2017-03-20
  • Tweak - adjusted promotional text
4.3 2017-02-10
  • Translations - fixed compatibility with
  • Translations - restored the pot file for easier community translations
  • Tweak - fixed a typo
  • Tweak - Minor code cleanup
4.2.2 2016-02-29
  • Feature - Include registered image sizes in the list of selectable items (props to aaemnnosttv for the pull request!)
4.2.1 2015-12-11
  • Feature - Removing Freemius. Interesting experiment, but ultimately, not our cup of tea. Thanks for sticking with us!
4.2 2015-12-11
  • Security - Prevent direct access to directories (thank you @ramiy)
  • Translations - Remove po/mo files, migrate to language packs
  • Feature - Add support for the rel attribute
  • Feature - Adding an opt-in integration with Freemius
4.1.2 2015-08-19
  • Tweak - Added support for an id attribute on links (Props to amyh for the work on this!)
4.1.1 2015-07-07
  • Tweak - Retiring the use of PHP 4 style constructors
4.1 2014-05-05
  • Remove accidentally deployed image size update.
4.0.9 2014-05-04
  • Fix image stretching bug in admin (Thanks @kyleunzicker)
  • Add polish translation (thank you @difreo)
  • Add hebrew translation (thank you Ariel Klikstein)
  • Add german translation (thank you Daniel Schmidt)
  • Fix "Alt" text in the widget source to use actual "Alt" text (thanks @adoliver and @Degas)
4.0.8 2013-07-26
  • Responsive support in honor of Josh Broton's WordCamp SF talk about responsive design. max-width now defaults to 100%;
4.0.7 2013-03-19
  • Add Spanish translation (thank you @mzaweb)
4.0.6 2013-02-21
  • Rename all language files and implement a couple more minor language bug fixes a la @understandard
  • Added support for the constant 'I_HAVE_SUPPORTED_THE_IMAGE_WIDGET' to turn off the message that appears after upgrading. (@crienoloog, i hope this puts a smile on your face.)
4.0.5 2013-02-18
  • Added Japanese (and fixed a minor language string bug - thank you @understandard)
  • Added Arabic (thank you @modmenpc)
4.0.4 2013-02-13

Super minor fix to enable saving of a blank caption. (thanks @crdunst)

4.0.3 2013-02-13

Fixed javascript bug caused by log message.

4.0.2 2013-02-05

Fix oversized screenshot.

4.0.1 2013-02-03

Language updates:

  • Brazilian Portuguese (Thank you @guhemama)
  • Spanish (Thank you @javiandgo)
4.0 2013-02-02
  • Significant upgrades to support the new WordPress media manager (Thank you @kyleunzicker, @dancameron, @dudekpj, @JakePT)
  • Significant improvements the administrative user interface.
  • Abstracted support for older versions of WordPress so that that we don't break old versions with this upgrade (Though there's no reason you should up grade this widget and NOT your WP install! You should always keep WordPress core up to date!)
  • Added 'image_widget_link_attributes' filter to easily process link attributes and to default to having the link 'title' be the 'alt' or 'title' content. (Thank you @ZeroGravity, @pixelyzed, and @javiandgo)
  • Updated Translations ** Swedish (Tomas Lindhoff ** Dutch (Presis ** Italian (@maxgx)
3.3.7 2012-09-05
  • Add filters so that people can more easily adjust the output of the widget as per @TCBarrett's request.
3.3.6 2012-08-31
  • Czech translation courtesy of Vladislav Musilek at blogsek (
3.3.5 2012-08-25
  • Fix filtered media library inserts thanks to @miraclemaker as well as @oxyc, @BjornW and innumerable others in the support forum (
  • Adjusted HTTPS/SSL handling so that it's only applied in the view. ( thanks @TheFluffyDoneky and @aerobrent )
  • Added a filter for the image url: 'image_widget_image_url'
  • Add Dutch language translation ( thank you Carsten Alsemgeest - )
  • Rename all language files to lowercase image_widget to match the localization string.
3.3.4 2012-04-30
  • Fix javascript bugs in the widget admin UI. ( thanks for filing this @joo-joo )
  • Fix notices in php error log.
  • Add widget description filter $args and $instance ( thanks @jeffreyzinn )
  • Fixed localization and renamed key to 'image-widget'
3.3.3 2012-04-05
  • Romanian translation courtesy of Alexander Ovsov at Web Geek Science.
3.3.2 2012-03-17
  • Remove extra esc_attr() from the $title display. (Thank you @romaspit)
3.3.1 2012-03-12
  • Add minor security updates.
  • Update readme, thumbnails and other minor descriptors.
3.3 2012-03-07
  • Fix to allow the widget to work in the non-async (browser) uploader. Props Bjorn Wijers
3.2.11 2011-12-21
  • Yet another minor JS fix to hopefully address issues of lightbox not working
3.2.10 2011-12-16
  • Fix JS typo.
3.2.9 2011-12-15
  • Minor JS fix to hopefully address issues of lightbox not working
  • Use new the new jQuery.fn.on method for forward compatibility.
3.2.8 2011-07-14
  • Minor bugfix courtesy of Takayuki Miyauchi (@miya0001)
  • Polish translation courtesy of ukasz Kli
3.2.7 2011-07-01
  • Update javascript to work with the new version of WordPress (thanks Matt Wiebe!!! @mattwiebe)
  • Added Japanese translation courtesy of Takayuki Miyauchi (@miya0001)
3.2.5 2011-03-08
  • Added Swedish translation courtesy of Tomas Lindhoff (@Tomas)
3.2.4 2011-03-08
  • Added javascript conflict prevention code thanks to @rcain.
3.2.3 2010-12-14
  • Added French translation courtesy of Dominique Corbex (Domcox)
3.2.2 2010-10-13
  • Added Portuguese translation courtesy of Gustavo Machado
3.2.1 2010-09-14
  • Fix image widget public declaration bug.
3.2 2010-09-13
  • Abstract views for widget output and widget admin.
  • Support theme override of the widget output! Now you can layout the widget however you'd like.
  • Added filter to override template call.
3.1.6 2010-06-24

Fixed Wordpress 3.0 bugs. (Thanks kenvunz)

3.1.5 2010-02-25

Fixed PHP 5 bug. Removed 'public' declaration. Thanks mpwalsh8, jleuze, PoLaR5, NancyA and phoney36

3.1.4 2010-02-08
  • Added support for ALT tags. If no alt tag is entered the title is used.
3.1.3 2010-02-07
  • Added German language support (Thank you Rdiger Wei!!!)
3.1.2 2010-01-08
  • Fix bug: XHTML Compliance (thanks HGU for offering a patch and thanks webmasterlistingarts for filing the bug)
  • Replaced


    in description to also improve XHTML compliance.
3.1.1 2009-10-28
  • Fix bug: php4 reported error: PHP Parse error: syntax error, unexpected T_STRING, expecting T_OLD_FUNCTION or T_FUNCTION or T_VAR or '}' (thanks natashaelaine and massimopaolini)
3.1 2009-10-25
3.0.9 2009-10-25
  • Fix bug: update tabs filter to not kill tabs if upload window is for non widget uses.
3.0.8 2009-10-25
  • Remove the "From URL" tab since it isn't supported.
  • Replace "Insert into Post" with "Insert into Widget" in thickbox.
3.0.7 2009-10-21
  • Fix Dean's Fcuk editor conflict. (Thanks for the report Laurie L_T_G)
  • Fix IE8 bug (Remove extra comma from line 66 of js - thanks for the report reface)
  • Update functions and enqueued scripts to only trigger on widget page.
3.0.6 2009-10-19

Fix crash on insert into post.

3.0.5 2009-10-13
3.0.4 2009-10-03
3.0.3 2009-10-02
3.0.2 2009-09-30
3.0.1 2009-09-30
3.0 2009-09-30
2.2.2 2009-04-13
2.2.1 2009-04-10
2.2 2009-04-03
2.1 2009-03-02
2.0 2009-02-27
1.0 2008-07-26