Implement Google Custom Search into WordPress

By MildTheme
In Tutorial
May 12th, 2012


WordPress has a search function which has developers opinions split. We shows us how to replace the search function with a super powered Google Custom Search engine.

WordPress and its search function – this is a subject that often splits the most hardcore WordPress users. Terms like “abysmal” are frequently banded about among developers, I personally defend it… to a certain level.

For smaller sites the search function does its job successfully, it’s no frills and does what it says on the tin, but for larger sites it can be like taking a spoon to a bazooka fight. So today I plan to show you how to integrate Google Custom Search into your WordPress install and harness the raw power of the world’s most powerful search solution.

Before we get into the nitty gritty I wanted to briefly cover something that has come up as an issue (of sorts) for me while replacing the search function. As we all know Google Custom Search will use Google results for your site so we need to ensure Google has good access to our content, so installing the Google XML Sitemap plugin will assist in Google’s indexing quest. The other point of note is due to the way WordPress archives work, Google may index multiple versions of your posts so you could in effect have several versions of the same article competing in your own search results, so to combat this I opted to use the All In One SEO Pack plug-in and set it up so only single posts would appear.

Not only will using these (or similar) plug-ins help your custom search work more efficiently; it’s also good SEO practice and could help you climb up those pages!

Now we can move onto the part you have been patiently waiting for, the actual implementation of Google Custom Search into WordPress.

Creating a custom search engine

First thing first, we need to visit Google Custom Search and set up our search engine. Follow this link: and you will be taken to the Google Custom Search page were you can create or manage your search engines.


We need to give our search engine a name, description and define its primary language, then we need to give it a list of sites to search, so in our case it would just be our site.

You then need to select an edition, there is an ad supported free version or, for the more financially blessed among us, we can go for the paid version and wave goodbye to those ads.


At this point Google Custom Search offers little in the way of customisation, but does offer a few themes and layouts we can use and hopefully one of those will work on our WordPress install.


The final step over at Google is to grab our code for our custom search engine, Google recommends using a supported Doc Type such as <!DOCTYPE html> in your pages as the custom search uses some CSS hover effects.

Below our code Google also offers some further options that you can use to customise the custom search a little further, which in this case we will need to do.


Hit the change the look and feel link and you will be presented with some layout and style options. We will need to use the Results only layout as we will be using our own search box. Tthe style is totally up to you. Once that is done, hit the Save & Get Code button and we can then finish this part off by grabbing our code.


You will need to specify your site details such as HTTP/HTTPS and specify the search result details – we should use “q”, which is the default Google search query parameter.

Our code is now ready to use in our WordPress install, so keep it in a safe place for the time being.

Building the results page

To get the custom search in place of WordPress’ in built search function we are going to use a custom page template (you can read more about these here:

At the beginning of a custom page template you must define your custom page name so it can be used by WordPress, so we will name our template googlesearch.php and place this at the top of our custom page:

Template Name: Google Search

The file name and template name can of course be altered and named to anything you wish.

Once that is in place, you can continue to build the rest of your page. For this tutorial I will be using the TwentyEleven theme and using the page.php as a base to work from, which looks a little something like this:

 * The template for displaying all pages.
 * This is the template that displays all pages by default.
 * Please note that this is the WordPress construct of pages
 * and that other 'pages' on your WordPress site will use a
 * different template.
 * @package WordPress
 * @subpackage Twenty_Eleven
 * @since Twenty Eleven 1.0

get_header(); ?>

    <div id="primary">
       <div id="content" role="main">

          <?php while ( have_posts() ) : the_post(); ?>

            <?php get_template_part( 'content', 'page' ); ?>

              <?php comments_template( '', true ); ?>

                <?php endwhile; // end of the loop. ?>

            </div><!-- #content -->
      </div><!-- #primary -->

<?php get_footer(); ?>

That gives us our base to work with, but we need to add the code from Google and remove the things we don’t need from the standard page template.

We don’t need the content or comments part so they can be removed, and then you can add your search code so you end up with something like this:

Template Name: Google Search

<?php get_header(); ?>

        <div id="primary">
             <div id="content" role="main">

            <?php while ( have_posts() ) : the_post(); ?>

<div id="cse" style="width: 100%;">Loading</div>
<script src="" type="text/javascript"></script>
<script type="text/javascript">
  function parseQueryFromUrl () {
    var queryParamName = "q";
    var search =;
    var parts = search.split('&');
    for (var i = 0; i < parts.length; i++) {
      var keyvaluepair = parts[i].split('=');
      if (decodeURIComponent(keyvaluepair[0]) == queryParamName) {
        return decodeURIComponent(keyvaluepair[1].replace(/\+/g, ' '));
    return '';

  google.load('search', '1', {language : 'en', style : google.loader.themes.MINIMALIST});
  google.setOnLoadCallback(function() {
    var customSearchControl = new

    var options = new;
    customSearchControl.draw('cse', options);
    var queryFromUrl = parseQueryFromUrl();
    if (queryFromUrl) {
  }, true);

          <?php endwhile; // end of the loop. ?>

        </div><!-- #content -->
    </div><!-- #primary -->

<?php get_footer(); ?>

*Notice the code is used inside the loop (

We can now upload that new file which I have called googlesearch.php to our theme folder.

Creating the search page

Now the bulk of the code is done we need to create a new page through the WordPress wp-admin, I have called my page “Search Results.”


You will see my page has no content as Google will supply that for us, but the main thing we need to do here is change the template to our custom page template. In this case we need to select the Google Search template from the drop down on the right. Once we have done that hit Publish.


We will also need to alter one other snippet of code. In searchform.php we need to alter the name field from s to q. Once that has been changed we’re ready to go.

Tweaking our custom search engine

If all goes well, we now have a custom search engine that displays our WordPress’ results on our search-results page.

You might notice when you hit a link from your results page, it opens in a new window which is not ideal, so if we want to change this, we can add an extra snippet to our googlesearch.php page:

If we add:


between the following:

var options = new;

so we get this:

    var options = new;

Your search results will now open in the same window, which in most cases will be the desired result.


Google offers further steps for customisation, such as applying your own stylesheet and using image search with your results but I will allow you to dig into those in further depth at your leisure.


While this is a solution that will favour many, it does have a few downsides. New posts might take a few days to get indexed and results can change, so popular pages might rank higher than newer articles and so on… That being said if you are managing a content heavy site and the inbuilt search feature doesn’t cut the mustard, this is probably right up your street.

between the following:

16 Responses to “Implement Google Custom Search into WordPress”

  1. Thomas says:

    I’ve tested with “twentyeleven” child-theme but it does not work. I write in the search-form and press “enter” key, then open page and appears white – no search results. I can see “loading ….” for 2 seconds and then page is white. I’ve followed all your instructions exactly. I’ve checked several times. my code is identical to your instructions. But it does not work. Can you give me help?

    • MildTheme says:

      more in short, you can just insert the javascript code into the if you are still confused, then I will postingkan articles related to it.

  2. Thomas says:

    I’ve done. Now I have this situation. Write a keyword in the search form, press “enter”, the page with search results will open. But no content. The page opens in size than when the display content, but the page is white. it is very difficult to move Google cse work properly. Do you have a new idea?

    • MildTheme says:

      please try to check at the time of selecting the display, and make sure that the url that you enter is correct.

  3. Suzie Chaberek says:

    The Metabolism claims, “Freedom Involving religion”, Not necessarily “freedom By faith

  4. Gerri Svatos says:

    I lost $ 100 at google adwords and get nothing.

  5. Online Marketing Boston says:

    “this is truly an exciting and informative gear consciousness published now, I might not ensue bowled over to distinguish the changed sort of reactions from peoples as approximately possibly will like it and approximately don’t

  6. True Religion Jeans Men says:

    I enjoyed scaning the nice website. I see you are offering priceless information. stumbled into this website by accident but I’m sure glad My spouse and i clicked on that will link. You certainly answered the questions I’ve been dying to answer for some time now. Will certainly come back for additional of this.

  7. crysis sony vgn says:

    I string Savory Spices on Twitter (as picatasi)

  8. Monster Beats Headphones says:

    A lot of of what you say is astonishingly legitimate knowning that makes myself wonder precisely why I had not looked at this particular in this lighting before. This kind of article truly did move the light in for me so far as this particular subject goes. However at this time there is certainly one particular matter I am not always too confident with and whilst I make an effort to get back that with the central concept of your position, let me notice exactly what the remaining subscribers have to point out .Well done.

  9. Ironman says:

    what a brilliant website thanks for the information in this article

  10. backlink building says:

    This is a comment to the webmaster. Does your website get enough visitors or rank for search terms with Google? Well we can help! We can provide you with tens of thousands of backlinks to your site! This will help your rankings in the search engines and make your website more visible to your target audience. Take a quick look as I am sure you will be interested.

  11. LV Bags Outlet says:

    Thanks for the great writeup. It in reality was once the entertainment bank account it. Look complex in order to more included agreeable by you! However, how can we be in contact?

  12. Denise says:

    This is a message to the webmaster. I came to your “How to Implement Google Custom Search into WordPress | MildTheme – Download WordPress Themes and WordPress Templates” page via Google but it was difficult to find as you were not on the front page of search results. I see you could have more traffic because there are not many comments on your site yet. I have found a website which offers to dramatically increase your rankings and traffic to your site: I managed to get close to 1000 visitors/day using their services, you could also get lot more targeted traffic than you have now. I used their services and got significantly more visitors to my website. Hope this helps :) Take care.

  13. Free ENuke X Crack says:

    It is really a nice and useful piece of info. I am satisfied that you just shared this helpful info with us. Please stay us informed like this. Thank you for sharing.

  14. Tyson F. Gautreaux says:

    Me gustó mucho leer tu blog …. Gracias por tomarse el tiempo para escribir!

facebook comments: