MediaWiki extensions manual
Release status: stable
Implementation ContentHandler , Tag
Description Allows creating machine-readable navigation templates
Latest version 2.0.0
MediaWiki 1.34+
PHP >= 7.4
Database changes No
License MIT License
  • $wgStructuredNavigationEnableExperimentalAPI
  • $wgStructuredNavigationReservedUsername
Quarterly downloads 1 (Ranked 159th)
Translate the StructuredNavigation extension if it is available at translatewiki.net

The StructuredNavigation extension allows users to create machine-readable navigation templates.

Installation edit

  • Download and place the file(s) in a directory called StructuredNavigation in your extensions/ folder.
  • Only when installing from Git, run Composer to install PHP dependencies, by issuing composer install --no-dev in the extension directory. (See task T173141 for potential complications.)
  • Add the following code at the bottom of your LocalSettings.php file:
    wfLoadExtension( 'StructuredNavigation' );
  •   Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Usage edit

You can play with an example in /docs/examples (from the source code repository). For this example, let's try using wikipedia-en-dontnod-entertainment.json.

  1. Create a new page at Navigation:Dontnod Entertainment, import the JSON into that page, then save your edit.
  2. At a separate wikitext page, add <mw-navigation title="Dontnod Entertainment"> and press save.

TemplateStyle integration and customization edit


Example of style.css: edit

.mw-structurednav-navigation-container {
	background: transparent;
	border: none;
.mw-structurednav-header {
	background: transparent;
	font-weight: bold;
.mw-structurednav-header-title {
.mw-structurednav-groups-container {
	background: transparent;
.mw-structurednav-group {
	background: transparent;
.mw-structurednav-group-title {
	background: transparent;
	color: #a3a3c2;
	border: none;
	font-weight: bold;
	font-size: 1.25em; 
    vertical-align: text-top;
.mw-structurednav-group-content-list {
.mw-structurednav-group-content-item {
    vertical-align: text-top;

History edit

In December 2018, I thought that creating navigations were annoying, especially considering every wiki had a different way of creating those navigations. This resulted in me creating the StructuredNavigation extension. However, there are some pitfalls:

This extension is still stable and currently works. Please note that this extension is free and open source, and I only work on this extension when I have free time. However, if you like this extension and enjoy using it, or have any feedback, please let me know and post them on the discussion page. Thank you!