Plugin Directory

Test out the new Plugin Directory and let us know what you think.
!This plugin hasn’t been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

Get the Image

An easy-to-use image script for adding things such as thumbnail, slider, gallery, and feature images.

Version 1.0.1

  • Changed priority of split_content filter to make sure images are split from the content.

Version 1.0.0

General Changes:

  • the_post_thumbnail argument deprecated in favor of featured.
  • image_scan argument deprecated in favor of scan or scan_raw.
  • default_image argument deprecated in favor of default.
  • order_of_image argument removed with no replacement.


  • Re-coded how the image script works by encapsulating the functionality into a single class rather than multiple functions. This makes it much easier to reuse code and paves the way for more improvements in the future.
  • New scan_raw argument for pulling an image (straight HTML) directly from the post content.
  • New split_content argument for removing an image from the post content if one is found. Used only in conjunction with the scan_raw argument.
  • New order argument for changing the order in which the script looks for images.
  • Better support and handling for sub-attachments (e.g., featured images for audio/video attachments).
  • Support for Schema.org microdata. itemprop="image" attribute added to image outputs where possible.
  • New image orientation class if the width and height are available. Class can be landscape or portrait.
  • Default image size is post-thumbnail if the theme has set this size. Otherwise, thumbnail is the default size.
  • Supports the ability to get embedded images via WordPress' image embeds (Instagram, Flickr, etc.) via the scan* methods.
  • New filter hook: get_the_image_post_content. Used when checking the post content.
  • Added min_width and min_height arguments (doesn't work with scan* methods).

Version 0.9.0


  • Caption support. FTW!
  • Multiple image classes now allowed via the image_class argument.
  • Use current theme's post-thumbnail as default image size if set via set_post_thumbnail_size().

Bug fixes:

  • Use the WordPress-saved attachment alt text for the image.
  • Only add $out['src'] if $out['url'] is set when returning as an array.
  • Allow https when returning as an array.
  • Use the correct variable ($attachment_id) when getting an image via attachment.

Version 0.8.1

  • Use correct $attachment_id variable instead of $id.
  • Pass full $image array to the get_the_image_meta_key_save() function so that it saves correctly.
  • Only use before and after arguments if an image is found.
  • General code formatting updated.

Version 0.8

  • Inline docs updates.
  • Added the before argument to output HTML before the image.
  • Added the after argument to output HTML after the image.
  • Added the thumbnail_id_save argument to allow the attached image to be saved as the thumbnail/featured image.
  • Get the post ID via get_the_ID() rather than the global $post object.
  • Fixed debug notice with $image_html.
  • Moved the *_fetch_post_thumbnail_html hooks into the main function and only fire them if displaying to the screen.
  • Simplified the meta_key logic.
  • Completely rewrote the attachment logic.
  • Sanitize classes with sanitize_html_class().

Version 0.7

  • Deprecated and replaced functions that lacked the get_the_image_ prefix.
  • New cache delete functions that delete when a post or post meta is updated.
  • Fixed notice when image_scan was used.

Version 0.6.2

  • Updated the cache to save by post ID instead of a single object.
  • Minor code adjustments.

Version 0.6.1

  • Updated inline documentation of the code.
  • Smarter meta_key logic, which allows a single meta key or an array of keys to be used.
  • Set custom_key and default_size to null by default since they're deprecated.

Version 0.6

  • Deprecated custom_key in favor of meta_key.
  • Added the meta_key_save argument to allow users to save the image as a meta key/value pair.
  • Added a callback argument to allow developers to create a custom callback function.
  • Added a cache argument, which allows users to turn off caching.

Version 0.5

  • Added support for persistent-caching plugins.
  • Switched the default_size argument to size to be more in line with the WordPress post thumbnail arguments, but default_size will still work.
  • Now using wp_kses_hair() to extract image attributes when using the array value for format.
  • Image alt text will now use the attachment description if one has been given rather than the post title.
  • Updated the readme.html instructions for using the plugin.

Version 0.4

  • Dropped support for older versions of WordPress. Now only compatible with 2.9+.
  • Added support for the_post_thumbnail(), which is WordPress 2.9's new image functionality.
  • New function: image_by_the_post_thumbnail().
  • Documented more of the code, so the inline PHP doc is updated.
  • Cleaned up some of the old legacy code that's no longer needed.

Version 0.3.3

  • General code cleanup
  • Added the get_the_image filter hook.

Version 0.3.2

  • General code cleanup.
  • More efficient and logical code.
  • Beefed up the inline documentation so developers can better understand the code.
  • Added a GPL license.txt file.

Version 0.3.1

  • Fixed the default image and image scan features.

Version 0.3

  • Changed methods of calling the image script.
  • Added more parameters.

Requires: 3.9 or higher
Last Updated: 3 years ago
Active Installs: 60,000+


4.3 out of 5 stars


Got something to say? Need help?


Not enough data

0 people say it works.
0 people say it's broken.

100,3,3 100,3,3
75,4,3 100,3,3
100,7,7 100,1,1 100,4,4
100,7,7 100,2,2
100,1,1 100,3,3
88,8,7 88,8,7
80,5,4 100,1,1
67,3,2 100,1,1
100,1,1 75,4,3
80,5,4 100,1,1
100,1,1 100,1,1
100,1,1 100,2,2
50,2,1 100,1,1
0,1,0 100,1,1