Cómo añadir schema markup en Shopify sin romper tu tema

¿Qué es el schema markup y qué incluye Shopify por defecto?

El schema markup es un bloque de datos estructurados en formato JSON-LD que etiqueta el contenido de una página para que los buscadores y los motores de respuesta con IA puedan leerlo sin tener que adivinar nada. En una página de producto indica: esto es un producto, este es su precio, esta es su valoración, estas son las reseñas. Google lo usa para mostrar la valoración con estrellas, el precio y la disponibilidad debajo de tu resultado.

Los temas de Shopify ya incluyen algunos datos estructurados, normalmente un bloque básico de Product, pero rara vez incluyen Review o aggregateRating, porque el tema no tiene reseñas propias que describir. Ese es el hueco que debes cubrir: conectar tus datos de reseñas al markup de Product para que las estrellas puedan aparecer.

¿Qué tipos de schema necesitan las reseñas de producto?

Para obtener rich snippets, Google necesita un bloque Product que contenga Review, aggregateRating o ambos. El bloque Product lleva el nombre, la imagen y las ofertas. El aggregateRating lleva la puntuación media y el número de reseñas. Cada Review lleva el autor, la puntuación y el cuerpo de la reseña.

La regla que más sorprende: las reseñas y la valoración en tu markup deben ser visibles en la página. No puedes marcar un aggregateRating de 4,8 con 200 reseñas si la página no muestra ninguna. Google lo interpreta como contenido engañoso y elimina el rich snippet de toda la página.

• Product: nombre, imagen y ofertas (precio, moneda, disponibilidad).
• aggregateRating: el valor de la valoración y el número de reseñas, coincidiendo con lo que muestra la página.
• Review: autor, reviewRating y cuerpo de la reseña, para cada reseña individual visible en la página.

¿Editas el JSON-LD del tema, usas una app o un generador de schema?

Hay tres opciones reales, y cada una equilibra control y seguridad de forma diferente. Editar el JSON-LD del tema te da el máximo control, pero implica tocar Liquid, donde una coma fuera de lugar rompe el bloque en silencio. Dejar que una app de reseñas inyecte el schema es la vía más sencilla, pero heredas la estructura que emite la app, y algunas la inyectan del lado del cliente, donde los rastreadores pueden no verla. Un generador de schema está en el punto medio: pegas tus valores reales, obtienes un JSON-LD válido y añades un bloque limpio a la página.

Si no te sientes cómodo con el código del tema, empieza por el generador. Es la forma con menor riesgo de incluir un bloque correcto en la página, y puedes pegar el resultado directamente en una sección de Liquid personalizada sin reescribir el tema.

• JSON-LD del tema: máximo control, mayor riesgo de un error de sintaxis silencioso.
• Inyección por app: mínimo esfuerzo, pero verifica que aparezca en el código fuente de la página, no solo en el navegador.
• Generador de schema: pegas valores reales, obtienes JSON-LD validado e insertas un solo bloque.

¿Cómo añades el markup sin romper el tema de Shopify?

Nunca pegues schema en medio de un bloque JSON-LD existente. Añádelo como un script propio e independiente. En el editor del tema, añade una sección de Liquid personalizada (o edita la plantilla de producto) y coloca un nuevo script de tipo application/ld+json con tu bloque Product. Mantenerlo separado significa que un error en tu bloque no puede corromper el bloque del tema, y viceversa.

Antes de guardar, duplica el tema para tener una copia de respaldo limpia. Luego añade el bloque, guarda y revisa el código fuente de la página de producto en vivo para confirmar que el JSON-LD está en el HTML sin procesar, no solo después de ejecutar los scripts. Si tus reseñas las inyecta una app tras la carga de la página, la opción más segura es que la app las renderice del lado del servidor, o vincular el resultado del generador a valores que ya estén impresos en la página.

¿Cómo valido el schema y cómo se ve un error?

Pasa cada plantilla de producto por dos pruebas: el Rich Results Test de Google para comprobar la elegibilidad, y el validador de Schema.org para la sintaxis. El Rich Results Test indica si el Product es apto para mostrar estrellas y señala los campos obligatorios que faltan. El validador de Schema.org detecta JSON mal formado que el test de rich results puede pasar por alto.

El error más frecuente no es de sintaxis. Es una advertencia de que la valoración no tiene reseñas visibles, o de que los valores del markup no coinciden con la página. Esa es la regla de coincidencia de nuevo. Corrígela haciendo que el markup describa exactamente lo que el cliente puede ver, y vuelve a validar antes de dar el paso por completado.

• Rich Results Test: confirma la elegibilidad del Product y lista los campos que faltan.
• Validador de Schema.org: detecta JSON mal formado que el test de rich results puede pasar por alto.
• Ver el código fuente de la página en vivo: confirma que el bloque está en el HTML sin procesar.

¿Qué errores anulan el schema sin que lo notes?

La mayor parte del schema anulado es técnicamente válido y aun así se rechaza, porque describe algo que la página no muestra. Los casos más habituales: un aggregateRating sin reseñas renderizadas en la página, un recuento de reseñas en el markup que no coincide con el de pantalla, o markup de Product o Review en una página que en realidad es una categoría o la portada de la tienda, no un producto individual.

La versión más profunda de este problema es la legibilidad. Muchas apps de reseñas se construyeron pensando en el cliente que navega la tienda y se quedaron ahí: las estrellas se ven bien en el navegador, pero el texto de las reseñas y la valoración están encerrados en un Widget que los rastreadores y los motores de respuesta con IA no pueden leer, de modo que el markup describe un contenido que la máquina nunca ve. Hacer que tus reseñas existentes sean legibles, verificables y citables en Google y en la búsqueda con IA es el hueco que BeyondReviews está diseñado para cerrar.

• aggregateRating presente, pero sin reseñas renderizadas en la página.
• Recuento o media de reseñas en el markup que no coincide con los números visibles.
• Markup de Product o Review en una página que no es un producto individual.
• Reseñas atrapadas en un Widget del lado del cliente que el rastreador no puede leer.

Lo que todo esto significa

Un schema limpio en Shopify tiene tres elementos: un bloque Product independiente, reseñas reales visibles en la página, y un markup cuyos valores coinciden exactamente con lo que el cliente ve. Añádelo como su propio script para que no pueda romper el tema, genéralo a partir de tus cifras reales en lugar de escribirlo a mano, y valida cada plantilla antes de darlo por terminado.

Haz eso y las estrellas, el precio y el número de reseñas serán elegibles para aparecer en tu resultado de Google. Omite la regla de coincidencia y el markup será válido e ignorado, que es lo peor de los dos mundos: trabajo hecho, nada visible.