Marketing y comunicación, PHP, SEO, Wordpress

Datos estructurados Schema (JSON-LD) en WordPress

06
Dic

Qué es Schema markup y qué es JSON-LD

Cuando hablamos de Schema, schema markup, datos estructurados o structured data, nos referimos al mismo concepto: un sistema de “etiquetas” estandarizadas que permiten describir tu web con precisión. Estas etiquetas indican a los buscadores qué tipo de negocio eres, qué servicios ofreces, qué vendes, cómo está organizada tu información o qué representa cada página.

Este marcado, conocido también como schema markup, se implementa habitualmente en formato JSON-LD, que es la forma técnica en la que estas etiquetas se escriben dentro de una web para que Google, Bing o las IAs puedan leerlas sin dudas. Dicho de forma simple: Schema es el significado; JSON-LD es la manera de expresarlo.

Cuando los motores de búsqueda interpretan correctamente este marcado, pueden generar mejores resultados enriquecidos —los famosos rich snippets— y clasificar tu sitio con mayor claridad, algo que en el ámbito SEO se conoce como Schema SEO. Al combinar un contenido bien trabajado con unos datos estructurados precisos, ayudas tanto al algoritmo tradicional como a los modelos de IA a comprender tu web de forma más consistente y sin ambigüedades.

Qué tipo de datos son interpretados por Schema

Schema está diseñado para que una web pueda describir de forma explícita casi cualquier información relevante sobre su contenido, su estructura y su actividad. Los buscadores interpretan estos datos como señales claras y organizadas que les permiten entender el contexto de tu sitio sin tener que deducirlo únicamente del texto o del HTML.

En términos prácticos, Schema puede interpretar:

Datos sobre tu negocio o entidad

Información que define quién eres:

  • Nombre de la empresa
  • Tipo de negocio (agencia, tienda, profesional, asociación…)
  • Dirección, teléfono, email
  • Área de servicio
  • Redes sociales
  • Logo e imagen principal
  • Identidad de marca

Este bloque suele implementarse con Organization, LocalBusiness o ProfessionalService.

Datos sobre tus servicios

Permite describir con claridad qué ofreces:

  • Nombre del servicio
  • Descripción
  • Precio o rango de precios (opcional)
  • Público objetivo
  • Categoría
  • Disponibilidad

Aquí se usan tipos como Service y páginas definidas como WebPage o ServicePage.

Datos de productos (si tienes tienda o catálogo)

Schema interpreta:

  • Nombre del producto
  • Marca
  • Precio
  • Disponibilidad
  • Variante o modelo
  • Opiniones y valoraciones
  • Imágenes del producto

Google emplea Product, Offer y AggregateRating para estructurar esta información.

Datos sobre tus páginas internas

Cada tipo de página puede ser descrita:

  • Home (WebSite + WebPage)
  • Página de contacto (ContactPage)
  • Página de servicios (ServicePage)
  • FAQs (FAQPage)
  • Sobre nosotros (AboutPage)
  • Blog o noticias (BlogPosting / Article)

Esto ayuda a que Google y las IAs entiendan mejor la intención de cada URL.

Datos de contenido editorial (artículos, guías, noticias)

Las IAs lo valoran enormemente:

Título

  • Autor
  • Fecha de publicación
  • Categoría
  • Imagen destacada
  • Resumen
  • Tema principal

Se implementa con Article o BlogPosting.

Datos de eventos, vídeos e imágenes

Schema interpreta información enriquecida como:

  • Fecha, lugar y horario de eventos
  • Vídeos alojados en YouTube u otra plataforma
  • Imágenes clave de la página
  • Contenido multimedia relevante

Con tipos como Event, VideoObject e ImageObject.

Preguntas frecuentes y guías paso a paso

Dos de los formatos que mejor entienden los buscadores y las IAs:

  • FAQPage para preguntas y respuestas
  • HowTo para tutoriales estructurados

Ambos facilitan que tu contenido aparezca como respuesta directa.

Datos sobre personas o profesionales

En proyectos donde hay figuras relevantes:

  • Nombre
  • Puesto
  • Redes
  • Estudios
  • Imagen
  • Relación con la empresa

Usando el tipo Person.

Premios, logros o certificaciones

Los siguientes campos son perfectamente válidos dentro de Organization, Person, LocalBusiness o ProfessionalService:

  • Award → Premios recibidos
  • MemberOf → Asociaciones en las que formas parte
  • Affiliation → Colaboraciones y vínculos profesionales
  • Accreditation → Certificaciones oficiales
  • HasCredential → Diplomas, formaciones reconocidas

Ficha Schema descargable + ejemplo real

Si quieres implementar datos estructurados en tu web sin perderte entre conceptos técnicos, esta ficha te lo pone muy fácil. Hemos creado una plantilla profesional de datos Schema para WordPress, diseñada para que puedas organizar toda la información que después convertirás en un marcado JSON-LD válido para Google, Bing y las IAs de búsqueda.

En ella podrás reunir, de forma ordenada, todos los datos que intervienen en un buen Schema: identidad del negocio, estructura de páginas, servicios, productos, artículos, FAQs, multimedia, buscador interno, equipo, premios, certificaciones y señales de autoridad. Una vez completada, solo tendrás que convertirla en JSON-LD mediante un generador automático, un plugin o un modelo de IA como ChatGPT.

Además de la ficha vacía, te ofrecemos un ejemplo real completamente cumplimentado con los datos de Marabelia. Este ejemplo te servirá como guía visual para entender cómo debe rellenarse cada campo y también como base perfecta para crear tus propios prompts para IA. Puedes copiar la estructura, modificarla con tus datos y pedir a ChatGPT que genere el Schema final de forma precisa y validable.

Descarga la plantilla, revisa el ejemplo y empieza a crear un Schema limpio, estructurado y listo para mejorar la claridad semántica y la comprensión de tu web en buscadores e IAs.

MODELO DE FICHA SCHEMA DESCARGABLE
MODELO DE FICHA SCHEMA CUMPLIMENTADA

¿Cómo convertir la ficha de Excel en código Schema para tu web WordPress?

Una vez que completas la ficha en Excel, el siguiente paso consiste en transformar toda esa información en un código JSON-LD, que es el formato oficial recomendado por Google para los datos estructurados. El Excel no se sube a WordPress: simplemente organiza la información que después utilizarás para generar tu Schema.

Paso 1: Convertir la ficha en código Schema usando una IA

Con tu ficha ya cumplimentada, abre una herramienta de IA —como ChatGPT, Gemini, Claude o Perplexity— y pídele que convierta esos datos en un JSON-LD válido. Si utilizas Chat GPT te pedirá que le subas el archivo en CSV, PDF o texto plano.

Basta con subirle la información en cualquiera de estos formatos y utilizar un prompt adecuado:

Genera un Schema Global completo para mi web en un solo bloque JSON-LD, usando únicamente los datos reales de mi ficha. Ignora todos los campos vacíos y no inventes nada. El script debe contener: Organization: datos de identidad, dirección, contacto, logo, imagen, redes sociales, premios, certificaciones, membresías, acreditaciones, especialidades y equipo. Catálogo global: lista general de servicios y productos usando makesOffer y hasOfferCatalog, solo como ofertas generales (sin detalles por página). WebSite: información básica del sitio y su publisher. Reglas: Todo debe ir en un único @graph dentro del mismo JSON-LD. No generes schemas de página.Solo quiero el bloque JSON-LD final, sin explicaciones. Aquí están mis datos: <<< ADJUNTA EL CSV, PDF, WORD O EL TEXTO PLANO CON LOS DATOS >>>

La IA devolverá un bloque similar a este:

<script type="application/ld+json">
{
...tu schema generado...
}
</script>

Ese bloque será el que introducirás en tu WordPress.

Si quieres un Schema que funcione y valide 100% también puedes agregar al prompt de la IA un Schema de ejemplo. Te proporcionamos nuestra plantilla Schema que está totalmente validada y que puedes descargar AQUÍ (JSON BASE MODELO), descomprimir y adjuntar a la IA sumándole al final del Prompt:

Adjunto un modelo JSON-LD validado de otra empresa para que lo tomes como referencia: copia exactamente su estructura y sustituye únicamente los valores por los datos de mi empresa.

¿Qué tipo de código es el Schema generado por la IA?

El Schema que genera la IA está escrito en JSON-LD, un formato de datos pensado para que Google y las IAs entiendan la información de tu web. No es HTML, no es PHP y no es JavaScript ejecutable. Es simplemente un bloque de datos estructurados que el navegador no muestra y que WordPress no interpreta: solo lo leen los motores de búsqueda.

Por su naturaleza, este tipo de código no modifica la apariencia de la web, no interactúa con el contenido y no requiere programación. Solo necesita estar presente en la página para que los buscadores puedan procesarlo.

Gracias a esto, JSON-LD se puede colocar fácilmente usando un plugin de scripts, el panel de scripts del tema, el child theme o un bloque HTML dentro de la página correspondiente, según lo que necesites.

Paso 2: Integrar el Schema generado por la IA en tu web WordPress

Una vez tienes tu código JSON-LD listo, puedes insertarlo en tu web de diferentes formas según el tipo de marcado y tu nivel de personalización. Como este código no modifica el diseño ni ejecuta funciones, solo necesita aparecer en el HTML final de la página para que Google y las IAs puedan leerlo.

➡ Opción A (¡recomendada!): Integración global para toda la web

Si el Schema describe información general —por ejemplo, Organization, WebSite o datos de identidad del negocio— lo ideal es colocarlo en una zona que se cargue en todas las páginas.

Opciones habituales en WordPress:

  • Área de Header Scripts del tema (Flatsome, Astra, GeneratePress, Divi…)

  • Plugins como WPCode o Code Snippets

  • El child theme, si prefieres gestionarlo vía código

Esta ubicación asegura que Google lo encuentre en todas las URLs del sitio.

⚠️ ¡importante! El formato para JSON-LD: ¿HTML o PHP?

Antes de generar tu Schema Global con ayuda de una IA, necesitas tener claro en qué formato lo vas a insertar dentro de tu WordPress.
Existen dos escenarios posibles:

  • Pegar HTML o scripts directamente ¡Recomendado!
    Muchas plantillas para WordPress integran un área específica para scripts o html, esto es ideal pues si tu template te lo permite, puedes insertar el Schema en formato HTML, dentro de una etiqueta <script type="application/ld+json"> que es la forma más directa y cómoda.

Si tu plantilla no integra la función de agregar scripts, puedes instalar algún plugin que te permita hacerlo como WP Header and Footers o Header Footer Code Manager.

 

  • Pegar en formato PHP (Opcional)
    Algunos plugins como Code Snippets no permiten en su versión gratuita pegar HTML ni scripts, así que si decides utilizar la vía de PHP la IA debe generarte el Schema dentro de una función PHP que lo imprima automáticamente en el <head> del sitio. Es igual de válido, pero necesita un formato distinto.

Para evitar errores y facilitar la vida al usuario —especialmente si no domina programación—, en esta guía incluimos dos prompts diferentes:
uno para generar Schema en formato HTML y otro para generarlo directamente en PHP. Ambos usarán exactamente los mismos datos, pero están adaptados a las limitaciones técnicas de cada método de inserción.

A partir de aquí solo tienes que escoger qué prompt te corresponde según dónde vayas a pegar tu Schema, aunque recomendamos la opción HTML/SCRIPT.

PROMPT Opción 1 y recomendada (HTML):

Genera mi Schema Global en un único bloque JSON-LD dentro de la etiqueta <script type="application/ld+json">, utilizando únicamente los datos reales de la ficha que te voy a entregar.
Ignora los campos vacíos y no inventes información. El Schema debe incluir todos los datos proporcionados, dentro de un único @graph.No generes schemas individuales (Service, Product, FAQPage, WebPage). Solo el Schema Global. Devuélvelo solo como un bloque HTML listo para pegar en el header del sitio, sin explicaciones adicionales. Aquí están mis datos: <<<ADJUNTA FICHA CON LOS DATOS EN UN FORMATO ADMITIDO >>>

PROMPT Opción 2 (PHP):

Genera mi Schema Global en formato JSON-LD envuelto dentro de una función PHP que lo imprima en el <head> del sitio usando add_action('wp_head', ...), utilizando únicamente los datos reales de la ficha que te voy a entregar. Ignora los campos vacíos y no inventes información. El Schema debe incluir todos los datos proporcionados, dentro de un único @graph. No generes schemas individuales (Service, Product, FAQPage, WebPage). Solo el Schema Global. Devuélveme solo el snippet PHP final listo para pegar en Code Snippets, sin texto adicional. Aquí están mis datos: <<<ADJUNTA FICHA CON LOS DATOS EN UN FORMATO ADMITIDO >>>

⚠️ Atención si usas Yoast SEO (o plugins similares como RankMath o SEOPress)

Si tienes instalado Yoast SEO —o cualquier plugin similar de SEO— es muy probable que ya esté generando automáticamente sus propios datos Schema básicos (Organization, WebPage, BreadcrumbList, logo, etc.).
Esto significa que, si añades tu propio Schema personalizado, Google verá dos versiones de la misma información y puede mezclar datos antiguos con los nuevos.

Para evitar duplicidades, debes desactivar el Schema automático del plugin usando un pequeño código en algún agregador de funciones PHP como Code Snippets o WP Code (modo PHP) o directamente en tu archivo functions.php:

add_filter( 'wpseo_schema_graph_pieces', '__return_empty_array' );
add_filter( 'wpseo_schema_webpage', '__return_false' );
add_filter( 'wpseo_schema_organization', '__return_false' );
add_filter( 'wpseo_schema_person', '__return_false' );
add_filter( 'wpseo_schema_webpage_type', '__return_false' );
add_filter( 'wpseo_schema_output', '__return_false' );

Con este ajuste, el plugin seguirá funcionando normalmente para el SEO, pero solo tu Schema personalizado aparecerá en Google, limpio y sin interferencias.

Otras opciones avanzadas

Opción B (opcional): Integración por página: servicios, productos, artículos y FAQs

Cuando el Schema corresponde a contenido concreto —como un servicio, un producto WooCommerce, una página de FAQs o un artículo del blog— debe colocarse únicamente en esa URL. Esto ayuda a evitar duplicidades y mantiene la semántica limpia.

Puedes insertarlo desde:

  • Un bloque HTML en Gutenberg

  • Un módulo de código en WPBakery o Elementor

  • Un campo personalizado si usas ACF o plantillas avanzadas

Así cada página tiene su propio Schema individual y bien definido.

Opción C (opcional): Integración en productos WooCommerce

WooCommerce genera un Schema básico automáticamente, pero si quieres utilizar uno propio:

  • Puedes añadir tu JSON-LD en la edición del producto mediante un bloque HTML

  • O usar plugins avanzados que permiten desactivar o reemplazar el Schema por defecto

Esto te da control total sobre cómo Google interpreta tus fichas de producto.

Validación final del Schema (el paso que nunca debes saltarte)

Antes de dar por terminado tu Schema Global, es imprescindible comprobar que Google lo entiende sin errores. La mejor forma de hacerlo —y además la más sencilla para cualquier usuario— es empezar por:

👉 https://validator.schema.org/

Esta herramienta muestra el resultado de tu JSON-LD de forma clara, separada en bloques (Organization, Website, Services, Products…), para que puedas identificar visualmente:

  • Si el Schema está bien formado

  • Si hay errores de sintaxis

  • Si falta algún campo obligatorio

  • Si los identificadores @id se interpretan correctamente

  • Si existe algún duplicado o conflicto con otros plugins

Solo tienes que pegar tu código en el cuadro de validación o introducir la URL de tu sitio. En segundos verás un panel con:

  • ✔ Señales verdes: todo correcto

  • ⚠ Advertencias: opcionales, no afectan

  • ❌ Errores críticos: deben solucionarse antes de publicar

Una vez el validador muestra 0 errores, tu Schema está listo para aparecer correctamente interpretado en motores como Google, Bing, ChatGPT, Perplexity y cualquier IA que consuma datos estructurados.

🛠️ Revisa Search Console para detectar avisos de Schema

Después de implementar tu Schema Global y los marcados individuales de la web, es importante revisar periódicamente Google Search Console.
La herramienta detecta cualquier problema relacionado con los datos estructurados: desde campos faltantes o formatos incorrectos, hasta incompatibilidades entre tipos de Schema o errores en fichas de productos y servicios.

Este monitoreo continuo te permite asegurarte de que Google interpreta tu contenido correctamente, evitando advertencias que puedan limitar tu presencia en rich results. Mantener estos avisos bajo control es clave para que tu estrategia de Schema y SEO técnico siga siendo sólida, limpia y efectiva.

Los datos enriqecidos que elevan tu SEO

Implementar un Schema Global bien estructurado no es solo un detalle técnico: es una ventaja estratégica. Cuando describes tu negocio con precisión, los buscadores y las IAs entienden mejor quién eres, qué ofreces y cómo deben mostrar tu contenido. El resultado es una presencia digital más clara, más sólida y mucho más competitiva.

Con la ficha de datos, el modelo de JSON-LD y las herramientas de validación, ya tienes todo lo necesario para construir un marcado limpio, fiable y a prueba de errores. A partir de aquí, cada empresa puede adaptar su Schema, actualizarlo cuando evolucione su web y mantenerlo alineado con las nuevas formas en las que la búsqueda —humana y automática— interpreta la información.

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *