GBIM Technologies Pvt Ltd.

Sitelinks Search Box Schema

by | Oct 22, 2020 | Structured Data

With the help of a site links search box, you can search through a website or an app instantly via the search page results. The site links search box is nothing but a website-specific search box. It is a website or an app’s very own Search toolbar. The feature is Google Powered. It pops up automatically by Google Search, you do not have to do anything additional for making it happen. 

What you can do is provide information via adding the Website structured data for Google to understand your website better.

PRO TIP: Google does not guarantee for sitelinks search box for appearing on search results. Also, it is not guaranteed that websites or apps using the search box markup will display the sitelinks search box.


For sitelinks search box being eligible to appear on your website/app, follow the below-listed steps:

  1. Ensure to Install A working Search Engine on your website or Android App.


    • Website: Make sure to set up a search engine for your website. The feature helps forward the user’s query to your target by using the specified syntax in the structured data. Your search engine must support UTF-8 Encoded queries.
    • Apps: Check out the search overview on Android Developer for knowing how to implement a search engine box on your app. Your android must support an Action_View intent from search results, corresponding to the data URL specified in your markup’s property.


  1. For implementing the Website structured data entity on your website homepage:

For using the feature, an app must have an associated website, even if it is a single-page website. Follow the additional guidelines:

    •  Add the markup only to the homepage, not other pages.
    •  Ensure to specify one SearchAction for the website and others if supporting apps. A website must have a SearchAction even if the app is the preferred search target. It ensures the search result directs to your website, despite the users not searching from an android phone or an installed android app.
  1. Verify the structured data using the Rich Results Test.
  2. Ensure to verify the search engine implementation by copying the URL via your structured data that replaces the {search_term_string} with a test query and browses to that URL in the said web browser.
  3. Make sure to set a preferred canonical URL for your domain’s homepage by using the rel= ‘canonical’ link element on all homepage variants. It helps Google choose the correct URL for the markup. Your server must support UTF-8 character encoding.
  4. When working with Apps, enable proper intent filters for supporting the URL you specify in the app markup target. Check out Firebase App Indexing for Android for knowing how to create intent filters for Google Search.


Follow the Webmaster Guidelines and General Structured Data Guidelines for making your site eligible to appear as a search result.

Check out the earlier posts of the series to know more about the general structured data guidelines.


 Add the below-listed metadata to your homepage for preventing sitelinks search box:

<meta name=”Google” content=”nositelinksearchbox” />


  1. Website: the entity holds the said website.
  2.  PotentialAction: The entity holds the URL for sending the query to, and the syntax of the sent query. Ensure to implement a webpage or intent handler that can receive the said request and perform an appropriate search on the submitted site. For users not using an Android App, the search box will send the website query version to the specified location. For users on Android devices having a specified android intent URL, the said URL will be sent.

Ensure to create a website SearchAction for enabling the desktop search case. You can specify a SearchAction object for your app if supporting app search. Every SearchAction object has the following actions:

    • potentialAction.@type
    • potentialAction.query-input
  1. PotentialAction.query-input: Ensure to use the literal string required name= search_term_string, or any placeholder used in the target.

      4.PotentialAction. Target : A string in the said format : search_handler_uri { search_term_string}.

    •  Search_handler_uri: For websites, the said URL handler must receive and handle all search queries. For apps, the URL of the said intent handler for your search engine that handles search queries.
    •  Search_term_string: The said placeholder string that replaces the user’s search query once the user “clicks” the search button in the box.
  1. URL: Specify the URL of the said site that is searched. 

Set it to the canonical homepage of your website.

Refer to the previous posts of the Series to know in detail about Monitoring Rich Results with Search Console, Fixing Troubleshooting problems and Analyzing Traffic.


Nirlep & Dharmesh

Contact Us Today

Our Team

    [honeypot honeypot-23]
    Please prove you are human by selecting the House.

    You may also Like:
    Product Structured Data – A step by step guide

    Product Structured Data – A step by step guide

    Product Struture Data Guide Adding Structured Data to Your Product Pages enables Google to display detailed product information in rich search results, including Google Images. With the help of the Markup, viewers can see various product features like Price,...

    Job Training (Beta) Schema

    Job Training (Beta) Schema

    The Job Training Experience on Google Search helps employees, students, professionals, and all individuals discover a new or different career path for themselves and gain new skills for their next jobs or new careers. It is a useful feature for job seekers,...

    Recipe Schema Markup

    Recipe Schema Markup

    You can use the Recipe schema Markup for letting Google know about your recipes. When you use the Recipe structured data, you provide valuable information like review ratings, preparation and cooking time, nutrition information, etc. helping Google to understand your...

    Need Help?