Other languages:
Thumbnail settings: $wgResponsiveImages
Whether or not to output high-resolution images for high-DPI displays
Introduced in version:1.21.0 (Gerrit change 24115; git #Id80ebd0)
Removed in version:still in use
Allowed values:(boolean)
Default value:true


Whether or not to output high-resolution images for high-DPI displays.

This is primarily targeted at tablet browsers and newer desktops and laptops, such as the MacBook Pro with Retina display. On these high-DPI devices, raster images appear blurry or pixelated by default without special treatment.

When generating thumbnail images, thumbnails are rendered not only at the requested size, but at 1.5x and 2x the requested size. The HTML5 srcset attribute is included on the img specifying these larger images for the appropriate display densities.

Native support for the srcset attribute was first added to WebKit browsers in August 2013 and has since been adopted by most modern browsers, now (as of 2020) reaching over 94% of users globally.

For current browsers, compatibility JavaScript is loaded which checks window.devicePixelRatio for most browsers, and a compatibility fallback for IE 10, and applies srcset -> src change automatically. On browsers with native srcset support, this disables itself automatically.

Known limitationsEdit

Currently (as of 1.21) this code applies only to images created through Linker methods; image galleries and file: page detail displays are not currently affected. This should be changed at some point by migrating support lower down in the MediaHandler arena.

Display densitiesEdit

Currently (as of 1.21) the densities used (1.5x and 2x) are hardcoded and not configurable. 1x is the implied default density of the main image.