WebSite & Sitelinks Searchbox Schema Markup (JSON-LD)
Enables the Google Search direct internal search box in SERPs and establishes the canonical site root entity.
Displayed below main page header or above the tool container. • Zero CLS Container
Production JSON-LD Code Block
Embed this structured data block directly into your HTML <head> or framework layout template.
{
"@context": "https://schema.org",
"@type": "WebSite",
"@id": "https://omniseotools.com/#website",
"url": "https://omniseotools.com",
"name": "OmniSEO Tools",
"description": "Client-side developer utilities and technical SEO analyzers.",
"potentialAction": {
"@type": "SearchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "https://omniseotools.com/search?q={search_term_string}"
},
"query-input": "required name=search_term_string"
}
}Typed Properties Specification (6 Fields)
Key Schema.org properties and sub-objects required to qualify for rich snippet treatment in Google Search.
| Property | Expected Type | Status | Description & Example |
|---|---|---|---|
| url | URL | Required | Canonical apex domain URL. e.g. https://omniseotools.com |
| name | Text | Required | Official website name displayed in Google SERP title tags. e.g. OmniSEO Tools |
| potentialAction | SearchAction | Required | Defines the internal search endpoint handler. e.g. { "@type": "SearchAction", "target": "..." } |
| query-input | Text | Required | Must match the variable defined in urlTemplate (e.g. required name=search_term_string). e.g. required name=search_term_string |
| description | Text | Recommended | Short site synopsis for search engine crawlers. e.g. Client-side developer utilities and technical SEO analyzers. |
| publisher | Organization | Recommended | Reference to the publishing organization node. e.g. { "@id": "https://omniseotools.com/#organization" } |
Google Search Console Pitfalls & Critical Warnings
Avoid these 3 common validation traps, parser errors, and algorithmic policy penalties when deploying WebSite schema.
urlTemplate Mismatches query-input Variable
If urlTemplate uses '{q}' but query-input specifies 'search_term_string', the Google Search bot cannot interpolate queries.
Ensure variable inside urlTemplate exactly matches the 'name=' string in query-input.
Deploying SearchAction Without Working Search Handler
Serving a 404 or unhandled response on the specified urlTemplate path triggers algorithmic spam penalties.
Verify that navigating to the target URL produces valid search results.
Multiple WebSite Nodes with Different Names
Emitting inconsistent WebSite schema on subpages confuses Google's site name algorithm.
Place WebSite JSON-LD only on the homepage or reference a single @id globally.
Recommended Implementation Scenarios
Related Schema Blueprints
Explore complementary structured data blueprints across the Technical SEO cluster.
Displayed below main page header or above the tool container. • Zero CLS Container