Skin:Vector/2022

Vector 2022 is the second evolution of the MediaWiki Vector skin and is in development as part of the Desktop improvements project. It has been bundled in MediaWiki since. It is the default skin for various Wikimedia projects.

Vector 2022 differs from most skins in that it does not have its own code base; rather, its code is part of the Vector skin's, and the two are downloaded together.

Optional dependencies
Vector 2022 makes use of the following extensions, though none are hard requirements:


 * - for the language switch button
 * - if you want to include an image for the page (if available) in the new search bar
 * - if you want to include a description for the page in the new search bar (Wikimedia projects do not use this; the description comes from the Wikibase extensions)

Making Vector 2022 the default skin
For MediaWiki versions 1.38 and higher, add the following to LocalSettings.php to make Vector 2022 the default skin:

For versions 1.36 and 1.37, you should instead add the following:

Note about 1.38 release
The 1.38 release marked official 3rd party support for the skin; however, between 1.36 and 1.38, the skin was available at 3rd parties' own risk.

If a site running MediaWiki 1.36 or 1.37 is using Vector 2022, it will hit challenges when upgrading to the 1.38 release. This is unavoidable, and one of the reasons why the use of this skin was discouraged prior to 1.38.

If the site allowed users to opt into the new experience, these users will be served legacy Vector after the upgrade, and will need to revisit Special:Preferences to update their skin preference to Vector 2022.

For large wikis, where a change in skin may be disruptive to logged-in users, you may want to consider writing a maintenance script to upgrade existing database preferences. See T299104 and for more details.

Configuration parameters
Note that Vector has several unstable feature flags, which may disappear at any time. Most of these feature flags relate to incomplete features. We do not recommend changing any feature flag from its default value unless listed here.

$wgVectorMaxWidthOptions
Can be used to configure whether the max-width applies. Relatively stable at this point.

$wgVectorLanguageInMainPageHeader
Controls whether the language button shows on the main page in the header.

$wgVectorWvuiSearchOptions
Associative array with keys showDescription and showThumbnail (both booleans).