¿Qué son WebSite y SearchAction en Schema.org?

Si abres el código fuente de la portada de tu tienda y encuentras un nodo "@type": "WebSite" con un potentialAction dentro, lo más probable es que alguien lo pusiera para el cuadro de búsqueda de sitelinks: la caja que salía bajo el resultado de algunas webs grandes y dejaba buscar dentro de ellas sin salir de Google. Ese cuadro ya no existe. Lo que queda del marcado es menos vistoso y más útil de lo que parece: el nombre con el que Google presenta tu tienda encima de cada resultado. WebSite y SearchAction son dos tipos de Schema.org, y viven en los datos estructurados de la página, normalmente en un bloque JSON-LD.

Qué es cada pieza

Schema.org define WebSite como un conjunto de páginas web relacionadas y otros elementos, servidos normalmente desde un mismo dominio y accesibles por URL. Es un subtipo de CreativeWork, que a su vez lo es de Thing, y casi todo lo que lleva lo hereda: name, url, alternateName y potentialAction vienen de Thing, y publisher o isPartOf, de CreativeWork. La única propiedad propia del tipo es issn, para las publicaciones seriadas. Schema.org calcula que lo usan más de diez millones de dominios, con datos del índice de Google de agosto de 2026.⁠^{[1]Schema.org. WebSite}

SearchAction es otra cosa: no describe un objeto sino una acción, el acto de buscar algo, y desciende de Action. Su propiedad propia es query, la consulta que se usa en esa acción.⁠^{[2]Schema.org. SearchAction} Se engancha al sitio con potentialAction, que según el vocabulario indica una acción posible en la que la cosa descrita haría el papel de objeto. El ejemplo de Schema.org muestra la combinación entera: un WebSite cuyo potentialAction es un SearchAction con una plantilla de URL, http://example.com/search?&q={query}, donde {query} es el hueco que ocupa lo que escribe la persona.⁠^{[1]Schema.org. WebSite}

La idea era que un buscador supiera cómo lanzar una búsqueda dentro de tu tienda sin pasar por tu portada. Google la usó durante más de diez años para eso.⁠^{[3]Google Search Central Blog. Farewell, Sitelinks Search Box}

Qué hace hoy en Google

El 21 de octubre de 2024, Google anunció en su blog que retiraba el cuadro de búsqueda de sitelinks: llevaba más de diez años en la Búsqueda, su uso había caído y quería simplificar los resultados. Dejó de mostrarse a partir del 21 de noviembre de 2024, en todos los idiomas y países. El anuncio aclaraba que el cambio no afecta a la clasificación ni a los otros enlaces de sitio, y que Google retiraría el informe de resultados enriquecidos de Search Console de esa función y dejaría de señalar el marcado en la Prueba de resultados enriquecidos.⁠^{[3]Google Search Central Blog. Farewell, Sitelinks Search Box} El 29 de noviembre de 2024 borró la documentación de la función y archivó la regla nositelinkssearchbox.⁠^{[4]Google Search Central. Latest documentation updates}

Dos frases del anuncio siguen siendo las que importan a una tienda. Primera: puedes quitar ese marcado, pero no hace falta, porque los datos estructurados sin soporte no causan problemas en la Búsqueda ni errores en los informes de Search Console. Segunda: si lo quitas, ojo, porque los nombres de sitio usan una variante del mismo marcado WebSite, y esa sí sigue funcionando.⁠^{[3]Google Search Central Blog. Farewell, Sitelinks Search Box}

El nombre del sitio es lo que WebSite hace hoy en Google. Es el nombre de la web que aparece en cada resultado. Google lo genera de forma automática, a partir del contenido de la portada y de las referencias a ella en la web, y no lo cambia a mano. Para indicar tu preferencia, Google pide marcado WebSite en la portada; también mira og:site_name, el <title> y los encabezados, pero dice que el marcado WebSite es lo más importante.⁠^{[5]Google Search Central. Site names on Google Search} Las reglas, según su documentación, actualizada el 10 de diciembre de 2025:⁠^{[5]Google Search Central. Site names on Google Search}

• Son obligatorias dos propiedades: name, el nombre, y url, la portada canónica del dominio o del subdominio. alternateName es opcional y sirve para dar alternativas, como unas siglas o un nombre más corto.
• El marcado va solo en la portada, la raíz del dominio o del subdominio. No hace falta en el resto de páginas.
• Un nombre por sitio. Se admiten dominios y subdominios (www y m cuentan como el dominio), pero no subdirectorios: example.com/news no puede tener nombre propio. Si un subdominio no tiene marcado, puede heredar el nombre del dominio.
• La portada tiene que poder rastrearse. Si hay portadas duplicadas (con y sin www, http y https), todas llevan el mismo marcado.
• Si ya tienes un nodo WebSite, añade el nombre en ese mismo nodo en lugar de crear otro bloque.

En una tienda

Ejemplo ficticio. La portada de Calella, una tienda inventada de camisas de lino, con el nodo WebSite que dejó una agencia hace años:

{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "@id": "https://www.example.com/#website",
  "name": "Calella",
  "alternateName": "Calella Lino",
  "url": "https://www.example.com/",
  "publisher": { "@id": "https://www.example.com/#organization" },
  "potentialAction": {
    "@type": "SearchAction",
    "target": "https://www.example.com/search?q={query}",
    "query": "required"
  }
}

Se lee así. name y url son las dos propiedades que pide Google, y alternateName le ofrece una segunda opción. publisher no describe la empresa: apunta por su identificador @id al nodo Organization, que está en otra parte de la página. El potentialAction es la herencia del cuadro de búsqueda: no estorba, y Google ya no hace nada con él. Si Calella tuviera la versión en español en example.com/es/, esa carpeta compartiría el nombre del dominio, porque Google no da nombres a subdirectorios.

El nodo WebSite también aparece fuera de la portada, como pieza del grafo. Una ficha de producto publicada con Clione, por ejemplo, lleva un solo @graph con Organization, WebSite, BreadcrumbList y Product, más FAQPage cuando tiene preguntas. En una ficha, el nombre del sitio no se decide (Google solo lo lee en la portada), pero el nodo da a las demás piezas un sitio al que apuntar.

Cómo comprobarlo

1. Abre el código fuente de tu portada (no el inspector) y busca "WebSite". Debería haber un solo nodo; si hay dos, el nombre tiene que ir en el mismo.⁠^{[5]Google Search Central. Site names on Google Search}
2. Compara name con lo que la portada muestra: el <title>, og:site_name y los encabezados. Google tiene en cuenta todo eso y pide usar el nombre de forma coherente en toda la portada.⁠^{[5]Google Search Central. Site names on Google Search}
3. Mira url: tiene que ser la portada canónica de tu dominio o subdominio. Si tu portada se sirve con y sin www, comprueba que las dos versiones llevan el mismo marcado.⁠^{[5]Google Search Central. Site names on Google Search}
4. Si hay un SearchAction, decide con calma si lo quitas. No hace daño, y la Prueba de resultados enriquecidos ya no lo señala.⁠^{[3]Google Search Central Blog. Farewell, Sitelinks Search Box}
5. Busca tu marca en Google y mira el nombre que sale sobre el resultado de tu portada. Si no es el que quieres, revisa los pasos anteriores y añade un alternateName: Google no cambia el nombre a mano, pero tiene en cuenta las alternativas si tu primera opción no sale elegida.⁠^{[5]Google Search Central. Site names on Google Search}

Concepto cercano: Organization

WebSite y Organization se confunden porque, en una tienda pequeña, el sitio y la empresa suelen llamarse igual. Pero son dos cosas: WebSite describe la web; Organization, la empresa que hay detrás. La propiedad que los une es publisher, que WebSite hereda de CreativeWork y que acepta una organización o una persona.⁠^{[1]Schema.org. WebSite} Lo limpio es declarar cada uno una sola vez, con su propio @id, y que el sitio apunte a la empresa en lugar de repetirla. La entrada de Organization explica qué datos de la empresa van en su nodo.

Para seguir, la ruta de lectura de datos estructurados ordena el resto de términos, y ItemList explica el marcado que sí tiene sentido en una página de categoría.