Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Branch: 6.x-1.x
Pull request Compare This branch is even with yhager:6.x-1.x.

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.



= Overview =
imagefield_crop provides a widget for cropping an image after upload.

= Usage =
When the user uploads an image, the image is presented inside a cropping area.
A cropping box is shown inside, and the user can resize and move it. Upon
clicking 'preview' or 'submit', the image is cropped and the result is saved
within the node.

Watch the screencast[1] by capellic[2]


= Features =

* Dynamic preview is presented during cropping
* Original image is displayed every time for re-cropping
* The original image is used for cropping, for best quality
* Ability to define the crop interface resolution
* Ability to define the output image resolution and enforce it

= Prerequisites =
* imagefield (
* filefield (
* imageapi (
* Graphics processing engine (gd, imagemagick, or anything else imageapi.module can work with).

= Installation =
* To install the module copy the 'imagefield_crop' folder to your sites/all/modules directory.
* Go to admin/build/modules. Enable the module.
  Read more about installing modules at

= Configuration and usage =
* We assume that you have already created a new content type. Edit your content type fields at admin/content/types
* Click on appropriate MANAGE FIELDS link.
* Add a new field. To do so click on SELECT A FIELD TYPE dropdown menu. Select FILE. Click on FILE UPLOAD dropdown menu. Select IMAGE WITH CROPPING.
* Click on SAVE button.
* Follow instructions on the next page. You can choose the cropping box size, and other configuration options. If unsure leave default configuration. Click on SAVE FIELD SETTINGS button.
* Create a new item at /node/add
* Click on BROWSE button. Select an image.
* Click on UPLOAD button
* Upon uploading an image, or editing an existing node, the image cropping interface will be presented.

= Contribute. Report issue. Request support. Request new feature. =
* Go to the module issue queue at
* Click on CREATE A NEW ISSUE link.
* Fill the form.
* To get a status report on your request go to

Something went wrong with that request. Please try again.