Creating and customizing search

You can customize the search field and the appearance of the search form and search results by following these five steps. After you finish, you'll receive an HTML code to insert to your site.

    Step 1. Search field

    At the first step, set the search area (number of pages limiting the search),  as well as the search names and other general properties.

    Technical search name

    The name which will be displayed on the page. It will be visible only to you.

    Search name for OpenSearch standard

    You can set the name of the search for – visitors can add your search using this name in the browser as a search engine.

    If you created the search before the Search for the site began to support OpenSearch, a name such as “Yandex Site Search #2023403” was automatically assigned to it. We recommend changing the name in order to better reflect the purpose of the search.

    Family filter

    At the first step, set the search area (number of pages limiting the search),  as well as the search names and other general properties.

    In order to exclude pages with foul language or pornography from the search scope, set the family filter. Filter settings are the same as the.

    Search technology

    Choose one of two technologies


    Works faster than the standard search and provides more complete results due to the targeted indexing of your site. It is accessible only for searching on sites – if you want to use search topics or Catalog categories, choose the Standard search.

    The SaaS-search requires that you confirm the right to manage the sites for which you are organizing the search.

    Note. It is not yet possible to use this search technology to enrich video and image snippets from the pages of found documents.

    Some time is required for the SaaS-search to index your sites. On average, it takes several hours for the robot to inspect one site.

    Standard search

    Uses the main index of the Yandex search engine; therefore, it may be incomplete but does not require additional indexing. It is only possible to search by Catalog category or search topics using standard search technology.

    Search field

    You can compose a search area of separate sites, categories of Yandex.Catalog and search topics created by you.

    You can add up to 200 separate sites. You can add an unlimited amount of search topics and Yandex.Catalog categories to the search field.

    Search in subdomains

    If you added a full domain in the search field (for example,, you can quickly exclude subdomains using a switch .

    The switch is situated in the right position by default – search takes place in both the main domain and subdomains. To search only in the main domain, move the switch to the left position .


    You can exclude specific pages from the search scope. Exclusions are factored into all sources included in the search, including search topics and Yandex.Catalog categories.

    You can specify the exact addresses of documents or the address mask to exclude whole sections of sites in the exclusions list. For example:

    • To exclude the page somepage.php from the site

    • To exclude all pages from the /blog/ section of the site

    If you already entered a site manually, you can add or delete exclusions from the Exclusions block the same as you would for sites.

    If your search area consists only of search topics and Yandex.Catalog categories, you can specify exceptions by pressing the button Add websites and exceptions.

    Step 2. Search form

    Step two involves customizing your search form's appearance. Settings are automatically shown in the header Search form preview. The form on your site will look like the one below. Please note: the form on your site will automatically stretch to the appropriate width.


    A form with a transparent background is recommended by default so that you don't have to worry about what color best suits your site's color scheme.

    You can allow users to switch between the search sources you entered and Yandex's main search. To add the switch on your site / on the Internet, check the choose search form box.

    You'll get the form code during step 5 of setting up your search engine.

    Step 3. Search results

    Step 3 involves customizing your search results. The main task is to decide where you want search results displayed (in the block Display results).

    Two options are available:

    • On Yandex's page, with your logotype, header, and footer (option Display results on Yandex).

    • On your site's page (Display results on my page option). If you select this option, enter the URL of the page that will contain the search results code. The code will be available during step 5 of setting up your search engine.

    The settings you choose for your search results' appearance (colors, texts, fonts) are automatically shown under the Preview search results heading.

    Step 4. Testing

    Step 4 involves checking your customized search. The form's appearance should correspond to your settings and the search results should fall within the search scope you entered.

    If either the search or the search form do not work properly, check the settings from the previous steps again. If the mistake continues, , including your username and the name of the incorrectly working search.

    Step 5. HTML code

    In step 5, you will receive codes for the search form and search results (if you want to display results on your site.)

    Coding and language selection

    Yandex automatically detects your site's coding, but if auto-detection does not work, you can enter the text's code.

    Language selection affects several search parameters:

    • the search results and search form language;
    • the search scope and result sorting (a request entered in English will most likely return pages in English);
    • the language of default search hints.

    Search form code

    By choosing a search form language, you can copy its code and insert it into the your website page's HTML code.

    The form code for Yandex.Site Search is included in the <div> element with the specified CSS classes. If the options available don't suit you, you can set up your own form design using CSS: just define the appropriate styles in the <style> element after the form code.

    Search results code

    If you select the Display results on my page option in the search results settings, the search results code will also appear in step 5. This code should be inserted into the HTML code of the page where results will display.

    Yandex.Site Search offers two types of search results code:

    • IFRAME

      This is the easiest option. The inserted code creates a <iframe> element in which results are displayed. This option is better for ensuring compatibility with complex website set-ups, but doesn't allow for flexible customization of the the search results' appearance.

    • HTML & CSS

      The search results code that you insert builds the entire HTML code into the structure of your webpage. Search results elements will be set up according to your general CSS styles.

      If you are familiar with CSS settings, you can adapt the search results' presentation to fit your website's design. Check the Add CSS to results code box and the CSS code for all search results styles will be added to the results code.

      The HTML & CSS option also allows you to get links to a particular search results page or refined search results Check the Change page hash parameters when navigating search results to use this option.

      Restriction. If you use your own hash parameters, this setting may conflict with the search results code. In this case, it's better to disable the setting.