Extension:Google AdSense

MediaWiki extensions manual
Google AdSense
Release status: unmaintained
Implementation Skin , Hook
Description Allows to add Google AdSense to the sidebar
Author(s) Siebrand Mazeland (Siebrandtalk)
Maintainer(s) Zoran Dori
Latest version 3.1.0 (2021-01-07)
MediaWiki 1.29+
PHP 7.0+
Database changes No
License MIT License

  • $wgGoogleAdSenseAnonOnly
  • $wgGoogleAdSenseClient
  • $wgGoogleAdSenseSlot
  • $wgGoogleAdSenseID
  • $wgGoogleAdSenseWidth
  • $wgGoogleAdSenseHeight
  • $wgGoogleAdSenseSrc
  • $wgGoogleAdSenseEncoding
  • $wgGoogleAdSenseLang
Translate the Google AdSense extension if it is available at translatewiki.net
Issues Open tasks · Report a bug

The Google AdSense extension allows to easily add Google AdSense advertisements to the sidebar of your wiki. This extension requires an account with Google's AdSense.


  • Download and move the extracted GoogleAdSense 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/GoogleAdSense
  • Add the following code at the bottom of your LocalSettings.php file:
    wfLoadExtension( 'GoogleAdSense' );
    // Replace this with your own publisher ID (google_ad_client / data-ad-client)
    $wgGoogleAdSenseClient = 'none'; // Client ID for your AdSense script (example: ca-pub-1234546403419693)
    // Replace this with your AdSense ad unit ID (google_ad_slot / data-ad-slot)
    $wgGoogleAdSenseSlot   = 'none'; // Slot ID for your AdSense script (example: 1234580893)

(You can get your "publisher ID" and "ad unit ID" from the "Get code" page.)

  • Add any of the optional settings below - if your settings deviate from the defaults:
// Width of the AdSense unit, specified in your AdSense account (google_ad_width / data-ad-width)
$wgGoogleAdSenseWidth = 120;

// Height of the AdSense unit, specified in your AdSense account (google_ad_height / data-ad-height)
$wgGoogleAdSenseHeight = 240;

// Source URL of the AdSense script. No need to change - it can't deviate from the defaults.
$wgGoogleAdSenseSrc = '//pagead2.googlesyndication.com/pagead/show_ads.js';

// Show the AdSense box only for anonymous users: true or false. Default is false.
$wgGoogleAdSenseAnonOnly = false;

// This can be anything you like. Default is 'none'.
$wgGoogleAdSenseID = 'none';

// Text coding. Default is 'utf8'.
$wgGoogleAdSenseEncoding = "utf8";

// Advertising language. Default is 'en'.
$wgGoogleAdSenseLang = "en";
  • If you want to add a "Text/image, 200x200" into the Vector skin you will need to shift the left panel over slightly. Add the following to the "MediaWiki:Vector.css" page
#footer {
    margin-left: 11em;
#left-navigation {
    left: 11em;
  • The default portlet label ("Advertisements") can be changed to "Sponsored Links" on the "MediaWiki:Googleadsense" page. Please note: no other variations are permitted[1].
  • Remember to disable ad-blocking services such as AdBlock when you want to see if the extension is working!
  •   Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

If you encounter an HTTP 500 error, replace "wfLoadExtension( 'GoogleAdSense' );" with "require_once "$IP/extensions/GoogleAdSense/GoogleAdSense.php";".

See also



  1. AdSense Help: Ad placement policies: Placing ads under a misleading header