Skip to content
Resize WordPress images on the fly
Branch: master
Clone or download
syamilmj Merge pull request #100 from Smartik89/patch-1
Bug fix: Return the original image instead of resized
Latest commit 57fe7e7 Jun 7, 2017
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore v1.2.0 Oct 13, 2013
aq_resizer.php Bug fix: Return the original image instead of resized Jun 7, 2017
composer.json Add composer.json file for Composer compatibility. Nov 30, 2015

Aqua Resizer

Version 1.2

This small script will allow you to resize & crop WordPress images uploaded via the media uploader on the fly. It relies on WP's native functions to resize the images, and checks if there is an already resized version of the image so that it won't be wasting your server's resources to regenerate the images.

Why use it?

There are a couple of image resizing scripts out there that already have this function. Some authors simply use the add_image_size() function to define custom image sizes that will be generated for each image uploaded via the media uploader. I mostly find these methods somewhat a little complicated to use, or having some limitations or too resource intensive.

With Aqua Resizer, the only required inputs are the URL and width. It's easy, fast & efficient. Additionally, you have the additional options such as the height, crop, and array return.

How to use

Simply copy aq_resizer.php into your theme and reference it from your functions.php file e.g. require_once('aq_resizer.php');, then you're good to go.

You can then use it in your theme as such:


More usage instructions and examples can be found in our wiki



Do whatever you want with it. A linkback would be nice :)


If you have some spare bucks, please seriously consider helping the World Food Programme to build world without hunger. Your donations will provide foods & shelters to those who needs them the most! - Fill the Cup!

Or, buy me a coffee :)







  • Aqua Resize is now basically a class (still with a wrapper function so usage has not changed at all)
  • class written as Singleton pattern
  • removed fallback for WP older v3.5


  • either $width or $height is required
  • return false if the image can not be resized to the exact dimension specified in the arguments in crop mode
  • return the original image if specified dimension is the same as the one of the original image


  • uses wp_get_image_editor() (WP3.5)


  • handles wp_error
  • shorten script


  • fix for compatibility with wpml


  • array return use int (0,1,2)


  • add check for broken image


  • default $single to true and return string


  • fix issue with smaller widths

v1.0 first commit

You can’t perform that action at this time.