Product support

Visit this product's website for support.


  • Miscellaneous
  • Utility

To use this plugin you need setup a Custom Search Engine (see the documentation) and an API key at at Google.


Please use GitHub Issues to report any issues with this plugin.

Reviews should not be used for getting support or reporting bugs, if you need support please use the Plugin support link.



Here is the default template, you can format it any way you like.

<h1>{{ totalResults }} Results for {{search}}</h1>
{% if results %}
    {% for result in results %}
        <h3><a href="{{ result.link }}">{{ result.htmlTitle|raw }}</a></h3>
        {{ result.htmlSnippet|raw }}
    {% endfor %}
{{ results.render|raw }}
{% endif %}

You can embed this search in your site. Add the CustomGoogleSearch component


Name Page variable Description
Search {% component 'searchResults' %} Outputs the search form


Property Description Default Value
apikey Google API Key -
cx Custom search engine id format 1232342342344:xxxxxx
resultPerPage Result per page 10


You need also to create a form to send the request to the display page.

<form action="{{ 'your_search_page' | page }}" method="get">
    <div class="search">
    <input name="q" type="text"/>
    <input type="submit" value="Search">

The search field muss have q as name.


Search engine ID

By calling the API user issues requests against an existing instance of a Custom Search Engine. Therefore, before using the API, you need to create one in the Control Panel . Follow the tutorial to learn more about different configuration options. You can find the engine's ID in the Setup > Basics > Details section of the Control Panel.

API key

Custom Search API requires the use of an API key. You need to fill it in the settings of your site. Custom Search Engine (free edition) users can obtain the key from the Google API Console . The API provides 100 search queries per day for free. If you need more, you may sign up for billing in the API Console. Additional requests cost $5 per 1000 queries, up to 10k queries per day.


Fix for Laravel 5.5 (OctoberCMS build 420 and higher)

Jul 31, 2017


Add http referer to restrict api key access

Mar 06, 2017


Initialize plugin.

Jan 16, 2017