Title: Simple Image Widget
Author: Cedaro
Published: <strong>9 Ctember 2008</strong>
Last modified: 20 Yulyu 2025

---

Search plugins

![](https://ps.w.org/simple-image-widget/assets/banner-772x250.png?rev=3330956)

![](https://ps.w.org/simple-image-widget/assets/icon.svg?rev=3330956)

# Simple Image Widget

 By [Cedaro](https://profiles.wordpress.org/cedaro/)

[Download](https://downloads.wordpress.org/plugin/simple-image-widget.4.4.2.zip)

 * [Details](https://kab.wordpress.org/plugins/simple-image-widget/#description)
 * [Reviews](https://kab.wordpress.org/plugins/simple-image-widget/#reviews)
 *  [Installation](https://kab.wordpress.org/plugins/simple-image-widget/#installation)
 * [Development](https://kab.wordpress.org/plugins/simple-image-widget/#developers)

 [Support](https://wordpress.org/support/plugin/simple-image-widget/)

## Description

Simple Image Widget is what the name implies — the easiest way to add images to 
your sidebars. Display advertisements, calls-to-action, or even build a slider based
on image widgets.

Despite its simplicity, Simple Image Widget is built with extensibility in mind,
making it super easy to spin off new image-based widgets, or customize the widget
ouput using the available template hierarchy.

### Additional Resources

 * [Write a review](https://wordpress.org/support/view/plugin-reviews/simple-image-widget#postform)
 * [Contribute on GitHub](https://github.com/cedaro/simple-image-widget)
 * [Follow @cedaroco](https://twitter.com/cedaroco)
 * [Visit Cedaro](https://www.cedaro.com/?utm_source=wordpress.org&utm_medium=link&utm_content=simple-image-widget-readme&utm_campaign=plugins)

## Screenshots

[⌊A new image widget.⌉⌊A new image widget.⌉[

A new image widget.

[⌊The widget after selecting an image.⌉⌊The widget after selecting an image.⌉[

The widget after selecting an image.

## Installation

Install just like most other plugins. [Check out the codex](https://codex.wordpress.org/Managing_Plugins#Installing_Plugins)
if you have any questions.

## FAQ

### Is there a way to filter the widget output?

Absolutely. Changing the output can be done a few different ways, but the most common
alternatives involve using the « `simple_image_widget_output` » filter or overriding
the template in your theme.

To use the template method, copy « `widget.php` » from the « `/templates` » directory
in the plugin to a « `/simple-image-widget` » directory in your theme. Then update
as you wish. It’s also possible to create a custom template specific to each sidebar
in your theme using the following default template hierarchy:

 * `{theme}/simple-image-widget/{sidebar_id}_widget.php`
 * `{theme}/simple-image-widget/widget.php`
 * `{plugin}/templates/widget.php`

_Always use a [child theme](https://codex.wordpress.org/Child_Themes) to make changes
if you acquired your theme from a third-party and you expect it to be updated. Otherwise,
you run the risk of losing your customizations._

### How do I add alt text to images in the widget?

When selecting an image in the media modal (the popup to select images), the right
sidebar will be titled « Attachment Details » and contains a field for entering 
alt text. After entering your alt text, click the « Update Image » button to use
the selected image in your widget. Most browsers don’t show the alt text, so you’ll
need to view the HTML source to make sure it exists.

### How do I center the widget?

The widget can be centered using CSS. Custom CSS should be added a child theme or
using a plugin like [Simple Custom CSS](https://wordpress.org/plugins/simple-custom-css/)
or [Jetpack](https://wordpress.org/plugins/jetpack/). The following snippet will
center the contents of the widget:

    ```
    .widget_simpleimage {
         text-align: center;
    }
    ```

### Can I remove the width and height attributes?

The widget uses the core function `wp_get_attachment_image()` to display the image
and it would be more trouble than it’s worth to remove those attributes. Some basic
CSS will typically allow you to make the image responsive if necessary:

    ```
    .widget_simpleimage img {
        height: auto;
        max-width: 100%;
    }
    ```

## Reviews

![](https://secure.gravatar.com/avatar/109851919a171ac5df460c01952fd3782b23125be70f12d8494c06192bae28b6?
s=60&d=retro&r=g)

### 󠀁[Better than WP native image](https://wordpress.org/support/topic/better-than-wp-native-image/)󠁿

 [Cyndi](https://profiles.wordpress.org/cynderella/) 24 Yunyu 2020

Nice to be able to choose an appropriate grid size.

![](https://secure.gravatar.com/avatar/dcded9809b7d316c7621baf81897501f785ea6469609be53fb26a4f05374f9f2?
s=60&d=retro&r=g)

### 󠀁[Customizable and simply great](https://wordpress.org/support/topic/customizable-and-simply-great/)󠁿

 [ryver](https://profiles.wordpress.org/ryver/) 21 Ctember 2018

Thanks for creating the simple image widget, it’s great! I was able to easily customize
the template to finally display widgetized bootstrap cards the way I want.

![](https://secure.gravatar.com/avatar/5b68023318947f7d846033c0b8179f9f82b02d6d6d61ce5608d59bd016ab1541?
s=60&d=retro&r=g)

### 󠀁[Perfect image widget plugin](https://wordpress.org/support/topic/perfect-widget-plugin/)󠁿

 [John-Pierre Cornelissen](https://profiles.wordpress.org/jpnl/) 9 Yunyu 2017

With the native image widget that has been introduced with WP 4.8 this plugin has
become obsolete. Still, this plugin has served me very well, so 5 stars and thank
you for that!

![](https://secure.gravatar.com/avatar/b3cc07fdd6f325ffb582bc20204ab993730a35037e5907bddc55d84454b18d03?
s=60&d=retro&r=g)

### 󠀁[cool stuff – best choice for developers!](https://wordpress.org/support/topic/cool-stuff-best-choice-for-developers/)󠁿

 [usability.idealist](https://profiles.wordpress.org/usabilityidealist/) 3 Ctember
2016 1 reply

Excellent choice for developers. Uses the native WP functions, and thus automatically
supports the new responsive image attributes (srcset / sizes) 🙂 The widget template
is awesome fun; make it work with Bootstrap 3? No problemo, boss – just add the 
template to your theme directory, adjust the wp_get_attachment_image() call, and
off you go 🙂 Similar to this: echo wp_get_attachment_image( $image_id, $image_size,
false, array( 'class' => 'img-responsive attachment-' . $image_size . ' size-' .
$image_size ) ); So, if you need flexibility and KNOW what you’re doing – go for
it! cu, w0lf.

![](https://secure.gravatar.com/avatar/c8f95766754d580eb5c9817dcc1d7c9ca5b962d3c9ca102046ae93c2ae8870b0?
s=60&d=retro&r=g)

### 󠀁[Easy to use](https://wordpress.org/support/topic/easy-to-use-959/)󠁿

 [Trek Themes](https://profiles.wordpress.org/trek-themes/) 3 Ctember 2016

Fantastic plugin that I use on many sites

![](https://secure.gravatar.com/avatar/698131a069b7c4b8a1a7bc4de00442ad20438cdd07d7770e8461cf29550d5fe2?
s=60&d=retro&r=g)

### 󠀁[Awesome Plugin](https://wordpress.org/support/topic/awesome-plugin-1908/)󠁿

 [arnold](https://profiles.wordpress.org/liido/) 3 Ctember 2016

Great Plugin. Very Easy to customize fantastic

 [ Read all 39 reviews ](https://wordpress.org/support/plugin/simple-image-widget/reviews/)

## Contributors & Developers

“Simple Image Widget” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ Cedaro ](https://profiles.wordpress.org/cedaro/)
 *   [ Brady Vercher ](https://profiles.wordpress.org/bradyvercher/)

“Simple Image Widget” has been translated into 6 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/simple-image-widget/contributors)
for their contributions.

[Translate “Simple Image Widget” into your language.](https://translate.wordpress.org/projects/wp-plugins/simple-image-widget)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/simple-image-widget/),
check out the [SVN repository](https://plugins.svn.wordpress.org/simple-image-widget/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/simple-image-widget/)
by [RSS](https://plugins.trac.wordpress.org/log/simple-image-widget/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

### 4.4.2 – October 12, 2017

 * Changed the widget name to « Image (Simple) » to differentiate it from the core
   image widget introduced in WordPress 4.8.

### 4.4.1 – September 6, 2016

 * Added missing text domains.

### 4.4.0 – April 22, 2016

 * Enabled selective refresh in the Customizer.
 * Removed PO and MO files in favor of WordPress.org Language Packs.
 * Prevented errors if the main plugin file is accessed directly.

### 4.3.0

 * Transferred to [Cedaro](http://www.cedaro.com/).

### 4.2.2

 * Show media extensions in the post finder modal.
 * Added Dutch translation.

### 4.2.1

 * Fixed a PHP 5.2 incompatibility that prevented the correct image from showing
   on the front-end.
 * Fixed a debug notice when searching for attachments in the new find posts modal.

### 4.2.0

 * Added functionality to search for posts to link images to.
 * Added Japanese translation.
 * Changed the method for generating cache keys. Should provide better support for
   the_widget() and similar methods.
 * Deprecated the method for flushing a single widget instance from the cache.

### 4.1.2

 * Added Serbo-Croation translation.

### 4.1.1

 * Added Finnish translation.
 * Prevent a notice about non-existent title when adding a widget in the Customizer
   in debug mode.

### 4.1.0

 * Added the ability to hide widget fields.
 * Added a field to insert HTML classes on the text link. Hidden by default.
 * Removed « the_content » filter from widget text to prevent other plugins from
   appending content.
 * Renamed /scripts to /js and /styles to /css.
 * Improved handling of fields that have been removed in child widgets.

### 4.0.2

 * Fixed the reference to the widget’s parent class to prevent an error.

### 4.0.1

 * Allow more HTML tags in the text field.
 * Updated customizer support and prevent cache poisoning.
 * Added French translation.

### 4.0.0

 * New template system to make it easier to override the output.
 * Restructured to make it more intuitive for developers to extend the widget.
 * Moved legacy support into a separate class that hooks into the widget.
 * Works with the Widget Customizer added in WordPress 3.9.
 * Improved compatibility with plugins like Page Builder by SiteOrigin.

### 3.0.4

 * Fixed a slash preventing custom translations from loading.
 * Dropped the text domain from custom translation filenames.
 * Loading the text domain earlier so the widget title and description can be filtered.
 * Minor code formatting updates.

### 3.0.3

 * Fixed PHP class name formatting.
 * Added ‘link_open’ and ‘link_close’ args to the $instance when rendering the widget
   display.
 * Added a ‘simple-image’ CSS class to the image wrapper.

### 3.0.2

 * Implemented feature for opening links in a new tab/window.
 * Fixed a bug preventing links in legacy widgets to not work.

### 3.0.1

 * Removed the main plugin file for the previous version.

### 3.0

 * Complete rewrite with new media manager support.

## Meta

 *  Version **4.4.2**
 *  Last updated **12 n wagguren ago**
 *  Active installations **10,000+**
 *  WordPress version ** 4.9 or higher **
 *  Tested up to **6.8.5**
 *  Languages
 * [Dutch](https://nl.wordpress.org/plugins/simple-image-widget/), [English (US)](https://wordpress.org/plugins/simple-image-widget/),
   [Greek](https://el.wordpress.org/plugins/simple-image-widget/), [Hebrew](https://he.wordpress.org/plugins/simple-image-widget/),
   [Italian](https://it.wordpress.org/plugins/simple-image-widget/), [Japanese](https://ja.wordpress.org/plugins/simple-image-widget/),
   akked [Swedish](https://sv.wordpress.org/plugins/simple-image-widget/).
 *  [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/simple-image-widget)
 * Tags
 * [image widget](https://kab.wordpress.org/plugins/tags/image-widget/)[media](https://kab.wordpress.org/plugins/tags/media/)
   [media manager](https://kab.wordpress.org/plugins/tags/media-manager/)[sidebar](https://kab.wordpress.org/plugins/tags/sidebar/)
   [widget](https://kab.wordpress.org/plugins/tags/widget/)
 *  [Advanced View](https://kab.wordpress.org/plugins/simple-image-widget/advanced/)

## Ratings

 4.5 out of 5 stars.

 *  [  32 5-star reviews     ](https://wordpress.org/support/plugin/simple-image-widget/reviews/?filter=5)
 *  [  1 4-star review     ](https://wordpress.org/support/plugin/simple-image-widget/reviews/?filter=4)
 *  [  2 3-star reviews     ](https://wordpress.org/support/plugin/simple-image-widget/reviews/?filter=3)
 *  [  2 2-star reviews     ](https://wordpress.org/support/plugin/simple-image-widget/reviews/?filter=2)
 *  [  2 1-star reviews     ](https://wordpress.org/support/plugin/simple-image-widget/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/simple-image-widget/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/simple-image-widget/reviews/)

## Contributors

 *   [ Cedaro ](https://profiles.wordpress.org/cedaro/)
 *   [ Brady Vercher ](https://profiles.wordpress.org/bradyvercher/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/simple-image-widget/)