MediaWiki extensions manual
Release status: beta
Description Adds the Disqus commenting service at bottom of each page
Author(s) Michael Platzertalk
Maintainer(s) Sophivorus
Latest version 1.0 (2022-01-18)
MediaWiki 1.25+
License GNU General Public License 3.0 or later
  • $wgPageDisqusNamespaceWhitelist
  • $wgPageDisqusCategoryWhitelist
  • $wgPageDisqusShortname
  • $wgPageDisqusPageBlacklist
  • $wgPageDisqusPageWhitelist
  • $wgPageDisqusCategoryBlacklist
  • $wgPageDisqusNamespaceBlacklist
Quarterly downloads 1 (Ranked 131st)
Translate the PageDisqus extension if it is available at translatewiki.net

The PageDisqus extension automatically integrates the Disqus commenting service to every page, right after the content area.


  • Download and move the extracted PageDisqus folder to your extensions/ directory.
    Developers and code contributors should install the extension from Git instead, using:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/PageDisqus
  • Add the following code at the bottom of your LocalSettings.php file:
    wfLoadExtension( 'PageDisqus' );
    $wgPageDisqusShortname = 'your-disqus-shortname';
  •   Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.


  • $wgPageDisqusShortname - Required! The Disqus shortname for your site. This is the identifier (or the hostname) you specify when entering your unique Disqus URL.

By default, Disqus will be shown in every page. However, you can control this with the following configuration options:

  • $wgPageDisqusPageWhitelist = [ 'Foo', 'Bar', 'Baz' ]; - Only show in these pages
  • $wgPageDisqusPageBlacklist = [ 'Main Page' ]; - Don't show in these pages
  • $wgPageDisqusCategoryWhitelist = [ 'Controversial', 'New' ]; - Only show in these categories
  • $wgPageDisqusCategoryBlacklist = [ 'War', 'Sex' ]; - Don't show in these categories
  • $wgPageDisqusNamespaceWhitelist = [ NS_MAIN, NS_HELP ]; - Only show in these namespaces
  • $wgPageDisqusNamespaceBlacklist = [ NS_TEMPLATE, NS_MEDIAWIKI ]; - Don't show in these namespaces

See also