This plugin hasn’t been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.



The WordPress Image Refresh Plug In enables you to show a different image every time the page loads. This is an easy to manage yet an awesome way to make your pages look fresh and new every time a user reloads them! The plug in uses short codes to make the frontend feature new images.

The plug in can be used to refresh any image such as the header image or any other on the page. The plug in works for posts, pages, widgets and sidebars.

Usage :

  1. Download the latest version.
  2. Extract to the /wp-content/plugins/ directory.
  3. Login into the admin panel and activate the plugin through the Plugins menu in WordPress.
  4. Now you can manage images from Wp Image Refresh section in the admin menu.
  5. Place the shortcode [wp-image-refresh] where you want to show the random image, on templates, pages or posts.


  1. Enables a Random image on every page reload.
  2. Can be added to posts, pages, templates and in the widgets also.
  3. You can show/hide image title by passing an argument “title=true”. By default it is set to false. For e.g. [wp-image-refresh title=true].
  4. Image size can be set such as ( ‘thumbnail’, ‘medium’, ‘full’). For e.g. [wp-image-refresh type=”thumbnail”]. Default image type is “full”. This option will not work if you have added the images using an earlier version of the Plugin.
  5. A custom class can be set on the image. For e.g. [wp-image-refresh class=”image-class”].
  6. The image can be wrapped into div or span and also can assign custom class, by default this is set to none. For e.g. [wp-image-refresh container=”div” container_class=”image-class”].
  7. Same as the above, the title can be wrapped into div or span and any custom class can be assigned to it. For e.g. [wp-image-refresh title_container=”div” title_container_class=”title-class”].
  8. Images can be wrapped with an anchor tag by adding a valid URL with every image.
  9. The target of an anchor tag can be defined by adding a target tag in the shortcode. For e.g. [wp-image-refresh target=”_blank”]

Why Use The WP Image Refresh Plug In?

  1. The page will feature a new custom image (header or others) every time the page loads.
  2. Will not make the website slow.
  3. Images displayed can be customized.
  4. The Plug in uses short codes.
  5. Can be used for posts, pages, templates and more.


  • This screen shot shows listing of slides in admin panel
  • This is the screen shot of adding slides


This section describes how to install the plugin and get it working.


  1. Extract to the /wp-content/plugins/ directory
  2. Activate the plugin through the \’Plugins\’ menu in WordPress
  3. Place in your templates or use [wp-image-refresh] in your pages or posts


How to display image in the template file?

Place the shortcode [wp-image-refresh] where you want to show the random image, such as( templates, pages or posts).

How can I add a custom class to the Image?

Image class can be set on the image. For e.g. [wp-image-refresh class=”image-class”]

How can I insert the shortcode into the WordPress widgets/sidebars?

Shortcode can be added in a sidebar using Apperance -> Widgets -> Text. By selecting the text widget you can just put the shortcode [wp-image-refresh].

Multi-Site Support

Works only for a single site. Multi-site support to be added in subsequent version of the plugin.


August 11, 2017
The "image link" field doesn't seem to work. Whenever I click on one of the images in the sidebar, it simply brings up the photo with its media library url, not the site its linked to.
May 28, 2017
Hello, This is not a negative, please consider this a constructive feedback. The only feature that will complete it's relevance to more and more persons, [Each image can be liked with different url's] Thank you Namastay
December 20, 2016
We've been using this plugin to rotate through a number of "house ads." It works simply and flawlessly.
Read all 8 reviews

Contributors & Developers

“WP IMAGE REFRESH” is open source software. The following people have contributed to this plugin.


Translate “WP IMAGE REFRESH” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • Blank anchor tag issue fixed.


  • Compatibility issues fixed


  • Minor bug fixes


  • Fixed image cache issue and anchor target issue


  • Minor fixes


  • Fixed title positioning issue with widgets and pages


  • Added new option to wrap the image with an anchor tag by adding a valid URL with every image.


  • Added custom options such as show/hide image title, image size, custom class, container.


  • Removed deprecated php functions.


  • Initial release