Other Extends: Action

SearchAction Schema Markup

SearchAction defines a search endpoint and is used exclusively within WebSite markup to enable the Sitelinks Search Box feature in Google Search.

Generate SearchAction Markup View on Schema.org

Eligible Rich Results

Sitelinks Search Box (via WebSite)

When to Use SearchAction

Site search integration via WebSite markup

Properties

Property	Type	Status	Description
target	EntryPoint	required	The URL template for search with {search_term_string} placeholder.
query-input	Text	required	Set to 'required name=search_term_string'.

JSON-LD Examples

Site Search

Search action for a website.

{
  "@type": "SearchAction",
  "target": {
    "@type": "EntryPoint",
    "urlTemplate": "https://example.com/search?q={search_term_string}"
  },
  "query-input": "required name=search_term_string"
}

Common Mistakes

Using the wrong placeholder — must be {search_term_string}, not {query} or {q}.

Making the target URL different from your actual search page.

Complete Guide to SearchAction Schema Markup

SearchAction is a supporting type used within WebSite markup to define how Google can send search queries to your site. It's the mechanism behind the Sitelinks Search Box.

Related Types

WebSite EntryPoint

Ready to Create SearchAction Markup?

Use our free generator to create valid SearchAction JSON-LD markup with a visual form. No coding required.

Open Generator