From Wikimedia Commons, the free media repository
(Redirected from CropTool)
Jump to navigation Jump to search

Shortcut: COM:CROPT

CropTool is a MediaWiki tool for cropping images at Wikimedia Commons and other Wikimedia sites. It supports JPEG, PNG, TIFF and (animated) GIF files, and can also extract single pages from DJVU and PDF files as JPEG for cropping. CropTool is inspired by User:Cropbot, but adds some new features, such as OAuth for authorization and automatic border detection. It runs at Toolforge, and the source code is available at GitHub. Recent usage of the tool is available from recent changes.

If you would like to try the tool, many of the images in Category:Images with watermarks need to be cropped. To choose one at random, visit Special:RandomInCategory/Images with watermarks. Do note, however, that it's better to leave a watermark to be edited out in image editing software than to make a crop of the image that leaves out key parts of its encyclopedic value. Compare:

Coolest Tool Award 2020 square logo.svg


2020 Coolest Tool
Award Winner

in the category


Activate CropTool!

After activation, it will appear in the “Tools” menu of the left column.

Alternatively: go to


1. Here is an image that should have its border removed. Start by clicking “CropTool” in the “Tools” menu. Croptool-01.png
2. To use CropTool, you need to authorize it to use your Wikimedia Commons account using OAuth. Croptool-02.png
3. This will take you to a secure MediaWiki OAuth server. Note that your password is never transmitted to CropTool. Croptool-03.png
4. Make a selection with the cursor and press “Preview”. In this case, we need to make an exact (Precise mode) crop, since we want to keep as much of the image as possible, while removing the border. Note that in many cases an inexact (Lossless mode) is completely sufficient and recommended. Croptool-04.png
5. Looks good, so we can go ahead and press “Upload”. Croptool-05.png

Install on other projects[edit]

If the CropTool is not present as a gadget in your local Wikimedia project (like Wikipedia), you can install it (manually in your user JavaScript settings) with following code:


Install globally[edit]

If you want to have CropTool active on all Wikimedia projects you may use the following code at m:Special:MyPage/global.js. Don't forget to disable CropTool on all projects before you add it globally.

if (mw.config.get('wgNamespaceNumber') === 6 && mw.config.get('wgIsArticle'))
    mw.loader.load( '//' );

See also[edit]