Guía práctica · Inspeccia

Dónde pegar el JSON-LD de tu negocio

La ficha que recibiste es un bloque de datos estructurados en formato JSON-LD. No se pega dentro del texto de una página y no cambia el diseño de tu web. Se instala una sola vez en el código global del sitio, normalmente antes de la etiqueta de cierre </head>.

Respuesta corta

Copia el bloque completo, desde <script> hasta </script>, y colócalo en el encabezado global de tu sitio. Si ya existe otro bloque Organization o LocalBusiness sobre el mismo negocio, no agregues un duplicado: reemplázalo o combina los campos.

Google explica que los datos estructurados aportan pistas explícitas para entender una página y recomienda JSON-LD porque suele ser el formato más fácil de implementar y mantener. Eso no significa que sea un atajo de ranking: una ficha correcta puede ayudar a interpretar el nombre, el sitio, el teléfono, los horarios y los perfiles oficiales, pero no garantiza una posición ni una recomendación.

Antes de pegarlo: cuatro comprobaciones

  • Completa únicamente datos reales. Sustituye cualquier texto como “TU TELÉFONO” y elimina los campos que no correspondan.
  • No inventes una dirección. Si no atiendes públicamente en un local, no publiques una dirección privada para completar el schema.
  • Usa perfiles oficiales en sameAs. No incluyas directorios, competidores ni perfiles que no controles.
  • Busca un bloque anterior. En el código fuente de tu home, busca application/ld+json y el nombre de tu negocio.

Elige la plataforma de tu sitio

WordPress y WooCommerce

La vía más sencilla es un gestor de código de encabezado. WooCommerce usa el mismo procedimiento.

  1. En el escritorio de WordPress, revisa primero si tu plugin SEO ya gestiona el schema de la empresa.
  2. Si no lo hace, instala un plugin de encabezados como WPCode y actívalo.
  3. Ve a Code Snippets → Header & Footer y pega la ficha completa en Header.
  4. Guarda los cambios, vacía la caché si usas un plugin de caché y valida la home publicada.

WooCommerce: conserva los datos Product, precio, stock y opiniones que genera la tienda. La ficha de Inspeccia reemplaza o completa la identidad del negocio; no debería borrar el schema de cada producto.

WordPress.com

No es lo mismo que un WordPress instalado en tu propio hosting.

  1. Comprueba que tu plan permita agregar código al encabezado. WordPress.com documenta esta función para planes Personal, Premium, Business y Commerce.
  2. Instala y activa Insert Headers and Footers by WPCode.
  3. Abre Code Snippets → Header & Footer, pega el bloque en Header y guarda.
  4. Abre el sitio publicado, no sólo el editor, y realiza la validación final.

En un plan gratuito, WordPress.com restringe las etiquetas <script>. No lo pegues como bloque visible: el editor puede eliminarlo o mostrarlo como texto.

Shopify

La identidad del negocio va en el layout general del tema.

  1. En Shopify, duplica el tema antes de editarlo. Así puedes volver atrás si fuera necesario.
  2. Ve a Online Store → Themes → … → Edit code.
  3. Abre Layout → theme.liquid y busca </head>.
  4. Pega la ficha justo antes de esa línea, guarda y comprueba la tienda publicada.

No elimines el schema de productos que Shopify o una aplicación ya genera. Después de una actualización o cambio de tema, verifica que el bloque siga presente en el nuevo tema publicado.

Wix

Wix ofrece un área específica de código invisible para todo el sitio.

  1. Asegúrate de que el sitio esté publicado y tenga un dominio conectado.
  2. En el panel, abre Settings → Development & integrations → Custom Code.
  3. Pulsa + Add Custom Code, pega el bloque y ponle un nombre como “Identidad del negocio”.
  4. Elige All pages, que cargue en cada página, y como ubicación selecciona Head. Luego pulsa Apply.

No uses el área de contenido visible ni “Header Code Meta Tags”: esa sección admite etiquetas meta, pero no scripts JSON-LD. Usa Custom Code.

Squarespace

La inyección de código global coloca la ficha dentro de <head> en todas las páginas.

  1. Abre el panel de Code Injection de tu sitio.
  2. Pega el bloque completo en el campo Header.
  3. Guarda y revisa la web pública en una ventana nueva.

Code Injection está disponible en determinados planes. Squarespace ya genera algunos datos automáticamente: busca el nombre del negocio en los bloques JSON-LD antes de sumar otro equivalente.

Webflow

Usa el código global del sitio, no un elemento visible dentro del diseñador.

  1. Ve a Site settings → Custom code.
  2. Pega la ficha en el campo Head code. No agregues etiquetas <html>, <head> ni <body> alrededor.
  3. Pulsa Save changes y vuelve a publicar el sitio.
  4. Comprueba la URL pública: los cambios no quedan online hasta publicar.

HTML propio o una web desarrollada a medida

Busca el archivo común que construye el encabezado de todas las páginas.

  1. Abre la plantilla, layout o componente donde aparecen <head> y </head>.
  2. Pega el bloque completo justo antes de </head>.
  3. Publica el cambio y comprueba que aparezca en el código fuente de la home.

Si el sitio usa React, Next.js, Laravel u otro framework, la ubicación concreta cambia, pero el criterio es el mismo: debe salir en el HTML de la página pública. Evita Google Tag Manager si tienes acceso al layout; el código directo es más simple y no depende de que otro sistema ejecute JavaScript.

Otra plataforma

Busca en los ajustes: “Custom code”, “Code injection”, “Header code”, “Head” o “Integrations”.

  1. Elige una opción que aplique código a todo el sitio, no un bloque de contenido de una sola página.
  2. Selecciona la ubicación Head o “antes de </head>”.
  3. Pega el bloque completo, publica y valida la URL real.

La instrucción concreta que puedes copiar para soporte es: “Quiero reemplazar el JSON-LD Organization o LocalBusiness de mi sitio por este bloque, cargado globalmente en el HTML y sin duplicarlo”.

Cómo comprobar que quedó bien

  1. Publica primero. Los validadores no pueden leer un borrador o una vista privada.
  2. Abre el Test de resultados enriquecidos de Google. Pega la URL de tu home y ejecuta la prueba.
  3. Revisa los datos. El nombre, el dominio, el teléfono, los horarios y la dirección —si corresponde— deben ser reales y coincidir con tu web.
  4. Inspecciona la URL en Search Console. Cuando todo esté correcto, solicita la indexación de la home.
La regla que evita problemas

Una sola identidad, completa y coherente. Tener dos bloques que describen al mismo negocio con teléfonos, nombres o direcciones distintos es peor que tener uno corto pero verdadero.

Qué beneficio tiene —y qué no hace

La ficha transforma datos dispersos en campos con nombre: “esto es una empresa”, “este es su sitio oficial”, “este es su teléfono” y “estos son sus perfiles”. Google dice que usa los datos estructurados para comprender el contenido de una página y reunir información sobre empresas y otras entidades.

Para las funciones con IA de Google, la propia documentación pone un límite importante: no existe un schema especial que garantice entrar en AI Overview o Modo IA. La ficha es una base de identidad y consistencia, no un pase directo. Tiene que acompañar texto visible útil, indexación, menciones externas y datos públicos coincidentes.

Preguntas frecuentes

¿Dónde se pega exactamente el JSON-LD?

La opción más simple es pegar el bloque completo, incluida su etiqueta de apertura y de cierre, en el código global del sitio antes del cierre del encabezado. Así queda disponible en todas las páginas. Google también admite JSON-LD dentro del cuerpo, pero el encabezado global suele ser más fácil de mantener.

¿La ficha JSON-LD se ve en la página?

No. Es información para máquinas: no agrega texto, botones ni elementos visibles. Después de publicarla, puedes comprobarla mirando el código fuente o usando una herramienta de validación.

¿Qué hago si mi web ya tiene datos estructurados?

No pegues otra ficha equivalente sin revisar. Si ya existe un bloque Organization o LocalBusiness con tu negocio, actualiza o combina ese bloque. Conserva los datos de Product, Article, Breadcrumb u otros tipos que describan contenidos diferentes.

¿Agregar JSON-LD garantiza que apareceré mejor en Google o en una IA?

No. Los datos estructurados ayudan a interpretar la identidad y el contenido, pero no garantizan posiciones, resultados enriquecidos ni recomendaciones. Google aclara además que no existe un schema especial para entrar en AI Overview o Modo IA.

¿Cuándo tengo que actualizar la ficha?

Cada vez que cambien el nombre, el dominio, el teléfono, los horarios, la dirección pública o los perfiles oficiales. Los datos de la ficha deben coincidir con lo que una persona puede leer en tu web.

Fuentes oficiales consultadas

  1. Google Search Central — Introducción a los datos estructurados, LocalBusiness y funciones de IA y tu sitio.
  2. WordPress.com — Add code to headers.
  3. Shopify — Editing theme code.
  4. Wix — Embedding custom code.
  5. Squarespace — Using code injection.
  6. Webflow — Custom code in head and body tags.

¿La IA entiende bien quién es tu negocio?

Inspeccia compara lo que dice tu web con lo que encuentran Google y las herramientas de IA, y te entrega las correcciones concretas.

Analizar mi sitio gratis →