SearchAction Schema Markup
SearchAction describes a search endpoint: a URL template with a placeholder for the query. Inside WebSite markup it used to enable the sitelinks search box in Google Search, which Google retired in November 2024.
Google Search Features
- Sitelinks search box — Retired (since November 21, 2024) Google no longer shows this rich result. SearchAction is still a valid schema.org type; the markup does no harm but earns no rich result.
When to Use SearchAction
Properties
| Property | Type | Status | Description |
|---|---|---|---|
| target | EntryPoint | required | The URL template for search with {search_term_string} placeholder. |
Note: query-input isn't a schema.org property, so it has no schema.org page. It's an annotation for the Action's input, written "query-input": "required name=search_term_string", where the name matches the placeholder in target's URL template.
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 describe how search queries can be sent to your site. It was the mechanism behind Google's sitelinks search box, which Google retired in November 2024. The markup is still valid schema.org, but Google Search no longer uses it.
Related Types
Check Your SearchAction Markup
The generator doesn't have a SearchAction form yet. Paste your markup into the validator to check its types, properties and values, and what Google needs from it.
Open Validator