Elija un @id estable para su organización, reutilice ese valor exacto en sus nodos WebSite, WebPage y Person, y agregue sameAs solo para los perfiles que representen claramente a la misma organización. Ese es todo el patrón detrás del marcado de entidades, y funciona en cualquier plataforma que le permita publicar JSON-LD.
Si un tema, un plugin o una plataforma ya agrega una descripción de la empresa, repare ese bloque en lugar de agregar otro. El marcado describe la entidad. Un panel de conocimiento (Knowledge Panel) de Google es una visualización que Google genera cuando tiene suficiente información sobre una entidad en la web abierta, así que un marcado preciso no lo obliga a aparecer.
Siga este orden: elija el identificador, decida qué perfiles entran en sameAs, conecte los nodos y pruebe la página publicada en cada herramienta que documente sus propias comprobaciones.
Elija un @id y reutilícelo en todas partes
Un @id es un identificador de nodo. En JSON-LD nombra un nodo con una URL absoluta para que otros nodos puedan apuntar a él. La opción habitual es la página de inicio más un fragmento, como https://example.com/#organization. El fragmento mantiene a la entidad separada de la página, lo que importa porque la página de inicio es una WebPage y la organización es otra cosa. La especificación JSON-LD del W3C define @id y @graph; es sintaxis para datos enlazados, no un campo que Google use para el posicionamiento.
Una vez elegido el valor, trátelo como un contrato. Cada nodo que hace referencia a la organización usa exactamente la misma cadena, carácter por carácter: el publisher del WebSite, el about y el mainEntity de una página Acerca de, el worksFor de un Person. Una barra final en una página, http en otra o www en una tercera crea un segundo identificador, y un segundo identificador describe una segunda entidad.
El error más frecuente es crear un identificador nuevo en cada página para lo que debería ser un solo negocio. Otro es dar a un nodo de organización un @id que identifica una página. Mantenga separados los identificadores de página y los identificadores de entidad.
Tres identificadores para un solo negocio (evitar)
https://example.com/about/#org
https://example.com/contact/#org
https://example.com/blog/#org
Un solo identificador reutilizado en todas partes
https://example.com/#organizationDefina la url de la organización como la página de inicio real, la misma dirección que usa su etiqueta canónica. Mantenga el nombre, el logotipo y los datos de contacto públicos idénticos a lo que ven los visitantes en la página y en sus perfiles externos. Las directrices de datos estructurados de Google piden que el marcado refleje el contenido visible y se mantenga preciso.
Términos clave: entidad, Gráfico de conocimiento y panel de conocimiento
Una entidad es una cosa distinta del mundo real, como una empresa, una persona, un producto o un lugar. En el ejemplo siguiente, la empresa ficticia Northstar Fieldworks es una entidad, y también lo es su integrante del equipo, Maya Chen. Los datos estructurados describen una entidad y sus relaciones en un formato legible por máquinas.
El Gráfico de conocimiento (Knowledge Graph) de Google es un sistema para representar entidades y las relaciones entre ellas. Google ofrece una Knowledge Graph Search API de solo lectura que devuelve entidades coincidentes usando tipos de Schema.org, y su documentación indica que no debe ser una dependencia crítica en producción. Puede usarla para consultar cómo está representada una entidad, pero no para editar ni crear nada.
Un panel de conocimiento es una visualización en la Búsqueda de Google que Google genera automáticamente cuando tiene suficiente información sobre una entidad en la web abierta. Puede mostrar un nombre, una descripción, un logotipo, el sitio web oficial y perfiles. La página de ayuda de Google sobre cómo funciona el Gráfico de conocimiento explica que los paneles no se construyen solo con el marcado de un sitio. Los representantes oficiales pueden reclamar un panel que sea elegible y sugerir correcciones mediante Get verified on Google (verificación en Google). Las empresas con clientes locales también deben administrar su Perfil de Empresa de Google (Google Business Profile).
Qué debe ir en sameAs
La propiedad de Schema.org sameAs contiene la URL de una página de referencia que identifica sin ambigüedad la misma cosa. Cada valor indica que el perfil enlazado describe a la misma organización, no a una relacionada. Son valores adecuados:
- Un perfil oficial de la empresa en una red social.
- Un perfil oficial en el sitio de una asociación del sector.
- Un perfil verificado en un directorio de empresas.
- Una página de Wikidata o de Wikipedia, cuando representa claramente a la misma organización.
- Una página oficial de la empresa matriz o de la marca, cuando la relación sea explícita y la página identifique a la misma entidad.
Excluya todo lo que esté relacionado pero no sea idéntico. Una página de inicio de otra empresa con un nombre parecido no corresponde, y tampoco una página de reseñas sobre su negocio, porque esa página no es un perfil de identidad. Los socios, distribuidores, clientes y marcas no relacionadas son entidades separadas. Un producto, una ubicación o un fundador es un nodo distinto de la organización, así que recibe su propio nodo en lugar de una entrada sameAs en la organización.
Omita también las URL de resultados de búsqueda, las URL de seguimiento y las URL de campañas que podrían dejar de funcionar. Antes de agregar un perfil, ábralo y compare el nombre, el logotipo, la ubicación y la propiedad con su sitio web. Un perfil que entre en conflicto en cualquiera de esos datos crea ambigüedad, justo lo contrario de lo que sirve sameAs. Corrija primero el perfil y después agregue el enlace.
Un grafo conectado de Organization, WebSite, WebPage y Person
El grafo siguiente conecta cuatro nodos con un solo identificador de organización. El WebSite nombra a la organización como su publisher, la página Acerca de está dentro del sitio web con isPartOf, y declara que es about la organización y que la organización es su mainEntity. El nodo Person apunta a la organización con worksFor. Cada referencia a la organización es el mismo @id.
Este es código para adaptar, con valores ficticios en dominios de ejemplo reservados. Reemplace cada nombre, URL, ruta de logotipo y enlace de perfil por sus propios datos reales y visibles, y nunca publique los datos de Northstar en su propio JSON-LD.
{
"@context": "https://schema.org",
"@graph": [
{
"@type": "Organization",
"@id": "https://example.com/#organization",
"name": "Northstar Fieldworks",
"alternateName": "Northstar",
"url": "https://example.com/",
"logo": "https://example.com/images/northstar-logo.png",
"sameAs": [
"https://social.example.org/northstar-fieldworks",
"https://directory.example.org/organizations/northstar-fieldworks"
]
},
{
"@type": "WebSite",
"@id": "https://example.com/#website",
"url": "https://example.com/",
"name": "Northstar Fieldworks",
"publisher": { "@id": "https://example.com/#organization" },
"inLanguage": "en-US"
},
{
"@type": "WebPage",
"@id": "https://example.com/about/#webpage",
"url": "https://example.com/about/",
"name": "Acerca de Northstar Fieldworks",
"isPartOf": { "@id": "https://example.com/#website" },
"about": { "@id": "https://example.com/#organization" },
"mainEntity": { "@id": "https://example.com/#organization" },
"inLanguage": "en-US"
},
{
"@type": "Person",
"@id": "https://example.com/about/maya-chen/#person",
"name": "Maya Chen",
"url": "https://example.com/about/maya-chen/",
"worksFor": { "@id": "https://example.com/#organization" },
"sameAs": ["https://social.example.org/maya-chen"]
}
]
}Observe que el nodo Person tiene su propio sameAs, que apunta al perfil de esa persona. Nunca coloque el perfil de un fundador en el nodo de la organización. El vocabulario procede de las páginas de Schema.org sobre Organization, WebSite, WebPage y Person.
Este grafo es vocabulario válido de Schema.org, pero no corresponde a una única función de resultados enriquecidos de Google. Los nodos WebSite, WebPage y Person no tienen aquí un requisito separado de Google; conectan la entidad con las páginas y las personas que le pertenecen. Para crear los nodos sin escribir el JSON a mano, pruebe el generador de schema de organización o el constructor de grafos schema, y compare otras formas en los ejemplos de schema JSON-LD.
Propiedades que Google recomienda para Organization
La documentación de Organization de Google indica que el tipo no tiene propiedades obligatorias. Para esa función se recomiendan name, url, logo, sameAs y alternateName, y también address, telephone y contactPoint cuando correspondan. Las propiedades de identificador, como legalName, taxID y vatID, también se recomiendan cuando sean aplicables. Escriba estas propiedades como recomendadas, nunca como obligatorias, en sus notas y en cualquier entrega a un cliente.
El @id es opcional para esa función de Google, pero es lo que permite que los demás nodos de su grafo apunten a la organización. La misma documentación indica que el marcado de Organization puede ayudar a Google a entender datos administrativos y a distinguir una organización de otra con un nombre parecido, y que puede influir en elementos visuales, como un logotipo en la Búsqueda o en un panel de conocimiento. No garantiza un panel de conocimiento, un resultado enriquecido, un cambio en el posicionamiento, una cita en la IA ni tráfico.
Google indica que el marcado de Organization debe ir en la página de inicio o en una página que describa a la organización, no necesariamente en todas las páginas. Si su duda es con qué frecuencia repetirlo, la guía sobre schema de organización en cada página trata esa decisión con detalle.
Dónde colocar el marcado y qué ya genera su plataforma
Antes de agregar un grafo, averigüe qué hay ya en la página. Los temas, los plugins de SEO y las plataformas de tiendas suelen incluir una descripción de Organization o de WebSite, y un segundo bloque que describa la misma empresa crea dos nodos con dos identificadores. Abra la página, vea el HTML renderizado y busque application/ld+json.

En WordPress, los temas y los plugins incluyen JSON-LD mediante el hook wp_head, así que más de una extensión puede agregar un grafo. Hydrogen, de Shopify, documenta un valor jsonLd en getSeoMeta, y quien administre el tema debe revisar el resultado renderizado antes de agregar otro grafo de Organization. Wix acepta marcado personalizado JSON-LD y documenta sus límites y los pasos de validación en su página de solución de problemas de datos estructurados.
Squarespace explica que las advertencias sobre datos estructurados no impiden necesariamente la indexación ni la elegibilidad, y su página de ayuda sobre errores de SEO conviene leerla antes de reemplazar lo que genera la plataforma.
Webflow expone el marcado de cada página mediante su Schema Markup API. En Next.js, la guía de JSON-LD recomienda renderizarlo en layout.js o page.js y sanitizar los valores dinámicos antes de que entren en una etiqueta script. En HubSpot, revise el HTML renderizado y agregue un solo grafo personalizado únicamente si la salida existente no describe ya su organización.
Compruebe lo que Google sabe sobre su negocio
Dos comprobaciones distintas responden a dos preguntas distintas, así que haga ambas. Buscar el nombre de su organización muestra si existe un panel de conocimiento. La Knowledge Graph Search API muestra qué entidades puede hacer coincidir Google con ese nombre. Ninguna de las dos le dice si su marcado se procesó bien, que es una prueba aparte.
- Busque en Google el nombre de su organización y compruebe si aparece un panel de conocimiento.
- Si existe un panel y usted es un representante autorizado, use la opción de reclamar o de enviar comentarios de las páginas de ayuda de Google.
- Consulte la Knowledge Graph Search API y lea los nombres, tipos, descripciones y URL coincidentes que devuelve.
- Compare cada resultado con su sitio web oficial, sus perfiles, las variantes del nombre, la ubicación y el sector.
- Vuelva a comprobarlo cuando Google haya tenido tiempo de rastrear e indexar sus cambios. Una implementación válida no obliga a que aparezca un panel ni a que se actualice de inmediato.
Valide en orden y pruebe después con cada proveedor
La validación tiene varios niveles, y superar uno no significa superar el siguiente. Primero confirme que la sintaxis JSON es válida; el validador de schema de Schema Nova es un lugar donde pegarla. Después ejecute el Schema Markup Validator para el vocabulario de Schema.org, que es la comprobación adecuada para un grafo como este.
Luego ejecute la Prueba de resultados enriquecidos (Rich Results Test) de Google para comprobar la elegibilidad en una función de Google, y después inspeccione la URL publicada con la herramienta «URL Inspection» (inspección de URL) de Search Console. La página de herramientas de depuración de Google describe ambas. Superarlas muestra cómo ve Google la página; no demuestra un panel ni un resultado de posicionamiento.
En Bing Webmaster Tools, la herramienta «URL Inspection» (inspección de URL) incluye una tarjeta «Markup» (marcado) que muestra el JSON-LD detectado, como describe la ayuda de Bing sobre URL Inspection. La disponibilidad de la herramienta puede depender de su cuenta y del acceso al sitio. Para Yandex, use el validador de datos estructurados de Yandex, que comprueba si el marcado se reconoce y cumple los requisitos del servicio de Yandex. Yandex indica que no todos los tipos de Schema.org son compatibles y que el análisis no garantiza un fragmento, según explica su preguntas frecuentes sobre marcado semántico.
Haga que el marcado de entidades sea legible para Bing y la búsqueda con IA
Bing admite Schema.org en JSON-LD, Microdata y RDFa, y sus Directrices para webmasters indican que los datos estructurados deben reflejar el contenido visible, así que el mismo grafo sirve a Bing. Microsoft indica que la búsqueda web de Copilot puede recuperar contenido a través de Bing Search.
Para que la búsqueda de ChatGPT llegue al sitio, OpenAI recomienda permitir OAI-SearchBot (preguntas frecuentes para editores). Para Perplexity y DuckDuckGo, mantenga las páginas rastreables, los datos visibles exactos y las URL canónicas estables. Para la pregunta más amplia, consulte si los sistemas de IA usan el marcado schema.
Corrija los grafos duplicados y los identificadores inestables
Dos plugins que generan cada uno un grafo de Organization son una causa frecuente de resultados contradictorios. Elija un solo plugin, una opción del tema o un bloque escrito a mano para encargarse de la organización, desactive la salida de Organization de los demás y vea el HTML renderizado para confirmar que solo un nodo usa su @id. Si un plugin no puede reutilizar su identificador, cambie sus referencias para que coincidan con el que genera, de modo que todos los nodos sigan apuntando a un solo valor.

Vuelva a revisar su lista de sameAs cada vez que cambien el nombre de la marca, el dominio, la propiedad o la ubicación del negocio. Un perfil antiguo que todavía lleve el nombre anterior entra en conflicto con su sitio web, y un perfil retirado puede no llevar a ninguna parte. Actualice el marcado y el perfil al mismo tiempo, y después repita la secuencia de validación.
Mantenga el marcado preciso. No describa datos que los visitantes no puedan ver o que no sean ciertos, y no agregue reseñas que favorezcan solo a su negocio ni perfiles no relacionados. Los datos de entidad exactos y coherentes dejan menos que adivinar a los buscadores y a los sistemas de IA, y eso es lo máximo que puede prometer cualquier marcado.
Preguntas frecuentes
¿Debe el schema de Organization estar en todas las páginas?
Google indica que el marcado de Organization normalmente debe aparecer en la página de inicio o en una página que describa a la organización, no necesariamente en todas las páginas. Otras páginas pueden seguir haciendo referencia al mismo @id desde nodos como WebPage o Person, de modo que la entidad se mantiene coherente.
¿Debe un autor ser un nodo Person?
Cuando una página nombra a un autor, un nodo Person con worksFor que apunte al @id de su organización es vocabulario válido de Schema.org. Este grafo no tiene un requisito separado de resultados enriquecidos de Google para ese nodo, así que añádalo solo donde coincida con lo que los visitantes pueden ver en la página.
¿Puedo usar el mismo @id de organización en varias páginas?
Sí. La función de un identificador es la reutilización, y el mismo valor en varias páginas indica a las máquinas que esas referencias describen una sola organización. Manténgalo idéntico carácter por carácter, incluidos el protocolo, el host y el fragmento final.
¿Lee Bing JSON-LD?
Bing indica que admite Schema.org en JSON-LD, Microdata y RDFa, y su herramienta URL Inspection muestra el marcado detectado en una tarjeta «Markup» (marcado). Bing también indica que las anotaciones no garantizan un resultado visual.
¿Sigue siendo útil Schema.org cuando no existe una función de Google?
Sí. El vocabulario de Schema.org y las funciones de la Búsqueda de Google son capas distintas, así que un tipo o una propiedad puede seguir siendo vocabulario válido aunque una función de visualización de Google no esté disponible. Otros sistemas pueden leer el mismo marcado según su propia documentación.
