What is Search Schema (SearchAction)?

It’s JSON-LD on your WebSite entry that tells search engines how to search your site. It enables Google’s sitelinks search box when eligible.

What should the target URL template look like?

Use your on-site results URL with a placeholder, e.g., https://example.com/search?q={search_term_string} or /?s={search_term_string}.

What is the query-input value?

Use required name=search_term_string. That’s the standard token Google expects for sitelinks search box.

Do I need both WebSite and Organization?

For the search box, only WebSite with potentialAction is required. You can still use Organization markup separately on your homepage.

Where should I place the markup?

Place the JSON-LD on your homepage (or the canonical site root) and make sure the search results page is crawlable.

Search Schema Generator

Preview

Test

<script type="application/ld+json">
{ ... }
</script>

What is Search Schema?

Search Schema adds a SearchAction to your WebSite JSON-LD so Google and other engines know how to search your content. With correct markup and eligibility, Google may show a sitelinks search box for your brand.

How to Implement

Enter your site name, homepage, and a target URL template (include {search_term_string}).
Copy the generated JSON-LD and place it on your homepage (or site root).
Ensure your on-site search results are crawlable and return relevant pages.
Validate with Google’s Rich Results Test.

Search Schema Generator

What is Search Schema?

How to Implement

FAQs