This extension is made for Wikimedia wikis. It does work for other wikis, but note that the extension contains Wikimedia-specific text.
MediaWiki extensions manual
OOjs UI icon advanced.svg
Release status: stable
Implementation Special page , API
Description adds a special page with a matrix of all Wikimedia sites
Author(s) Tim Starling, Brion Vibber, Victor Vasiliev, Alexandre Emsenhuber
Latest version 1.4.0 (2016-07-22)
License GNU General Public License 2.0 or later
Example Special:SiteMatrix
  • $wgSiteMatrixSites
  • $wgSiteMatrixFishbowlSites
  • $wgSiteMatrixFile
  • $wgSiteMatrixClosedSites
  • $wgSiteMatrixPrivateSites
Translate the SiteMatrix extension if it is available at translatewiki.net

Check usage and version matrix.

Issues Open tasks · Report a bug

The SiteMatrix extension adds a special page with a matrix of all sites of the Wikimedia Foundation. First a table of all normal language wikis, with blue links for existing wikis and red links for non-existing wikis. Below a list of other special projects (like Meta, Commons, Wikimania, ...), mostly the sites like *.wikimedia.org. It also adds a NUMBEROFWIKIS parserfunction which shows the total number of wikis[1].


  • Download and place the file(s) in a directory called SiteMatrix in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
    wfLoadExtension( 'SiteMatrix' );
  •   Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

To users running MediaWiki 1.24 or earlier:

The instructions above describe the new way of installing this extension using wfLoadExtension(). If you need to install this extension on these earlier versions (MediaWiki 1.24 and earlier), instead of wfLoadExtension( 'SiteMatrix' );, you need to use:

require_once "$IP/extensions/SiteMatrix/SiteMatrix.php";


There are some variables that you need to change:

  • $wgSiteMatrixFile - The path to a list of language codes recognised by MediaWiki (example).
  • $wgSiteMatrixPrivateSites - The path to a list of wiki databases that are private (optional)
  • $wgSiteMatrixFishbowlSites - The path to a list of wiki databases that are public, but only logged in users can edit. (optional)
  • $wgSiteMatrixClosedSites - The path of a list of wiki databases that "closed" (optional)

You would also need to customise $wgSiteMatrixSites to list the different wikis in your own wikifarm. To add a new site, follow the template in extension.json as a guide (but be sure to convert the syntax to PHP). As this has been removed for better compatibility, use the code below as a reference:

	"wiki": {
		"name": "Wikipedia",
		"host": "www.wikipedia.org",
		"prefix": "w"
	"wiktionary": {
		"name": "Wiktionary",
		"host": "www.wiktionary.org",
		"prefix": "wikt"

Additional requirements

To ensure that the extension works correctly to your needs, there are a few dependencies to this extension:

  • $wgLocalDatabases - To tell the extension all the wiki databases that exist in your wikifarm.
  • $wgConf - To feed the extension with the correct links to the different wikis in your wikifarm.


This extension adds an API module that provides the same information as Special:SiteMatrix: a set of language groups plus special wikis.

action=sitematrix (sm)

(main | sitematrix)

Get Wikimedia sites list.

The code (technically dbname/wikiid) is either the language code + project code for content projects or the subdomain + main domain for all the others.


Filter the Site Matrix by type:

One off and multilingual Wikimedia projects.
Wikimedia projects under this language code.
Values (separate with | or alternative): language, special
Default: special|language

Filter the Site Matrix by wiki state:

Values (separate with | or alternative): all, closed, fishbowl, nonglobal, private
Default: all

Which information about a language to return.

Values (separate with | or alternative): code, dir, localname, name, site
Default: code|name|site|dir|localname

Which information about a site to return.

Values (separate with | or alternative): code, dbname, lang, sitename, url
Default: url|dbname|code|sitename

Maximum number of results.

Type: integer or max
The value must be between 1 and 5,000.
Default: 5000

When more results are available, use this to continue.

Show the site matrix
api.php?action=sitematrix [open in sandbox]

More examples

Show site matrix (only parts are shown here)

See also