Limitations

This page attempts to document the limitations of the MediaWiki software.

Per-page access restrictions
MediaWiki is not designed to be a Content Management System (CMS), or to protect sensitive data. To the contrary, it was designed to be as open as possible. Thus it does not inherently support full featured, air-tight protection of private content.

Branching page histories
If you are used to a version control system like Git, you may expect to be able to fork pages do some changes and then have other people pull these changes in. While MediaWiki does have a special page, such a workflow is generally not supported by MediaWiki. MediaWiki very much focuses on the wiki workflow, which revolves around immediate edits (although with the edits can be in a moderation queue).

Limitations addressed by extensions

 * MediaWiki templates aren't really suited for complex logic &rarr; allows templates to be programmed in

Extensions
MediaWiki is very extensible and many limitations of MediaWiki can be addressed by installing an extension.


 * While the special page lists all installed extensions in a wiki, if a wiki has many extensions, it can be hard to figure out for users which extension enables which feature.
 * Extensions generally do not underlie a central quality control.

Documentation
Documentation of extensions:


 * Extensions usually do not include their documentation, instead the documentation of extensions usually resides on mediawiki.org, which can be problematic when you want to use MediaWiki without an internet connection.

Documentation of the API:


 * The API documentation at https://doc.wikimedia.org/ is generally only available in English.

API stability
The various of MediaWiki are actively being developed and subject to change as per the following policies:



When deprecated functions get removed extensions and clients that use these functions generally have to be updated or they will break.

Specific technical limitations

 * have several limitations

Wikitext
Wikitext is notoriously difficult to parse to an abstract syntax tree because it has many intricacies. Since 2011 work is being done to replace MediaWiki's parser with a round-tripping parser in the form of the project.