Search with Google


This plugin will replace the WordPress default search query with server-side results from either the Custom Search Site Restricted JSON API or the Custom Search JSON API. You can make your selection within the settings > Reading > Search type. This replacement is done on the WordPress back-end, so results appear as normal within WordPress search.


  1. Google API Key
  2. Programmable Search engine ID


  1. Get Google API key. An API key is a way to identify your client to Google.
  2. Get Programmable Search engine ID. In Google settings, restrict the Search engine to only search for your one site.
  3. On WordPress dashboard, set API Key and Custom Search Engine ID in the plugin settings. Dashboard > Settings > Reading > Search with Google Settings.
  4. Select the search type from Custom Search Site Restricted JSON API or Custom Search API. (Refer Notes section for more details)


  1. Custom Search Site Restricted JSON API can show only 100 search results for the query.
  2. A result page can have maximum of 10 results.
  3. Assistance for Custom Site Restricted Search JSON API is scheduled to cease as of December 18, 2024. Read more. Due to this modification, we are introducing an opt-in feature that enables the use of solely the Custom Search API, as opposed to the Custom Site-restricted Search API. This will allow you to continue using the Custom Search API after December 18, 2024.

BTW, We’re Hiring!

Join us at rtCamp, we specialize in providing high performance enterprise WordPress solutions


  1. Upload plugin-name.php to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Follow “Setup” instructions in ReadMe to configure credentials from Google Developers Console.


Reporting a bug 🐞

Before creating a new issue, do browse through the existing issues for resolution or upcoming fixes.

If you still need to log an issue, making sure to include as much detail as you can, including clear steps to reproduce the issue, if possible.

Creating a pull request

Want to contribute a new feature? Start a conversation by logging an issue.

Once you’re ready to send a pull request, please run through the following checklist:

  1. Browse through the existing issues for anything related to what you want to work on. If you don’t find any related issues, open a new one.

  2. Fork this repository.

  3. Create a branch from develop for each issue you’d like to address and commit your changes.

  4. Push the code changes from your local clone to your fork.

  5. Open a pull request and that’s it! We’ll respond with feedback as soon as possible (Isn’t collaboration a great thing? 😌)

  6. Once your pull request has passed final code review and tests, it will be merged into develop and be in the pipeline for the next release. Props to you! 🎉


June 7, 2023
This plugin does not work and never could have, since the only file is just a placeholder. A total waste of time. It should be removed from the repository immediately!
July 9, 2021
Provided you know how to get your API Key and Search engine ID from Google, this couldn’t be easier to set up. Compare results with the results in the “Public URL” page at with the plugin switched on or off, and if your site is well SEO-optimised, you’ll see much better results with it switched on and properly configured.
December 8, 2020
Doesn’t know whether this plugin works after installation and no support.
Read all 3 reviews

Contributors & Developers

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


“Search with Google” has been translated into 1 locale. Thank you to the translators for their contributions.

Translate “Search with Google” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • Compatible with WordPress 6.4.2
  • Updated PHP code to be compatible with PHP 8.2
  • Fixed WordPress coding standards issues
  • Used VIP compatible code for WordPress VIP compatibility
  • Added support for the Custom JSON API
  • Added Deprecation notice for the Custom site-restricted JSON API


  • Initial release.