From Wikimedia Commons, the free media repository
Jump to navigation Jump to search
Translate this page; This page contains changes which are not marked for translation.

Shortcut: COM:CROPT

Other languages:
Deutsch • ‎English • ‎Esperanto • ‎Nederlands • ‎Tiếng Việt • ‎dansk • ‎español • ‎français • ‎italiano • ‎norsk bokmål • ‎polski • ‎português • ‎svenska • ‎русский • ‎українська • ‎עברית • ‎العربية • ‎فارسی • ‎मराठी • ‎हिन्दी • ‎অসমীয়া • ‎বাংলা • ‎ગુજરાતી • ‎മലയാളം • ‎中文 • ‎日本語

CropTool is a 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'd 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 Photoshop than to make a crop of the image that leaves out key parts of its encyclopedic value. Compare:


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 project[edit]

If the CropTool is not present as 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( '//' );