Sitelinks Search Box (WebSite) Structured Data | Google Search Central  |  Documentation  |  Google Developers (2022)

A sitelinks search box is a quick way for people to search your site or app immediately on the search results page. The search box implements real-time suggestions and other features.

Google Search may automatically expose a search box scoped to your website when it appears as a search result, without you having to do anything additional to make this happen. This search box is powered by Google Search. However, you can explicitly provide information by adding WebSite structured data, which can help Google better understand your site.

If Google Search already exposed a sitelink search box for your site, you can control certain aspects of the sitelink search box by adding WebSite structured data.

How to implement sitelinks search box

Here are the steps to make your site eligible to display with a search box in Google Search results:

(Video) Sitelink Search Box Show for Your Website in Google

  1. Install a working search engine on your web site or Android app.

    Sitelinks search queries send the user to the search results page for your site or app, so you need a functioning search engine to power this feature.

    • Websites: Set up a search engine on your website. The feature forwards the user's query to your target using the syntax specified in your structured data. Your search engine must support UTF-8-encoded queries.
    • Apps: See Search Overview on the Android Developer Site to learn how to implement a search engine for your app. Your Android app must support an ACTION_VIEW intent from Search results, with the corresponding data URI specified in your markup's property.
  2. Implement the WebSite structured data element on the homepage for your site. An app must have an associated website to enable this feature, even if the website is only a single page. A few additional guidelines:
    • Add this markup only to the homepage, not to any other pages.
    • If you're already implementing WebSite structured data for the site names feature, make sure that you nest the site name properties in the same node. In other words, avoid creating an additional WebSite structured data block on your homepage if you can help it.
    • Always specify one SearchAction for the website, and optionally another if supporting app search. You must have a SearchAction for the website even if the app is your preferred search target; this ensures that if the user is not searching from an Android phone or does not have your Android app installed, the search result directs to your website.
    • Based on the format you're using, learn where to insert structured data on the page.
  3. Follow the guidelines.
  4. Validate your code using the Rich Results Test.
  5. Verify your search engine implementation by copying the URL from your structured data, replacing {search_term_string} with a test query, and browsing to that URL in a web browser. For example, if your website is, and you want to test the query "kittens", you would browse to
  6. Set a preferred canonical URL for your domain's homepage using the rel="canonical" link element on all variants of the homepage. This helps Google Search choose the correct URL for your markup. Your server must support UTF-8 character encoding.
  7. For apps, enable the proper intent filters to support the URL you specify in the app target of your markup. For an example of how to create intent filters for Google Search urls, see Firebase App Indexing for Android.
  8. Deploy a few pages that include your structured data and use the URL Inspection tool to test how Google sees the page. Be sure that your page is accessible to Google and not blocked by a robots.txt file, the noindex tag, or login requirements. If the page looks okay, you can ask Google to recrawl your URLs.
  9. To keep Google informed of future changes, we recommend that you submit a sitemap. You can automate this with the Search Console Sitemap API.


Here is an example search result for "Pinterest" on Google that returns a sitelinks search box for the Pinterest website:

Sitelinks Search Box (WebSite) Structured Data | Google Search Central | Documentation | Google Developers (1)

Here is some example markup that would implement a sitelinks search box that uses the website's custom search engine:

(Video) How to get sitelinks for your website in google search


Here's an example in JSON-LD:

<html> <head> <title>The title of the page</title> <script type="application/ld+json"> { "@context": "", "@type": "WebSite", "url": "", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "{search_term_string}" }, "query-input": "required name=search_term_string" } } </script> </head> <body> </body></html>

Here's an example in Microdata:

<div itemscope itemtype=""> <meta itemprop="url" content=""/> <form itemprop="potentialAction" itemscope itemtype=""> <meta itemprop="target" content="{search_term_string}"/> <input itemprop="query-input" type="text" name="search_term_string" required/> <input type="submit"/> </form></div> 

Here's an example of a site and an app in JSON-LD:

<html> <head> <title>The title of the page</title> <script type="application/ld+json"> { "@context": "", "@type": "WebSite", "url": "", "potentialAction": [{ "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "{search_term_string}" }, "query-input": "required name=search_term_string" },{ "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "android-app://com.example/https/{search_term_string}" }, "query-input": "required name=search_term_string" }] } </script> </head> <body> </body></html>


You must follow these guidelines for your site to be eligible to appear as a rich result.

(Video) Friday SEO Tip | Google Sitelinks Best Practices

  • Search Essentials
  • General structured data guidelines

Prevent a sitelinks search box from appearing

Google Search can choose to add a sitelinks search box to your site even if it does not include the structured data described here. However, you can prevent this behavior by add the following meta tag to your homepage:

<meta name="google" content="nositelinkssearchbox">

Structured data type definitions

To make your content eligible for display with a sitelinks search box, include the required properties.

Modified type WebSite

Google Search uses a modified WebSite structured data type both for website and app search boxes. The full definition of WebSite is provided on, although Google Search deviates slightly from the standard.

Required properties

Array of one or two SearchAction objects

This object describes the URI to send the query to, and the syntax of the request that is sent. You must implement a webpage or intent handler that can receive the request, and perform an appropriate search on the submitted string. If the user is not on an Android app (or is on an Android app but has not specified an Android intent target), the search box will send the website version of the query to the location specified; if the user is on an Android device and has specified an Android intent URI, it will send that intent.

You must create a website SearchAction to enable the desktop search case. If also supporting app search, you can additionally specify a SearchAction object for your app. Each SearchAction object must contain the following nested properties:

  • potentialAction.@type
  • potentialAction.query-input

Website example

The following example sends a GET request to

"potentialAction": [{ "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "{search_term_string}" } "query-input": "required name=search_term_string"}]

App example

The following example sends an Android intent to android-app://com.example/https/

"potentialAction": [{ "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "android-app://com.example/https/{search_term_string}" } "query-input": "required name=search_term_string"}]


Use the literal string required name = search-term, or whatever placeholder you used in target. Make sure that both placeholder values match. For example, both placeholder values in the target and query-input properties use the string search-term:

"potentialAction": [{ "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "{search-term}" } "query-input": "required name=search-term"}]


An EntryPoint object with a urlTemplate property.

The urlTemplate must be a string in this format: search_handler_uri{search_term_string}

For example:{search_term_string}
search_handler_uri For websites, the URL of the handler that receives and handles the search query; for apps, the URI of the intent handler for your search engine that handles queries.

A placeholder string that is replaced by user's search query when the user clicks the "Search" button in the search box. Make sure that whatever placeholder string you use here also matches the value for the name element for the query-input property.



Specifies the URL of the site being searched. Set to the canonical homepage of your site. For example:

Monitor rich results with Search Console

Search Console is a tool that helps you monitor how your pages perform in Google Search. You don't have to sign up for Search Console to be included in Google Search results, but it can help you understand and improve how Google sees your site. We recommend checking Search Console in the following cases:

(Video) Monitoring Rich Results in Search Console - Google Search Console Training

  1. After deploying structured data for the first time
  2. After releasing new templates or updating your code
  3. Analyzing traffic periodically

After deploying structured data for the first time

After Google has indexed your pages, look for issues using the relevant Rich result status report. Ideally, there will be an increase of valid pages, and no increase in errors or warnings. If you find issues in your structured data:

  1. Fix the errors.
  2. Inspect a live URL to check if the issue persists.
  3. Request validation using the status report.

After releasing new templates or updating your code

When you make significant changes to your website, monitor for increases in structured data errors and warnings.

  • If you see an increase in errors, perhaps you rolled out a new template that doesn't work, or your site interacts with the existing template in a new and bad way.
  • If you see a decrease in valid items (not matched by an increase in errors), perhaps you are no longer embedding structured data in your pages. Use the URL Inspection tool to learn what is causing the issue.

Analyzing traffic periodically

Analyze your Google Search traffic using the Performance Report. The data will show you how often your page appears as a rich result in Search, how often users click on it and what is the average position you appear on search results. You can also automatically pull these results with the Search Console API.


If you're having trouble implementing or debugging structured data, here are some resources that may help you.

(Video) How to add a sitelinks search box to your website

  • If you're using a content management system (CMS) or someone else is taking care of your site, ask them to help you. Make sure to forward any Search Console message that details the issue to them.
  • Google does not guarantee that features that consume structured data will show up in search results. For a list of common reasons why Google may not show your content in a rich result, see the General Structured Data Guidelines.
  • You might have an error in your structured data. Check the list of structured data errors.
  • If you received a structured data manual action against your page, the structured data on the page will be ignored (although the page can still appear in Google Search results). To fix structured data issues, use the Manual Actions report.
  • Review the guidelines again to identify if your content isn't compliant with the guidelines. The problem can be caused by either spammy content or spammy markup usage. However, the issue may not be a syntax issue, and so the Rich Results Test won't be able to identify these issues.
  • Troubleshoot missing rich results / drop in total rich results.
  • Allow time for re-crawling and re-indexing. Remember that it may take several days after publishing a page for Google to find and crawl it. For general questions about crawling and indexing, check the Google Search crawling and indexing FAQ.
  • Post a question in the Google Search Central forum.


What is sitelinks search box in Google Search Console? ›

A sitelinks search box is a quick way for people to search your site or app immediately on the search results page. The search box implements real-time suggestions and other features.

How do I fix Google sitelinks? ›

You can inform Google of the change by using the URL inspection tool in Google search console. The URL inspection tool will crawl the submitted webpage for any changes, you can then request Google to re-index the page to reflect the changes made on the web page by selecting “request indexing”.

How do I get sitelinks to appear in my site's search results? ›

Use internal linking to help Google identify your important pages
  1. Use text to create your internal links.
  2. Use proper anchor text.
  3. Build more internal links to the pages you want to appear as sitelinks. In other words, the pages that have many internal links pointing to them, are likely to appear as sitelinks.
22 Jun 2021

What are sitelinks and how can I get them? ›

Sitelinks are links from the same domain that are clustered together under a web result. Our systems analyze the link structure of your site to find shortcuts that will save users time and allow them to quickly find the information they're looking for. Note: The actual appearance in search results might be different.

How many sitelinks do you need? ›

Sitelinks appear in ads at the top and bottom of Google search results. You need at least 2 sitelinks (for desktop), and at least one sitelink (for mobile) for the sitelinks to appear in the ad.

What is the purpose of sitelinks? ›

Sitelinks are the additional links visible below the main URL of the search results on Google. These are used to provide the users with easy access to different Web pages within your main website. The primary purpose of sitelinks is to help users seamlessly navigate through your website.

Can you change Google sitelinks? ›

Can You Change Google Sitelinks? You can't directly change Google sitelinks, but that doesn't mean you're SOL. The process is currently automated, but you can optimize your content in a way that adheres to Google's best practices and influences sitelink placement.

What are Google sitelinks? ›

Sitelinks help users go deep into your website, directly from a Google Ads ad. Sitelinks appear beneath the text of your ads, helping customers find what they're looking for on your site with just one click. Sitelinks appear in ads at the top and bottom of Google search results.

How can I see clicks on sitelinks? ›

To find sitelink data in Google Analytics, start by selecting Acquisition from the sidebar on the left of the screen. Find Google Ads in the drop-down menu and select Sitelinks. You can also view campaign-specific data in Google Analytics by setting your secondary dimension to Campaign and clicking on advanced.

How do I get Google to display my website results? ›

Go to In the search box, enter with your search term. Refine your search.

How do I appear higher in search results? ›

How to improve your local ranking on Google
  1. Enter complete data. Local results favor the most relevant results for each search. ...
  2. Verify your locations. ...
  3. Keep your hours accurate. ...
  4. Manage & respond to reviews. ...
  5. Add photos. ...
  6. Add in-store products. ...
  7. Relevance. ...
  8. Distance.

How can I get Google search results on my website? ›

The simplest (and fastest) way to get Google to index your website is to submit it to Google Search Console. You can also ask other website owners to link to your website; when Google encounters these links, it may add it to its index.

What do sitelinks look like? ›

Sitelinks are the blue links that appear under a Google search result. They link to other pages on the same website featured in the search result — hence the name “sitelinks.” Sitelinks appear on search engine result pages (SERPs) to help users find relevant information and webpages faster.

How do I remove sitelinks from Google ads? ›

Navigate to the campaign or ad group where you want to directly apply or remove sitelinks. In the left navigation panel, click All accounts.
To remove sitelinks that have been specified for the campaign or ad group:
  1. Click the Manage sitelink extensions button.
  2. Select an applicable option. ...
  3. Click Apply.

What paid search sitelinks? ›

Google Ads sitelinks are ad extensions that let advertisers promote up to four more specific links within one PPC ad and can increase click-through rate. These links should be more relevant to the user's search intent like a blog post, product page, the homepage, or another PPC landing page.

How do you optimize sitelinks? ›

How to improve sitelinks for your site
  1. Provide a clear structure for your website, using relevant internal links and anchor text that's informative, compact, and avoids repetition.
  2. Allow Google to crawl and index important pages within your site.
6 Sept 2018

How many structured snippets should you have? ›

Aim to include at least 4 values per header. Increase your options. Add more than one header-value set. Having multiple sets of structured snippets provides more options and increases the likelihood that a relevant asset will show with your ad.

What are the benefits of a sitelink extension? ›

Sitelink extensions allow you to display extra links below your adverts, allowing you to direct users to the most relevant pages within your website. There are several benefits of displaying sitelink extensions alongside your adverts: Allow you to occupy more space on the first page of Google.

How do I add sitelinks to Google ads? ›

Add a sitelink to an account, campaign or ad group
  1. In the account tree, select the account, campaign or ad group where you'd like to add the sitelink.
  2. In the type list, select Ad assets > Sitelinks.
  3. Click Add sitelink.
  4. Select a sitelink from your shared library.
  5. Click OK.

Can we control sitelinks? ›

Unfortunately, sitelinks are an automated Google feature that can't be edited or changed like a web page's title tag or meta description tag.

Can you schedule sitelinks Google ads? ›

Ad Extensions

Google also allows you to schedule your sitelinks to turn on and off at certain times; this is especially helpful during the holidays.

How do I edit sitelinks in Google console? ›

How to change the links that appear under your site on Google
  1. Go to Search Console home page and select the site you want to edit the links for.
  2. Click Search Appearance to expand this, and then click Sitelinks.
  3. In the For this search result box, complete the URL for the page you don't wish to display a sitelink.

How many sitelinks can show? ›

Desktop: Your ad can show up to 6 sitelinks. Sitelinks may appear on the same line or fill up to two lines of your ad. Mobile: Your ad can show up to eight sitelinks. These sitelinks appear side-by-side on a single line in a carousel format.

What is the box on Google search called? ›

If someone clicks on a result and then returns to the Google search results (a so-called “short click“), the user will often find a box directly below the result they just returned from. This box is titled “People also search for” and shows a list with links to similar search queries.

What is a search menu box? ›

A search box is usually a single-line text box or search icon (which will transform into a search box on click activity) with the dedicated function of accepting user input to be searched for in a database.

Why would an advertiser use sitelinks? ›

With sitelinks, potential customers can navigate your site from the moment they see your ad. This reduces friction and improves the customer experience by providing relevant answers (and links) for everyone that sees your ad content.

How do I add sitelinks to Google editor? ›

Add a sitelink to a campaign or ad group
  1. In the account tree, select the campaign or ad group in which you'd like to add the sitelink.
  2. In the type list, select Ad extensions > Sitelinks.
  3. Click on Add sitelink and choose Campaign sitelink or Ad group sitelink.
  4. Select a sitelink from your shared library.
  5. Click OK.

How do I get Google Answer box? ›

In the list below, I've listed some things you need to keep in mind when writing:
  1. Do your keyword research.
  2. Find out what people ask about your keywords/brand/product/service.
  3. Look at the 'People also ask' boxes for ideas.
  4. Use Answer the Public to find questions to answer.
  5. Check several current answers to see how it works.
20 Jun 2019

What is the difference between Google and Google Search? ›

Search Engine. When some people refer to Google, they are often referring to Google Search, which is a search engine. Google Chrome is a web browser, which serves its purpose for both the user and the device that it is running on.

How do I create a Google Search box? ›

Implementing Google search box

In the Control Panel, click the search engine you want to use. Click Setup in the sidebar, and then click the Basics tab. In the Details section, click Get code. Copy the code and paste it into your page's HTML source code where you want the Google search bar to appear.

What is search box why it is used? ›

A search box or search field is a common graphical user interface design element, one which allows the user to enter letters, words, and terms in a web search engine, database, website, archive, or list of options. As a result, users expect it to return content or options directly related to their input.

What are the two types of search boxes? ›

There are two types of searches:
  • Instant search, where the results are displayed immediately as the user types. No button needs to be clicked, so the magnifying glass search symbol is shown as a graphic, not a button. ...
  • Regular search, where a search is performed when the user clicks the search button.
9 Feb 2021

How does a search box work? ›

The search term or query is entered into the search box and then the search button is clicked. Some applications also allow the user to press the Enter key to initiate the search. The application acquires the text from the search box and matches it with the items in its database and returns the search results.


1. Structured Data and Rich snippets - A complete (but simplified) guide
(Jaume Ros)
2. Rich Results and Structured Data | Set Your Site Apart With These Search Features
(SMA Marketing)
3. Google Search Console Course Part 4 - Breadcrumbs, Sitelinks Searchbox and Mobile Usability
(This Week In Digital)
4. How to create sitelink search box in Search Engines - Digital Saby
(Digital Saby : Sebastian Braganza)
5. What is Sitelink Schema In SEO | How to Enable This Schema on Your Blog/Website in Hindi
(Digital Udit ETI)
6. Schema Markup: How to Add Schema Markup to Your Site
(Guiding Digital)

Top Articles

You might also like

Latest Posts

Article information

Author: Tuan Roob DDS

Last Updated: 11/28/2022

Views: 5487

Rating: 4.1 / 5 (42 voted)

Reviews: 81% of readers found this page helpful

Author information

Name: Tuan Roob DDS

Birthday: 1999-11-20

Address: Suite 592 642 Pfannerstill Island, South Keila, LA 74970-3076

Phone: +9617721773649

Job: Marketing Producer

Hobby: Skydiving, Flag Football, Knitting, Running, Lego building, Hunting, Juggling

Introduction: My name is Tuan Roob DDS, I am a friendly, good, energetic, faithful, fantastic, gentle, enchanting person who loves writing and wants to share my knowledge and understanding with you.