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.

Random Images


The [random_images] shortcode will display a simple set of random images.

It was originally designed to be used by theme developers, so the styling is very simple. It was also released as a shortcode so people could use it in content areas if they’d like. You can enable your theme to display the [random_images] shortcode in a text widget by adding a snippet of code to the functions.php file in your theme or child theme. See the FAQ for more info.

It uses any attached image in the blog for the source images.

Using [random_images] will display 6 images at thumbnail size linked to attachment pages by default.

To change the number of images and the size:

[random_images total=4 size=medium]

To make the links point to image files instead of attachment pages:

[random_images link=file]

If you have any questions, please ask in the support forum.


  • Set of eight random thumbnail images.


  1. Download archive and unzip in wp-content/plugins or install via Plugins – Add New.
  2. Start using the [random_images] shortcode in your content.


How can I use the random_images shortcode text widgets?

To enable the random_images shortcode in text widgets, add this to the functions.php file in your theme or child theme.

 * If the Random Images plugin is active, allow the random_images shortcode to work in text widgets
if ( method_exists( 'Random_Images_Plugin', 'random_images' ) )
    add_filter('widget_text', 'Random_Images_Plugin::random_images');
How can I use random images in a WordPress theme?

This example will display a set of random images from a theme file:

if ( method_exists( 'Random_Images_Plugin', 'random_images' ) )
   echo Random_Images_Plugin::random_images( array( 'size' => 'thumbnail', 'total' => 9 ) );

Contributors & Developers

“Random Images” is open source software. The following people have contributed to this plugin.


Translate “Random Images” into your language.

Interested in development?

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



  • Switch to using the class as a namespace so it can be called directly in theme files.
  • Update code example in readme.txt, move to FAQ.
  • Add an option to link directly to files instead of attachment pages.


  • First version