Jcrop plugin for RailsAdmin, enable image cropping function on image fields.
Ruby JavaScript HTML
Latest commit 5009a1b Jun 8, 2015 @janx Merge pull request #29 from bdurand/master
Add support for carrierwave-aws storage
Failed to load latest commit information.
app Add support for carrierwave-aws storage Jun 7, 2015
lib bump to 1.4.0 Dec 12, 2014
screenshots update screenshots Aug 8, 2012
vendor/assets upgrade to work with rails_admin 0.4.5 Mar 14, 2013
.gitignore adding .DS_Store to .gitignore Aug 7, 2012
CHANGELOG bump to 1.3.0 Apr 8, 2014
MIT-LICENSE initialize with Jcrop 0.9.10 Jun 21, 2012
README.markdown update contributors Dec 3, 2014
rails_admin_jcrop.gemspec work with rails 4 Jul 27, 2013


RailsAdmin Jcrop Plugin

Image cropping made easy!

  1. Add it to your Gemfile and run bundle install:
gem 'rails_admin'
# Because rails_admin_jcrop autoload modules by checking plugins you use, it's
# recommended to require it explictly before rails_admin_jcrop
# e.g. if you use carrierwave
# gem 'carrierwave', :require => 'carrierwave'
gem 'rails_admin_jcrop' #, git: 'git://github.com/janx/rails_admin_jcrop.git'
  1. Configure your model field to use Jcrop:
# RAILS_ROOT/config/initializers/rails_admin.rb
config.model User do
  configure :avatar, :jcrop

  # Below is optional
  edit do
    field :avatar do
      jcrop_options aspectRatio: 500.0/320.0
  1. If you use Paperclip, you need to do nothing here, rails_admin_jcrop will append RailsAdminJcropper processor to your attachment automatically. If CarrierWave is used, please invoke :rails_admin_crop in your uploader:
class AvatarUploader < CarrierWave::Uploader::Base

  version :thumb do
    process :rails_admin_crop
    process resize_to_fill: [500,320]

  1. Done! Click the image on your RailsAdmin model edit page and enjoy cropping! Cropping Screenshot


  • Crop is done when you successfully return from the modal box, you don't need to save the whole record.
  • If you don't see the cropped image on rails admin edit page, the browser is possibly displaying cached version. Try refresh your browser.
  • rails_admin_jcrop >= 1.0.0 works with rails_admin ~> 0.3.x. For older rails_admin, use rails_admin_jcrop 0.2.1.

Field Options


You can pass any Jcrop plugin allowed options here, for example, use aspectRatio to fix the ratio of selection box:

field :avatar do
  jcrop_options aspectRatio: 500.0/320.0

Please check Jcrop document for more available options.


By default, image is scaled properly to make cropping more easy, but sometimes the image is still too large to fit in the modal window, you may need to scroll image up/down to crop. If you set fit_image to true, image will always be resized to fit in modal window.

field :avatar do
  fit_image true

Check screenshots below to see the difference:

When fit_image is false (default)

fit_image false

When fit_image is true

fit_image true


Localize the crop form by adding these entries:

            title: '剪裁'
            menu: '剪裁'


  • MRI 1.9.3 (All above 1.8.6 should work, I only tested on 1.9.3)
  • Rails 3.x
  • MiniMagick

Supported ORM

  • ActiveRecord
  • Mongoid

Supported Asset Plugin

  • CarrierWave
  • Paperclip


  • make sure rails_admin_jcrop load after paperclip/carrierwave load
  • automate :rails_admin_crop for CarrierWave uploader


Any help is encouraged. Here are some ways you can contribute:

  • by using it
  • by telling people
  • by reporting bugs or suggesting new features on github issue tracker
  • by fixing bugs or implementing features



And ...

Life is easier with you.