MediaWiki 1.31

MediaWiki 1.31 is the latest long-term support release of MediaWiki.

Consult the  file for the full list of changes.

It was deployed on Wikimedia Foundation wikis through incremental "wmf"-branches starting 26 September 2017.

The 1.31.0 stable release was released on 13 June 2018.

Download the [https://releases.wikimedia.org/mediawiki/1.31/ latest releases] or checkout the   branch download>Special:MyLanguage/Download from Git|in Git to follow this release.

It will go end-of-life in June 2021.

More bundled extensions


The set of extensions that are bundled with the MediaWiki tarball has increased. The new additions are:


 * provides a more friendly editor when editing CSS and JavaScript on-wiki.
 * provides a lightbox viewer for images and galleries.
 * provides two-factor authentication for wiki accounts.
 * provides a form to let administrators do string replacements on the entire wiki, for both page contents and page titles.
 * provides a form to let administrators do string replacements on the entire wiki, for both page contents and page titles.

The  extension was not included in the tarball for MediaWiki 1.31.0 by mistake. If you want to use this extension, please download the extension separately. This is fixed in 1.31.1 and up.

Timeless skin
Timeless is a new, responsive skin for MediaWiki, and is now bundled.

CologneBlue and Modern
The CologneBlue and Modern skins are no longer bundled, although are still compatible with MediaWiki. If you are upgrading and had that skin installed, be sure to download it separately.

Tidy replaced with HTML 5 parsing algorithm

 * See the frequently asked questions for more details

The HTML 4 based Tidy library has been replaced by a pure-PHP HTML 5 parser named RemexHtml to clean up improper wikitext in a modern and standards compliant way. If your content relied on some of the tidy fix-ups that are not being continued, they will need to be fixed.

You can use the  extension in conjunction with Parsoid to identify pages with problems that cause differences in rendering with the RemexHtml parser.

The  extension shows editors a side-by-side comparison of rendering with tidy and RemexHtml.

Interwiki usernames
MediaWiki now supports "interwiki" usernames in a format like " " in revisions, log entries, and so on. This allows for properly recording imports and events from foreign wikis (as generated by Wikibase, for example) without confusion with a local account that exists now or may be created in the future.


 * Imports will now record unknown (and, optionally, known) usernames in a format like " ".
 * (used on history pages, log pages, and so on) will display usernames formed like " Example" as interwiki links, as if by wikitext like.

Further UI standardization

 * As a first pass in standardizing dialog boxes across the MediaWiki product, Html class now provides helper methods for messageBox, successBox, errorBox and warningBox generation.

Other feature changes

 * Add default edit rate limit of 90 edits/minute for all users. This can be changed by setting.
 * only affects  actions.
 * User sub-pages named  are now protected in the same way that   and   pages are, so that configuration options can safely be placed there.
 * The info page for File pages now displays the file's base-16 SHA1 hash value in the table of basic information.
 * The pingback feature will now send a monthly heartbeat ping to identify active wikis.
 * Tabs which link to pages that don't exist (like those to uncreated discussion pages) now have a tooltip to indicate state, not just colour.

Languages updated in 1.31
MediaWiki supports over 350 languages. Many localisations are updated regularly. Below only new and removed languages are listed, as well as changes to languages because of Phabricator reports.


 * Mirandese (mwl) now supports gendered /.
 * New language support: Nyungar (nys).
 * New language support: Siberian Tatar [cебертатар] (sty).
 * New language support: Guianan Creole (gcr).
 * New language support: Kumyk [къумукъ] (kum).
 * New language support: Spanish formal address (es-formal).
 * New language support: Hungarian formal address (hu-formal).
 * New language support: Gorontalo (gor).

PHP7 or HHVM is now required
MediaWiki 1.31 requires PHP 7.0.0 or later. Although HHVM 3.18.5 or later is supported, it is generally advised to use PHP 7.0.0 or later for long term support.

Database changes
1.31 has several database changes since 1.30, and will not work without schema updates. PostgreSQL users now need version 9.2 or later.

Revision table
Note that due to changes to some very large tables like the revision table, the schema update may take quite long (minutes on a medium sized site, many hours on a large site). Don't forget to always back up your database before upgrading!

Archive table
If you're using MySQL, SQLite, or MSSQL, are not using update.php to apply schema changes, and cannot have downtime to run  and apply   manually, you'll have to apply a default value to the   and   columns of the   table or make those columns nullable before upgrading to MediaWiki 1.31. shows how to do this for MySQL.

Actor table
The identity of the logged-in or IP "actor" for logged actions is being moved into a new  table, with the rows in tables such as revision and logging referring to the actor ID instead of storing the user ID and name/IP in every row.


 * This is currently gated by . Most wikis can set this to  and run   as soon as any necessary extensions are updated.
 * Most code accessing rows for logged actions from the database should use the relevant  methods to get the information needed to build the SQL query. The   class may also be used to get feature-flagged information needed to access actor-related fields during the migration period.

See the  page for details.

Configuration changes

 * </> and <tvar|2></> are now deprecated and will be removed in a future version. The API is now considered to be stable, secure and essential.
 * <tvar|1></> was removed, as it is now the default. This was documented as a temporary variable during the migration period, deprecated since 1.29.
 * <tvar|1></> has been updated to support SVG images and uses <tvar|2></> where possible for fallback images such as PNG.
 * <tvar|1></> will no longer ignore '<tvar|2> </>' when user does not have the right to mark things patrolled.
 * Wikis that contain imported revisions or <tvar|1></> global blocks should run <tvar|2> </>.
 * The configuration settings <tvar|1></> and <tvar|2></>, deprecated since 1.27, were removed.
 * <tvar|1></> now supports having fallbacks for browsers that are not using the latest version of the Referrer Policy specification.
 * is now set to  by default. This is a first step of migration to human-readable section IDs that will later result in ' ' being the default mode.
 * now only supports APC(u) or WinCache. XCache support was removed as upstream is inactive and has no plans to move to PHP 7.
 * The old  feature, including its related configuration option, has been removed.
 * The ' ' value for is no longer supported for performance reasons, and installations with this setting will now work as if it was configured with ' '.
 * MediaWiki now defaults to using  to tidy up user input, rather than being off by default. If you wish to disable HTML tidying entirely, set  to  ; if you wish to use the old, deprecated Tidy external binary, both set  to   and  to.
 * now defaults to  instead of.
 * was removed and will be ignored.
 * , deprecated and ignored since 1.25, was removed. See the 1.25 release notes for more information.
 * is now marked as deprecated, just like the deprecated AJAX framework that it enables. Some extensions mistakenly used this to check whether any AJAX functionality at all should be enabled, further making this problematic to retain.
 * is now deprecated, and will be removed in a future version. It has been marked as experimental ever since it was introduced.
 * now affects all database types. Old MediaWiki versions were setting this to 'mediawiki' during the installer, which may cause errors during the upgrade when your database is not PostgreSQL or MSSQL. In that case, remove this setting from LocalSettings.php.

Action API changes in 1.31

 * The ' ' value to  for   has been removed. It has never made a difference in the output, the name was always returned regardless.
 * The ' ' and ' ' parameters for  have been removed. They were deprecated and also accidentally nonfunctional since 1.17 in 2010. Use ' ' instead.

Other changes in 1.31

 * Browser support for Internet Explorer 10 was lowered from Grade A to Grade C.
 * Browser support for Opera 12 and older was dropped entirely. Opera 15+ continues at Grade A.
 * Multi-content-revision capability was introduced into the storage layer. See <https://mediawiki.org/wiki/Requests_for_comment/Multi-Content_Revisions>.
 * The " " CSS class is now only applied to unbracketed URLs in wikitext. Links written using square brackets will get the class " ", not " ".
 * : Whitespace is trimmed from wikitext headings, wikitext list items, wikitext table captions, wikitext table headings, wikitext table cells. HTML headings, HTML list items, HTML table captions, HTML table headings, HTML table cells will not have this trimming behavior.