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.

Puntos clave

  1. Reutilice un único @id de organizaciónElija un @id estable, como la página de inicio más #organization, y reutilice esa cadena exacta en cada nodo que se refiera a la organización.
  2. Los paneles no están garantizadosUn panel de conocimiento es una visualización que Google genera cuando tiene suficiente información sobre una entidad, así que un marcado exacto no lo fuerza.
  3. Añada enlaces sameAs precisosIncluya solo perfiles que identifiquen sin ambigüedad a la misma organización. Las páginas de reseñas, socios y el perfil de un fundador no van en su sameAs.
  4. Conecte los nodosApunte los nodos WebSite, WebPage y Person a la organización con ese mismo @id. Dé a un Person su propio sameAs, nunca el de la organización.
  5. Busque grafos existentesBusque application/ld+json en el HTML renderizado. Dos complementos que imprimen cada uno un grafo de Organization crean dos nodos; deje que solo uno sea dueño de la organización.
  6. Valide en cada herramientaUse el Validador de marcado Schema para el vocabulario, la Prueba de resultados enriquecidos para Google y la Inspección de URL de Bing. Superarlas no demuestra panel ni posicionamiento.

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.

text
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/#organization

Defina 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.

json
{
  "@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.

Conecte una entidad en seis pasos

La validación muestra cómo una herramienta lee la página. No promete un panel de conocimiento, un resultado enriquecido, un cambio en el posicionamiento ni una cita en la IA.

  1. Elija el ID de la entidadElija una URL absoluta estable, como la página de inicio más #organization.
  2. Describa la OrganizationAñada la página de inicio real como url, junto con name, logo y los datos de contacto visibles.
  3. Conecte los nodosHaga que los nodos WebSite, WebPage y Person apunten al mismo @id de la organización.
  4. Añada URL sameAs precisasIncluya solo perfiles que identifiquen claramente a la misma organización.
  5. ValideCompruebe la sintaxis JSON y el vocabulario de Schema.org antes de publicar.
  6. Inspeccione y mantengaPruebe en Google y en Bing la URL publicada, y vuelva a revisar tras cualquier cambio de marca.

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.

Propiedades de Organization y su estado en Google

Pase el cursor o toque una fila para resaltarla. En pantallas pequeñas la tabla se desplaza de lado.

PropiedadFunción de Organization de GoogleEn su grafo
name, url, logoRecomendadaCoincida con el nombre de marca visible, la página de inicio real y su archivo de logotipo.
sameAs, alternateNameRecomendadaAñada solo perfiles que identifiquen a la misma organización.
address, telephone, contactPointRecomendada cuando correspondaInclúyalas cuando aparezcan en la página.
legalName, taxID, vatIDRecomendada cuando correspondaAñada los identificadores que correspondan a su organización.
@idOpcional para esta función de GoogleÚtil para conectar nodos en el grafo.
Nodos WebSite, WebPage, PersonOpcional, sin requisito separado de OrganizationAñádalos para conectar el sitio, la página y sus personas.

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.

Un hombre de cabello con vetas grises y jersey azul marino compara dos bloques de líneas en un portátil, en una mesa compartida de coworking
Figura 1. Comparar el marcado que ya genera una página con su propio grafo muestra si un segundo nodo Organization sería un duplicado.

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.

  1. Busque en Google el nombre de su organización y compruebe si aparece un panel de conocimiento.
  2. 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.
  3. Consulte la Knowledge Graph Search API y lea los nombres, tipos, descripciones y URL coincidentes que devuelve.
  4. Compare cada resultado con su sitio web oficial, sus perfiles, las variantes del nombre, la ubicación y el sector.
  5. 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.

Dos nodos parecidos con sus satélites enlazados se deslizan juntos y se funden en un solo nodo más brillante
Figura 2. Dos nodos Organization de un mismo negocio se unen en un solo nodo cuando solo un plugin o una opción del tema genera el identificador.

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.

Prueba rápida: @id y sameAs

Elija una respuesta para ver comentarios. Nada se califica ni se guarda.

Pregunta 1 de 3

¿Cuál es el mejor uso de sameAs?

Pregunta 2 de 3

¿Qué identifica @id en un grafo JSON-LD?

Pregunta 3 de 3

¿Cómo documenta Google las propiedades de su función Organization?

Términos del marcado de entidades

Seleccione un término para ver su definición.

Entidad. Una persona, organización, producto, lugar u otra cosa distinta que se describe.