---
title: "Site Search"
description: "Add a SearchAction to WebSite schema with defineSearchAction() and describe your internal search URL template."
canonical_url: "https://unhead.unjs.io/docs/schema-org/guides/recipes/site-search"
---

> Index of every page on this site: [llms.txt](https://unhead.unjs.io/llms.txt)

If your site offers a search function, you can describe it with a SearchAction on the WebSite node. [Google removed the sitelinks search box in November 2024](https://developers.google.com/search/blog/2024/10/sitelinks-search-box), so this markup no longer creates that visual feature or affects Google rankings.

## Useful Links

- [Sitelinks search box removal](https://developers.google.com/search/blog/2024/10/sitelinks-search-box)
- [SearchAction - Schema.org](https://schema.org/SearchAction)

## Define a Search Action

Add `defineSearchAction()` to the primary WebSite node's `potentialAction`. Its URL template must contain `{search_term_string}`, which is replaced with the visitor's query.

```ts
import { defineSearchAction, defineWebSite, useSchemaOrg } from '@unhead/schema-org'

useSchemaOrg(unheadInstance, [
  defineWebSite({
    potentialAction: [
      defineSearchAction({
        target: '/search?q={search_term_string}'
      })
    ]
  })
])
```

## Define your Search Results Page

Set the [WebPage](https://unhead.unjs.io/docs/schema-org/api/schema/webpage) type to `SearchResultsPage` for the search results route.

```ts
import { defineWebPage, useSchemaOrg } from '@unhead/schema-org'

useSchemaOrg(unheadInstance, [
  defineWebPage({
    '@type': ['CollectionPage', 'SearchResultsPage'],
  })
])
```

## Related Recipes

- [Setting Up Your Identity](https://unhead.unjs.io/docs/schema-org/guides/recipes/identity): Define your organization
- [Breadcrumbs](https://unhead.unjs.io/docs/schema-org/guides/recipes/breadcrumbs): Navigation breadcrumbs
- [E-commerce](https://unhead.unjs.io/docs/schema-org/guides/recipes/e-commerce): Product structured data

## Sitemap

See the full [sitemap](https://unhead.unjs.io/sitemap.md) for all pages.