MediaWiki extensions manual
OOjs UI icon advanced-invert.svg
Release status: stable
Implementation User rights
Description Allows to override per page permissions based on a whitelist
Author(s) WikiWorks team
Maintainer(s) WikiTeq team
Compatibility policy Follows the MediaWiki version lifecycle. Master is not backward compatible.
MediaWiki 1.31+
License GNU General Public License 2.0 or later
  • $wgGroupWhitelistSourcePage
  • $wgGroupWhitelistAPIAllow
  • $wgGroupWhitelistRights
  • $wgGroupWhitelistGroup
Translate the GroupWhitelist extension if it is available at translatewiki.net

Check usage and version matrix.

The extension allows to grant users from selected group with a special per-page rights specifying affected pages list on a regular wiki page.

This extension was created for WikiWorks.


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

Configuration parametersEdit

  • $wgGroupWhitelistRights - A list of actions to be allowed
  • $wgGroupWhitelistGroup - A group affected by the extension
  • $wgGroupWhitelistSourcePage - A page to look for list of whitelisted pages
  • $wgGroupWhitelistAPIAllow - API modules to be always granted with the right

The default configuration is:

$wgGroupWhitelistRights = [ 'edit' ];
$wgGroupWhitelistGroup = 'user';
$wgGroupWhitelistSourcePage = 'Mediawiki:Whitelist';
$wgGroupWhitelistAPIAllow = [];

and the Mediawiki:Whitelist contents could be:

* SomePage1
// Comments are allowed
* SomePage2
* SomaPage3

The settings above allow users from a `user` group to `edit` pages specified in the `Mediawiki:Whitelist` page contents (`SomePage1`, `SomePage2`, `SomePage3`).

See alsoEdit

  This extension is professionally maintained by the WikiTeq team.