This plugin hasn’t been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

Google XML Site Search


This plugin provides search functionality for your WordPress installation, through Google Site Search (aka Google Custom Search). It uses Google’s XML API, and thus requires an account that has access to it (ie you need to pay for it).

The plugin hooks in to the standard WordPress search form, so there is no need to change it (standard search widgets etc will still work). The plugin provides a basic template for the search results, but you can easily make your own if you wish to customize the output.

  • Read more about Google Custom Search here:
  • Read more about the XML API here:

This plugin is not developed or endorsed by Google.


If you wish to customize the search result page, create a template named ‘google-custom-search.php’ in your theme. Refer to the plugin’s ‘default-template.php’ for available template functions. The functions mimic the way that The Loop works, so it should feel familiar.

For advanced users who want even more control of the output of the plugin, it is also possible to transform the response from the XML API with an XSLT style sheet. To do this, create a file called ‘google-custom-search.xsl’ in your theme. Please refer to Google’s documentation for the XML API ( for the format of the response.

If you have a custom search form, you need to change the name-attribute of your search field to “gcs” (ie name=”gcs”) and make sure that the form action is set to the root of your site. Otherwise the search query will not be handled by this plugin.


  • Settings for the plugin.


  1. Upload the folder ‘google-xml-site-search’ to the ‘/wp-content/plugins/’ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Specify your Search Engine Unique ID through ‘Settings’ -> ‘Google XML Site Search’
  4. Done!

If you wish to customize the output or the layout of the search page, keep reading under “Customizing”


Where do I find the Search Engine Unique ID?

You can find it in the Google Custom Search control panel for your search engine. Log in here:

I have a Google Custom Search account, can I use this plugin?

To have access to the XML API you currently need a paid Google Custom Search account. If you have one, this plugin is for you!

Contributors & Developers

“Google XML Site Search” is open source software. The following people have contributed to this plugin.



1.1 (2012-08-27)

  • Fixed a bug that made the plugin not work in some (possibly all) cases. Sorry about that.
  • Added localized Next/Previuos links in the default navigation HTML. Swedish translation is included in the plugin.
  • Fixed some deprecated syntax that caused errors with newer versions of PHP

1.0 (2012-08-23)

  • The initial version of this plugin