Help:Upgrade

Error produced by the upgrade and setup consistency check

Information status about the upgrade progress

Messages displayed to a user caused by an incomplete upgrade

Upgrading to Semantic MediaWiki 7.0.0Released on 4 June 2026 and compatible with MW 1.43.x - 1.46.x.? This release changes how Semantic MediaWiki is installed and configured: enableSemantics() is no longer required, configuration accepts plain strings instead of SMW_* constants, and install-state metadata moves into the database. Review the  7.0 migration guide and the  7.0.0 release notes for the full list of required actions before upgrading. Two operational steps are easy to miss: if you set configuration parameter $smwgNamespaceIndexSets the index of the first namespace to be used by Semantic MediaWiki you must replace it with define() calls before wfLoadExtension or the wiki will not boot, and if you use the full-text search you must run maintenance script "rebuildFulltextSearchTable.php"Allows to rebuild the full text search data table after upgrading.

An upgrade is understood as "the process of replacing a product with a newer version of the same product"1 and Semantic MediaWiki tries to provide a simple yet sufficient process to ensure that data consistency is ensured while new features are made available and for that reason the following changes were added with Semantic MediaWiki 3.0.0Released on 11 October 2018 and compatible with MW 1.27.0 - 1.31.x.2 and extended with Semantic MediaWiki 3.0.1Released on 25 January 2019 and compatible with MW 1.27.0 - 1.31.x.34:

Upgrade check

• The software is checking the consistency of its database schema during upgrades (and also at installation) using an upgrade key as well as other status information, e.g. for the completion of populating the hash fields for the object IDs5.
• If an update contains changes to the database schema (e.g. a new field, index, etc.), or if the content of related $smwgFixedProperties and/or $smwgPageSpecialProperties is altered then it is required to either run the update.php or alternatively Semantic MediaWiki's maintenance script "setupStore.php"Allows to set up the data backend/store.

How to upgrade?

• Upgrade from SMW 6.0.x to SMW 7.0.x (MW 1.43.0 to MW 1.46.x)
• Upgrade from SMW 5.0.x to SMW 6.0.x (MW 1.43.0 to MW 1.44.x)
• Upgrade from SMW 4.2.x to SMW 5.0.x (MW 1.39.0 to MW 1.43.x)
• Upgrade from SMW 4.1.x to SMW 4.2.x (MW 1.35.0 to MW 1.41.x)
• Upgrade from SMW 4.0.x to SMW 4.1.x (MW 1.35.0 to MW 1.39.x)
• Upgrade from SMW 3.2.x to SMW 4.0.x (MW 1.35.0 to MW 1.37.x)
• Upgrade from SMW 3.1.x to SMW 3.2.x (MW 1.31.0 to MW 1.35.x)
• Upgrade from SMW 3.0.x to SMW 3.1.x (MW 1.31.0 to MW 1.33.x)
• Upgrade from SMW 2.5.x to SMW 3.1.x (MW 1.31.0 to MW 1.33.x)
• Upgrade from SMW 2.5.x to SMW 3.0.x (MW 1.27.0 to MW 1.31.x)
• Upgrade from SMW 1.9.x or later to SMW 2.5.x (MW 1.25.0 to MW 1.30.x)
• Upgrade from SMW 1.9.x or later to SMW 2.1.x (MW 1.22.0 to MW 1.24.x)
• Upgrade from SMW 1.9.x or later to SMW 2.1.x (MW 1.19.0 to MW 1.21.x)
• Upgrade from SMW 1.8.x to SMW 1.9.x (MW 1.19.0 to MW 1.23.x)
• Upgrade from SMW 1.7.x or earlier

See also

• Upgrade and setup consistency check was introduce to validate the status of the database and settings that influence the "shape" of its tables and indices.
• Incomplete upgrade describes situation where an incomplete state requires additional intervention from an administrator
• Deprecation notices assist you on updating your wiki's configuration in the "LocalSettings.php" file according to the information provided.

Notes

As of Semantic MediaWiki 7.0.0Released on 4 June 2026 and compatible with MW 1.43.x - 1.46.x., Semantic MediaWiki stores setup and upgrade information in the smw_meta database table.6 It records the upgrade progress, the installation state in general, and any other changes that might appear during the life-cycle of the extension. If this information is missing or inconsistent, an error output will appear until it is regenerated by running the upgrade.

Earlier versions kept this information in a ".smw.json" file instead. When upgrading from such a version, the contents of the file are migrated into the smw_meta table on the first run of update.php, after which the file is renamed to ".smw.json.migrated".

Professional Support

• Professional Wiki provides MediaWiki upgrades and professional Semantic MediaWiki services.