Control Panel

Stay organized with collections Save and categorize content based on your preferences.

This page explains configuration options for your engine and gives you a tour of the Control Panel.

Creating a Programmable Search Engine

The easiest way to get started with Programmable Search Engine is to create a basic search engine using the Control Panel. If you haven't done that before, follow the tutorial.

When you created your search engine, two sets of code were generated:


<CustomSearchEngine id="_6zdjrkhn3a" creator="001058780666577659641" volunteers="false"
keywords="" visible="false" encoding="UTF-8">
   <Title>Hello World</Title>
   <Description>Experimental search engine</Description>
       <Label name="_cse_id" mode="FILTER"/>
       <Label name="_cse_exclude_id" mode="ELIMINATE"/>



     <Annotation about="*" score="1">
       <Label name="_cse_id"/>

The more advanced sections of the developer's guide will walk you through the XML format. In the meantime, you can just skim through it. If you are curious about the code for your search engine, you can go to the control panel and click the Advanced tab. The next section tells you about the control panel and all the tabs.

Back to top

Managing Your Search Engine

You manage your Programmable Search Engines in the My search engines page and define the search engine specifications in the control panel.

Getting to Know the My Search Engines Page

You can create more than one search engine under your Google account. The search engines do not have to be related to each other. You can view, manage, and delete them in the My search engines page.

The My search engine page includes the following components:

  • Control panel - The administrative console for your search engine. Each search engine has its own control panel.
  • Statistics - The dashboard that shows the number of queries processed by your search engine. If enough users are using the same search terms, you will be able to see the most popular queries for your search engine. You can use this data to fine-tune your search engine.
  • Delete - Permanently delete the search engine.

Touring the Control Panel

After you create a Programmable Search Engine, you can use the control panel to modify it. You can access the control panel from the My search engines page.

This section describes the following tabs in the control panel:

Back to top


The Basics tab let you define public information and general settings about your search engine. The public information is displayed in your Programmable Search Engine homepage.

Warning: If you want to keep the changes you make in the Basics tab, click Update before you move on to the next tab; otherwise, you will lose all your modifications.

  • Search engine name - Descriptive name that could give people ideas about the type of search engine you are building. Short and descriptive names work well. Do not use a name that would violate other people's trademark.

    The name appears on your Programmable Search Engine homepage that Google hosts and the search results page that Google serves.

  • Search engine description - Brief information about your Programmable Search Engine, such as what it searches and who might be interested in using it. Be succinct, and don't repeat information. For example, if your search engine name is "Badminton Search Engine", do not describe it as "search engine for badminton". Don't just jot down a description in a hurry, because users who are looking for a specific Programmable Search Engine might be frustrated if they encounter search engines that don't work as described or have descriptions that are too vague.

    The description appears on your Programmable Search Engine homepage and results page.

  • Search engine keywords - Optional. Keywords are a quick way of boosting certain webpages in your search results and getting more search results about the subject. You can add as many keywords as you want, as long as you don't exceed 100 characters. List words or phrases—which are a short series of words enclosed in quotation marks (for example, "mountain bike")—that describe the content of the webpages or the coverage of your search engine. While Programmable Search Engine boosts results that contain those keywords, it does not demote or filter out results that don't contain the keywords.

    When you are in the early stages of defining your search engine, you can skip this setting. Later, when you are fine-tuning results, you can define keywords. For more information, see Changing the Ranking of Your Search Results page.

  • Edition - Whether your engine is "Free, with ads." or "Nonprofit, ads optional.".

    You can click the Get code button to get the html snippet to show your engine on a web page.

  • Search engine ID - The id of your engine. Also known as cx.

    You can click the Copy to clipboard button to copy your engine id.

  • Public URL A link to a Google hosted public page for your engine.
  • Image search Enable/disable image search for your search engine.
  • SafeSearch Enable/disable SafeSearch for your search engine.
  • Region Customize search results based on selected region.
  • Language The language of the interface of the search engine, such as the search box button or page layout. It also boosts results in that language, but it does not keep results in other languages from appearing in the results page.

    Click on Advance to configure "Search engine encoding".

    For example, if you selected Chinese as your search engine language, Chinese webpages will be given higher priority than English webpages in the search results.

  • Sites to search

    This section lets you tell Programmable Search Engine which sites to search. A site can be an exact or complete URL for a single page (such as or a URL pattern (such as **). For more examples of URL patterns, see the Help Center topic on URL patterns.

    To include sites in your search engine, click Add to include sites under the Sites to search section; to exclude sites from your search engine, click Advance under Sites to search and add the sites to be excluded under Sites to exclude section. Once you've added at least one site to include in or exclude from your search engine, a menu bar with Add Sites and Delete buttons appear right above your list of sites.

    If you have a lot of sites to add, you can add them in bulk by clicking Add Sites, and then clicking the Include sites in bulk link at the top of the dialog box. To remove sites from Programmable Search Engine, simply select the check box next to the site and click Delete.

    You can list up to 5,000 sites for a single Programmable Search Engine.

    Including or Excluding Sites from Your Search Engine

    When you add a site, a dialog box with the following fields appears:

    • URL - Enter the site that you want Programmable Search Engine to crawl. If you enter the URL of a specific page without the subdomain (the www in, Programmable Search Engine automatically searches all the subdomains of the site. If has the subdomains, www, store, and home, Programmable Search Engine searches for, , and So you do not need to add each subdomain.

      If you use a URL pattern with wild cards (*), you can skip the next field and just click Save Changes; the control panel automatically selects the correct What to include option for you.

    • What to include - determines how extensively you want Programmable Search Engine to search the site. For example, you can have Programmable Search Engine search just the site you defined in the URL text box, or you can have Programmable Search Engine also search other webpages linked from the site. It includes the following options:
      • Include all pages whose address contains this URL - Programmable Search Engine also searches subdirectories and subpages of the site you defined in the URL text box. For example, if you defined your site as, Programmable Search Engine automatically includes every URL that begins with You do not need to recursively add the URL for subdirectories and subpages.
      • Include just this specific page or URL pattern I have entered - Programmable Search Engine searches only the specific webpage or URL pattern you have defined. It is the most restrictive option, because it instructs Programmable Search Engine to follow your URL pattern exactly.

    Viewing List of Sites

    You can view twenty sites at a time. If you have a lot of sites, click the Filter button and use the URL contains text box to view only URL patterns you want to see. When you are done searching for a specific site, you can click Clear Filter to see all your sites again.

    Tagging Sites with Labels

    If you have created refinement labels in the Refinements tab under Search features, you can apply labels on sites by selecting their check boxes, then selecting the label from the Label actions drop-down list in the menu bar, which is above the list of sites.

  • Search the entire web Whether or not to augment your results with general Web Search results.
  • Programmatic Access Links to document about how to use the Custom Search JSON APIs.
  • Restrict Pages using Knowledge Graph Entities Enable Knowledge Graph Entity restricts for your search engine.
  • Restrict Pages using Types Enable type restricts for your search engine.

Back to top

You can go to Search features > Advanced tab to manage your advanced search controls. See what you can control here.


Manage your refinements at Control Panel > Search features > Refinements tab.

Refinements are a way for you to categorize sites by topics. For example, if you have a bicycling search engine, you can have categories of, say, bike maintenance, bike reviews, bike stores, biking skills, and so on and so forth. You can create refinement labels that you associate with the sites you listed in the Sites tab. The refinement links appear at the top of your search results page, and users can click them to narrow down their searches. A search page can have as many as 16 refinement links.

To create a refinement label, click Add Refinement, and define the settings. To tag websites with labels, go to the Sites tab, select check boxes next to the sites, and select the label from the Label actions drop-down list. You can tag sites with more than one label.

Back to top


Manage your promotions at Control Panel > Search features > Promotions tab.

The Promotions tab lets you create promotions that appear at the top of the results page and define search terms for triggering the results. For example, if you want users who are searching for "cool stuff" to discover your latest widget, you can create a promotion result that would show a link to the webpage about the widget.

You can create a promotion by clicking Add and defining the queries that would trigger the promotion, as well as the content of the promotion. The content includes a title, description, image, and the URL of the webpage. The description and the image, which are optional, are not displayed automatically. You must change the setting to activate that feature.

To display the optional description and image in your promotion, do the following:

  1. Click the Promotion Design Settings button on the right.
  2. Select the checkboxes to allow the inclusion of a brief description and an image for each promotion.
  3. Click OK.

To create content for the description or add an image, do the following:

  1. Add or edit a promotion.
  2. Fill out a description and add a link to an image. These additional fields are optional and do not need to be filled out.

To delete promotions, select the checkboxes next to the promotions you want to remove, and click Delete.

To change the appearance—such as the border, text, and background color—of all the promotion results, go the Look and Feel tab, which is described in detail in the Designing the Look and Feel with the Control Panel.

If you want to create a lot of promotions, create an XML file instead. To learn more about the XML format, see the Creating Promotions page. To upload the XML file you created, click Upload and select the file.

Back to top


Manage your synonyms at Control Panel > Search features > Synonyms tab.

You can expand your users' search queries by using synonyms, which are variants of a search term. For example, the search query,"food", could have the following alternatives: "meal", "chow", "cooking", and so on. If you create synonyms for "food" in your search engine, your users would not need to type multiple variants to find information they are seeking. The Programmable Search Engine automatically searches for all sites that are relevant to "food", "meal", "chow","cooking", and other related terms. For recommendations on the types of synonyms to create, see the Improving User Queries for More Relevant Results page.

The Synonyms tab let you create synonyms for specific search terms.

To create a synonym, click Add and define the search terms that would trigger the synonym expansion. To delete a synonym, select the checkboxes next to the synonyms you want to remove, and click Delete.

If you want to add a lot of synonyms, create an XML file instead, and use the Synonyms page to upload the file. To upload the XML file you created, click Upload and select the file.

Back to top


Manage your autocompletions at Control Panel > Search features > Autocompletions tab.

Autocompletion offers query options to your users as they enter their search queries on your search box. It is similar to the optional queries that you see on Google search. For example, if the user wants to search for "monkeys" and start typing the characters for the word, the Programmable Search Engine search box shows a drop-down list with possible query options. As the user types more characters, the list of possible query options changes to match the new set of characters. To see how this works, start typing a query on Google Search.

The Autocompletions section lets you enable the autocompletions feature, enable autocompletions from the entire web, add custom entries, and remove entries from the standard query options.

Include autocompletions from the entire web allows the autocompletions generated for your search engine to be supplemented with a larger corpus of uncustomized autocompletions. Note: When Include autocompletions from the entire web is enabled, Excluded autocompletions are ignored.

The Custom Autocompletions section has the following tabs that let you customize your autocompletion terms.

  • Included Autocompletions - lets you add custom query options to the search box drop-down. These words are shown above the automatically generated autocompletions.
  • Excluded Autocompletions - lets you remove specific terms from automatically generated autocompletions. For example, if you do not want "bananas" to ever be offered as an optional query, you can exclude it.
  • Excluded Patterns - lets you exclude a collection of autocompletions with regular expression. For more information about regular expressions, see the glossary. Terms that match the regular expressions are excluded from the automatically generated optional queries.

On each tab the Add button is used to enter the term or regular expression, one entry per line. If you want to add a lot of autocompletions, create an XML file instead, click Upload and select the file.

For more information, see see the Improving User Queries for More Relevant Results and Designing the Look and Feel with the Control Panel pages.

Back to top

Look and feel

If you have your own website, you can change the design of your search box and customize the style of the search results page to match the look and feel of your website.

You can select one of the predefined themes that broadly matches the look and feel of your website. If the standard themes are not quite what you want, you can make further changes.

To keep the changes you made, click Save before you move on to the next tab; otherwise, you would lose all your modifications.

For more information, see the Designing the Look and Feel page.

Get Code

After you specify the look and feel for your search box and search results pages in the Look and feel section, you can copy the generated code by clicking on the Save & Get Code button and insert code in your webpages.

Back to top


Manage your AdSense configuration at Setup > Ads tab.

Make money with your Programmable Search Engine by connecting it to your Google AdSense account. When users click on an ad in your search results, you get a share of the ad revenue. To learn more about connecting your search engine to AdSense, see this Help Center article for Programmable Search Engine.

Once you've connected your Programmable Search Engine to your AdSense account, you can manage custom channels for your search engines. To learn more about managing custom channels, see this Help Center article for Programmable Search Engine.

Back to top


Select Setup in the left sidebar, then go to the Advanced tab.

When you've outgrown the control panel and want to start tinkering with the advanced features, you should consider using the Programmable Search Engine context and annotations files. The context file is in XML format, while the annotations file can be in OPML, TSV, or Programmable Search XML format. Don't be intimidated if none of these terms sound familiar to you; the rest of the developer guide discusses them and shows you what you can do with the advanced tools.


Adding an administrative account will allow collaborators to add sites, refinements, promotions, and more. For more information, see Admin Accounts page.

Back to top


When you tweak your search engine, you can test the changes by clicking on the "Public URL" link from Setup > Basics > Public URL.

Statistics and Logs

The Statistics and Logs section on the sidebar displays the top queries over time for your search engine. You can use this data to fine-tune your search engine.

Google Analytics : If you are hosting your search results on your site, you can get enhanced reporting through Google Analytics site search reporting.

Audit Logs : Track changes to your search engine.

Back to top