Navigation · Must-have

WebSite + SearchAction schema — what it does & how to ship it

Short answer

WebSite marks the site itself and, with a nested SearchAction, unlocks the sitelinks searchbox — a persistent search field rendered directly inside the SERP for brand queries.

What it does

WebSite carries name, url and a potentialAction of SearchAction with target and query-input. It only ships once, sitewide, from the root layout.

SERP / AI benefit

Sitelinks searchbox in the SERP for brand queries — a huge branding surface that also drives direct search sessions into your site.

Where to use it

Root only.

JSON-LD example

{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "name": "WBP Omni SEO Pro",
  "url": "https://wbpomniseo.com",
  "potentialAction": { "@type": "SearchAction", "target": "https://wbpomniseo.com/search?q={search_term_string}", "query-input": "required name=search_term_string" }
}

Copy, edit for your site, and drop into your page head inside a<script type="application/ld+json">block. Validate with Google's Rich Results Test.

In WBP Omni SEO Pro

Live in the root layout with the site name, canonical URL and internal search endpoint.

Ship WebSite + SearchAction without touching code

Frequently asked

Do I need a working internal search for SearchAction?›

Yes — the target URL must return actual search results. Faking it can cause the searchbox to be removed.

Can WebSite ship on every page?›

It only needs to ship once, sitewide. Duplicate WebSite nodes across pages don't help.

How long does the searchbox take to appear?›

Weeks to months, depending on brand-query volume. Google needs enough repeat brand searches to justify the surface.