MediaWiki extensions manual
Release status: stable
Implementation User interface
Description Default themes to display badges on Wikimedia projects
Latest version continuous updates
Compatibility policy Snapshots releases along with MediaWiki. Master is not backward compatible.
MediaWiki 1.31+
PHP 7.0+
Composer wikibase/wikimedia-badges
License GNU General Public License 2.0 or later
  • $wgWikimediaBadgesTopicsMainCategoryProperty
  • $wgWikimediaBadgesCategoryRelatedToListProperty
  • $wgWikimediaBadgesCommonsCategoryProperty
Quarterly downloads 11 (Ranked 125th)
Public wikis using 806 (Ranked 313rd)
Translate the WikimediaBadges extension if it is available at translatewiki.net
Issues Open tasks · Report a bug

The WikimediaBadges extension provides default themes to display badges generated by Wikibase Client (via the badgeClassNames setting) on Wikimedia projects.

It provides themes for the following Wikimedia skins:

  • vector
  • cologneblue
  • modern
  • monobook

Make sure you have one of the above skins installed to use the extension. You can check your installed skin on Special:Version.

Additionally the extension changes the Wikimedia Commons link in the "Other projects" sidebar to point to the Commons category (P373), even if the Item's sitelink of the page is actually pointing to the gallery page.


  • Download and move the extracted WikimediaBadges folder to your extensions/ directory.
    Developers and code contributors should install the extension from Git instead, using:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/WikimediaBadges
  • Add the following code at the bottom of your LocalSettings.php file:
    wfLoadExtension( 'WikimediaBadges' );
  •   Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.