Common thumbnail sizes - MediaWiki
Jump to content
From mediawiki.org
Translate this page
Languages:
中文
MediaWiki stores thumbnails indefinitely, so using lots of different thumbnail sizes can result in lots of storage taken up by thumbnails.
This page is an attempt to coordinate to use common sizes (and as a first step, document existing usage patterns).
Unless otherwise noted, the sizes mean width in pixels.
Note that this is about thumbnail sizes requested from the backend, not visual sizes.
Current standard sizes in Wikimedia production:
20px, 40px, 60px, 120px, 250px, 330px, 500px, 960px, 1280px, 1920px, 3840px
Relevant configuration settings
edit source
Name
Description
Default
Wikimedia
$wgThumbnailSteps
Image widths used as steps for thumbnail sizes.
Manually-specified sizes are not used
; instead, the thumbnail with smallest step that has larger value than requested will be shown but it will be downsized via HTML values. It increases the bandwidth to the users by serving slightly large thumbnail sizes they have requested but it will save resources by de-duplicating thumbnail generation and storage.
none
20, 40, 60, 120, 250, 330, 500, 960, 1280, 1920, 3840
[1]
$wgUploadThumbnailRenderMap
Sizes pre-rendered on upload.
none
none
$wgThumbLimits
In-article thumbnail sizes available as user preference.
120, 150, 180, 200, 250, 300
120, 150, 180, 200, 220, 250, 300, 400
$wgDefaultUserOptions
'thumbsize'
Thumbnail size used in articles when the size is not specified in the wikitext and the user has not set their preference.
5 (300px)
5 (250px) (4 220px until 2025
T355914
$wgDefaultUserOptions
'imagesize'
Image size used on file description pages when the user has not set their preference.
2 (800x600)
same
$wgResponsiveImages
Whether to provide alternative image sizes for high-DPI displays. When enabled, article thumbnails, galleries, and images on file pages will have an srcset with 2x of the original size.
true
same
$wgThumbUpright
Scaling factor applied to the
$wgThumbLimits
value for thumbnails where the
upright
wikitext option is used.
0.75 (225px)
0.75 (165px)
$wgGalleryOptions
Image sizes in galleries (when not overriden in the

tag). For traditional galleries, the
imageWidth
and
imageHeight
options are used as a bounding box to determine physical thumbnail size; for
mode="packed"
galleries, width is ignored and
imageHeight * 1.5
is used.
120x120
120x120
$wgImageLimits
File description page image sizes available as user preference; also used for the list of download links under the image. Values are bounding boxes.
320x240, 640x480, 800x600, 1024x768, 1280x1024, 2560x2048
same
$wgThumbnailBuckets
Intermediary thumbnail sizes to use to speed up thumbnail rendering (automatically generated when the image is first thumbnailed).
none
1920 (not sure
Thumbor
uses it though)
Applications
edit source
Thumbnails in articles: per above, usually 300px + 600px with MediaWiki default settings and 220px + 440px on Wikimedia sites. (See
T51357
about increasing it.) For
upright
images, 225px + 338px + 450px by default, 165px + 248px + 330px on Wikimedia sites. Common manually specified Wikipedia image sizes: 20px or 40px for icons, 23x15px for flags.
Galleries: On Wikimedia sites, 120px for traditional galleries. Can be anything for packed galleries as they are height-constrained.
Images on file description pages: 800px + 1200px + 1600px (or it could be anything if the image has smaller than 4:3 aspect ratio).
Images in the file history of description pages: 120x120px (whichever side is bigger)
Images in Galleries of Special:NewFiles, Special:Search etc, 120x120px (whichever side is bigger)
Image download links: 320px, 640px, 800px, 1024px, 1280px, 2560px (for most images, depending on aspect ratio, as above)
Codex
thumbnail component: 40px
MediaViewer
$wgMediaViewerThumbnailBucketSizes
set of width buckets: 320, 800, 1024, 1280, 1920, 2560, 2880
Page previews
: 320px or 640px (depending on the resolution)
Search dropdowns:
Vector 2022: 60px (depending on the resolution):
T322621
Wikimedia portals (e.g.
wikipedia.org
): 160px (
T322622
VisualEditor
Link preview (
ve.init.mw.LinkCache
): 80px
Wikibase
: standard MediaWiki thumbnail sizes (?)
GrowthExperiments
Impact module article icons: 40px, to match Codex thumbnail component size
Task cards: 260px on mobile, 332px on desktop (?)
Link recommendation dialog: uses
ve.init.mw.LinkCache
Image recommendation thumbnail: uses MediaWiki thumb size on desktop, screen width capped to 500px on mobile
Image recommendation dialog: 120px or 160px depending on screen size
Image recommendation dialog, fullscreen image preview: screen size
Image recommendation save dialog: 226px on desktop, screen size on mobile
Toolhub
: 40/60/80px, 50/75/100px, 100/150/200px (depending on viewport resolution)
To do: MobileFrontend search, mobile thumbnails (MobilePage::SMALL_IMAGE_WIDTH/TINY_IMAGE_WIDTH?), mobile image viewer, Special:Search snippets, Special:MediaSearch, probably a bunch of VisualEditor things, MediaViewer download/embed links, mobile apps; FullSearchResultWidget::THUMBNAIL_SIZE, SearchResultThumbnailProvider::THUMBNAIL_SIZE; see if any of these support srcset
FAQ
edit source
Q: Help, my application got a "429 Use thumbnail steps listed on
" message!
Make sure you're using one of the "standard" sizes referenced in
$wgThumbnailSteps
above. Alternatively use the
imageinfo
api instead of directly constructing the image's url.
See also
edit source
Requests for comment/Standardized thumbnails sizes
and the "See also" section there
T211661#8377883
for Wikimedia Varnish stats
T388792
for ensure compliance with standard thumbnail image sizes
Retrieved from "
Category
Image variables
Common thumbnail sizes
Add topic