El atributo product_detail de Google admite hasta 100 entradas por producto, de entre 1 y 150 caracteres cada una, y product_highlight exige al menos 2 y recomienda entre 4 y 6 frases breves sobre beneficios por artículo, según las especificaciones de Google sobre product detail y product highlight. Ambos son opcionales, por lo que la mayoría de los feeds los omiten o pegan una tabla de especificaciones que Merchant Center marca como mal formateada.
Google afirma que product_detail ayuda a que los productos aparezcan en superficies de IA como AI Mode, y en mayo de 2026 añadió más atributos conversacionales basados en la misma idea.
Esta referencia está dirigida a gestores de feeds y agencias que envían datos de producto a Google Merchant Center. Al terminar, sabrá redactar ambos atributos en TSV y XML, escapar los caracteres que los rompen, evitar el contenido prohibido y puntuar una fila antes de enviarla.
Para qué sirven product_detail y product_highlight
Los dos atributos se parecen y a menudo se rellenan desde la misma fuente, pero Google les asigna funciones distintas. product_detail recoge especificaciones técnicas y verificables que no cubre otro atributo: contenido del paquete, conectividad, ingredientes, requisitos de alimentación, acabado, aroma y datos similares. product_highlight recoge beneficios de venta breves, escritos como frases sencillas.
Nuestra prueba rápida: si la línea encaja en una tabla de especificaciones con una etiqueta y un valor, es un product_detail. Si suena como una frase que diría un dependiente en la tienda, es un product_highlight. La especificación de Google para highlights hace la misma distinción y pide no repetir uno en el otro.
La especificación de un vistazo
Estos son los límites tal como Google los publica hoy. Google no indica ninguna propiedad de schema.org para product_detail, por lo que no se toma de su marcado de datos estructurados; tiene que estar en el feed.
| Propiedad | product_detail | product_highlight |
|---|---|---|
| Estado | Opcional | Opcional |
| Estructura | Grupo de tres subatributos: section_name (opcional, recomendado), attribute_name (obligatorio), attribute_value (obligatorio) | Una sola cadena de texto |
| Longitud | De 1 a 150 caracteres por detalle | De 1 a 150 caracteres por highlight |
| Cantidad | Hasta 100 por producto | Mínimo 2, máximo 100, recomendado de 4 a 6 |
| Juego de caracteres | Se permite Unicode, se recomienda ASCII | Se permite Unicode, se recomienda ASCII |
| Formato de feed de texto | Se recomienda TSV; los dos puntos separan subatributos y las comas separan detalles | Se recomienda TSV; las comas separan highlights |
| Idioma | Localice sección, nombre y valor en cada feed por idioma | La mayor parte del texto debe coincidir con el idioma del feed |
Fuentes: Ayuda de Google Merchant Center, Product detail [product_detail] y Product highlight [product_highlight].
Cómo redactar product_detail en TSV, XML y la Merchant API
El formato es donde fallan la mayoría de las filas. Cada detalle consta de tres valores unidos por dos signos de dos puntos, en este orden: nombre de sección, nombre de atributo y valor del atributo. Google es explícito: en los feeds de texto cada detalle debe llevar dos signos de dos puntos, y enviar un número de subatributos distinto del declarado en la cabecera genera un problema de formato de subatributo no válido en "Requiere atención".
Cabecera TSV y una sola celda
Declare los subatributos en la cabecera de la columna, entre paréntesis y separados por dos puntos. Una vez nombrados en la cabecera, los valores pueden seguir el orden que haya declarado. Sin la declaración, Google asume sección, nombre, valor.
product_detail(section_name:attribute_name:attribute_value)
Una celda con tres detalles tendría este aspecto:
General:Brew type:Turkish coffee,General:Capacity:4 cups,Power:Rated power:1000 W
Si un detalle no tiene sección, mantenga los dos puntos iniciales y deje vacío el primer campo:
:What's in the box?:"Machine,Measuring spoon,User manual"
Escapar dos puntos, comas y comillas
Las reglas de Google sobre atributos entrecomillados se aplican a atributos de grupo como este:
- Encierre entre comillas dobles rectas cualquier valor de subatributo que contenga una coma o dos puntos. Entrecomille el valor individual, no el grupo entero.
- Escriba una comilla doble literal como dos comillas dobles. El ejemplo de Google es
"APS-C max. 12"""para un valor que termina en el símbolo de pulgadas. - No utilice el escape con barra invertida. Google interpreta la barra invertida como un carácter literal.
- Los campos entrecomillados no son compatibles con las fuentes de datos de Google Sheets. En las fuentes de archivo existentes, hay que activar los campos entrecomillados en la configuración de la fuente de datos.
XML
En XML cada detalle es un elemento propio con tres hijos, así que no hace falta escapar dos puntos ni comas:
<g:product_detail><g:section_name>Materials</g:section_name><g:attribute_name>Body</g:attribute_name><g:attribute_value>Stainless steel, BPA-free plastic</g:attribute_value></g:product_detail>
Para categorías con muchas especificaciones, XML es el formato más seguro, porque las comas y los dos puntos naturales dejan de ser un riesgo de análisis.
Merchant API
A través de la Merchant API, cada detalle es un objeto ProductDetail con los campos sectionName, attributeName y attributeValue, según la referencia del cliente de la API.
Cómo redactar product_highlight
Los highlights son más sencillos: una cadena por highlight. En un feed de texto, separe los highlights con comas y encierre entre comillas dobles cualquier highlight que contenga una coma o dos puntos. En XML, dé a cada highlight su propio elemento <g:product_highlight>.
"Brews up to 4 cups in one cycle","Foam sensor stops brewing before the pot overflows","Switches off automatically after brewing","Stainless steel body wipes clean"
Limite cada uno a un único beneficio. Google pide un lenguaje profesional y gramaticalmente correcto, sin énfasis en mayúsculas, sin símbolos y sin lenguaje promocional.
Contenido que Google no permite en ninguno de los dos atributos
Los errores de formato generan avisos visibles. Los errores de contenido son más silenciosos: una fila puede ser aceptada y, aun así, incumplir la política. Esta tabla combina las prohibiciones de ambas especificaciones.
| No incluir | Se aplica a | Utilizar en su lugar |
|---|---|---|
| Precio, precio de oferta, fechas de oferta | Ambos | price, sale_price y atributos relacionados |
| Envío, fechas de entrega u otra información relacionada con plazos | Ambos | shipping y atributos relacionados |
| El nombre de su empresa | Ambos | Nada; omítalo |
| Palabras clave o términos de búsqueda | Ambos | Solo especificaciones o beneficios reales |
| Valores no confirmados, como un "False" por defecto | product_detail | Omita el detalle |
| Rutas de categoría | product_highlight | google_product_category, product_type |
| Enlaces a la tienda o al sitio web | product_highlight | link |
| Comparaciones con otros productos, accesorios o artículos compatibles | product_highlight | Describa solo el propio producto |
| Texto repetido del título, la descripción, question_and_answer o el otro atributo | Ambos | Mantenga cada dato en un único lugar |
Google añade una regla más que es fácil pasar por alto: si envía archivos document_link que ya contienen la misma información, déjela fuera de estos atributos y permita que Google la extraiga de los documentos.
Ejemplo práctico: una tabla de especificaciones convertida en filas aceptadas
A continuación se muestra una fila típica de una tienda que exporta las especificaciones de sus productos como un único campo de texto libre. El producto es una cafetera eléctrica de café turco; la tienda vende en Turquía y, en inglés, a los mercados del Golfo.
Antes
product_detail: Brand: Acme, Power: 1000W, Material: Stainless Steel, Plastic, FREE SHIPPING, best turkish coffee maker cheap
Cinco problemas en una sola celda. Los separadores están mezclados, así que el número de dos puntos no coincide con la cabecera. "Stainless Steel, Plastic" no está entrecomillado, de modo que su coma divide el detalle. Brand duplica el atributo brand. "FREE SHIPPING" es texto de envío en mayúsculas. El último fragmento es una cadena de palabras clave.
Después, feed en inglés
General:Brew type:Turkish coffee,General:Capacity:4 cups,Power:Rated power:1000 W,Materials:Body:"Stainless steel, BPA-free plastic",Safety:Automatic shut-off:Yes,:What's in the box?:"Machine,Measuring spoon,User manual"
La marca pasa a su propio atributo, el envío pasa a shipping, las palabras clave se eliminan, los valores van en minúsculas tras la inicial como recomienda Google y todo valor con coma se entrecomilla. "Automatic shut-off: Yes" se mantiene porque el fabricante lo confirma; un campo que su plataforma rellena por defecto con "No" no se mantendría.
Después, feed en turco
Google pide que los nombres de sección, los nombres de atributo y los valores se localicen en cada feed por idioma, de modo que el feed en turco tiene su propia fila en lugar de la inglesa:
Genel:Demleme türü:Türk kahvesi,Genel:Kapasite:4 fincan,Güç:Nominal güç:1000 W,Malzeme:Gövde:"Paslanmaz çelik, BPA içermeyen plastik",:Kutu içeriği:"Makine,Ölçü kaşığı,Kullanım kılavuzu"
Dos puntos regionales para los equipos fuera de Turquía. Primero, conserve las letras turcas. La recomendación de Google de usar ASCII es una preferencia, no un requisito, y su especificación de highlights permite expresamente las letras con acento; transliterar "Paslanmaz çelik" a "Paslanmaz celik" produce una falta de ortografía, lo que choca con las directrices de gramática y ortografía de Google. Segundo, si una regla convierte estos valores a minúsculas o a mayúscula inicial, necesita un tratamiento de mayúsculas y minúsculas sensible a la configuración regional para que "İ" e "I" no se conviertan en las letras equivocadas, un problema que tratamos en nuestra guía sobre mayúsculas y minúsculas en títulos en turco.
Cómo construir los valores a partir de su catálogo
Rellenamos estos atributos en cuatro pasadas, en este orden.
- Asigne primero las fuentes estructuradas. Liste todas las especificaciones que su plataforma ya almacena como pares de etiqueta y valor, como una pestaña de especificaciones, un metafield o un atributo del ERP. Cada par se convierte en un
product_detail, con el grupo de origen comosection_name. Utilice una capa de feed como Feed Rules o un feed complementario para que el catálogo de origen quede intacto y la salida para Google pueda diferir de la de otros canales. - Elimine todo lo que pertenezca a otro atributo. Suprima las líneas de marca, color, talla, material, precio y envío si ya están en sus atributos específicos. Después, suprima cualquier detalle cuyo texto ya aparezca en el título o la descripción.
- Redacte los highlights a mano o con borradores de IA revisados. Los highlights son donde el enriquecimiento con IA más ayuda y más falla. Un modelo escribirá sin problema "Ideal gift for coffee lovers", que es promocional, o inventará una característica que el producto no tiene. Genere borradores solo a partir de especificaciones confirmadas y revíselos con la tabla de prohibiciones anterior.
- Valide longitud y sintaxis antes de exportar. Compruebe que cada detalle y cada highlight tienen 150 caracteres o menos, que cada detalle tiene exactamente dos signos de dos puntos sin entrecomillar y que el número de highlights por producto es al menos 2.
Una rúbrica de puntuación para aplicar antes de enviar
Puntúe una muestra de 20 filas por categoría. Cada comprobación se supera (1) o no (0), con un máximo de 10 por fila. Consideramos que 9 o 10 es listo para enviar, 7 u 8 es corregir y luego enviar, y cualquier cifra inferior indica que los datos de origen necesitan trabajo antes de que merezca la pena enviar estos atributos.
| # | Comprobación | Condición para superarla |
|---|---|---|
| 1 | Número de dos puntos | Cada detalle tiene exactamente dos signos de dos puntos sin entrecomillar |
| 2 | Comillas | Todo valor que contiene una coma o dos puntos está entrecomillado; las comillas interiores se duplican |
| 3 | Longitud | Cada detalle y cada highlight tiene entre 1 y 150 caracteres |
| 4 | Número de highlights | De 2 a 100 highlights, idealmente de 4 a 6 |
| 5 | Sin datos comerciales | Sin texto de precio, oferta, envío, entrega o fechas |
| 6 | Sin duplicados | Ningún dato repetido del título, la descripción, la marca o el otro atributo |
| 7 | Solo valores confirmados | Sin valores por defecto de la plataforma ni valores supuestos |
| 8 | Sin palabras clave | Sin cadenas de términos de búsqueda ni sinónimos acumulados |
| 9 | Idioma | Sección, nombre y valor coinciden con el idioma del feed |
| 10 | Mayúsculas y minúsculas | Mayúscula solo inicial, sin énfasis en mayúsculas y con las letras locales correctas |
Dónde se queda corta esta guía
No sabemos en qué medida estos atributos influyen en el posicionamiento o el CTR. Google afirma que product_detail ayuda a que los productos aparezcan en consultas relevantes, también en AI Mode, pero no publica ninguna cifra, y no hemos visto ningún estudio público controlado. Desconfíe de los porcentajes de los proveedores hasta que vengan acompañados de un método.
Esta es una referencia de Google. La especificación de feed de producto de OpenAI no tiene un campo general de especificaciones clave-valor ni un campo de highlights; utiliza campos planos como material, dimensions y weight, además de una descripción de 5000 caracteres. Si también envía ese feed, tendrá que asignar sus especificaciones a esos campos o a la descripción. No hemos verificado los equivalentes de Meta o TikTok para esta guía.
También deja fuera los atributos conversacionales más recientes, como question_and_answer y document_link, más allá de la regla anterior sobre solapamientos. Varios proveedores de feeds, entre ellos Channable y Productsup, publicaron guías de mapeo para esos atributos antes que nosotros, y merece la pena leerlas si necesita ese conjunto ahora.
Por último, si su catálogo no tiene especificaciones estructuradas, este método no puede crearlas, y los borradores de IA sin una fuente confirmada son precisamente lo que la regla de Google de "enviar solo valores confirmados" pretende evitar.
Preguntas frecuentes
¿Es obligatorio product_detail en Google Merchant Center?
No. Google lo indica como opcional para todos los productos. Merece la pena añadirlo cuando disponga de especificaciones verificadas que ningún otro atributo cubra, porque Google afirma que ayuda a que los productos aparezcan en consultas relevantes, también en AI Mode.
¿Cuántos product highlights debo enviar?
Google exige al menos 2, permite hasta 100 y recomienda de 4 a 6 por producto. Cada highlight puede tener hasta 150 caracteres.
¿Por qué Merchant Center indica que mi product_detail tiene un formato de subatributo no válido?
El número de subatributos de un valor no coincide con la cabecera, normalmente porque a un detalle le falta un signo de dos puntos o porque una coma o dos puntos sin entrecomillar dentro de un valor lo ha dividido. Entrecomille todo valor que contenga esos caracteres y mantenga dos signos de dos puntos por detalle.
¿Debo usar caracteres turcos en un feed en turco?
Sí. Google acepta Unicode y recomienda ASCII solo como preferencia, mientras que su guía de highlights permite las letras con acento y pide una ortografía correcta. Eliminar las letras turcas genera palabras mal escritas.
¿Puede la IA redactar mis product highlights?
Puede redactar borradores, pero solo a partir de especificaciones que haya confirmado, y cada borrador debe revisarse para detectar lenguaje promocional, comparaciones y características inventadas. Google prohíbe las dos primeras en los highlights, y una característica inventada es sencillamente un dato de producto falso.
¿Admite Google Sheets valores de product_detail entrecomillados?
No. La guía de Google sobre atributos entrecomillados indica que los campos entrecomillados no son compatibles con las fuentes de datos de Google Sheets, por lo que es mejor enviar los valores de especificaciones con comas o dos puntos mediante un archivo TSV, XML o la Merchant API.
Revise su feed antes de añadir estos atributos
Estos atributos solo ayudan si los campos en los que se apoyan están limpios. Pase su feed por la herramienta gratuita de auditoría de feeds de productos para ver la integridad, la calidad y los problemas técnicos de cada producto antes de empezar a redactar detalles y highlights.
Kardelen Yılmaz trabaja en el área de crecimiento de Feedance, donde ayuda a marcas de comercio electrónico y agencias a obtener más rentabilidad de cada producto que anuncian. Escribe sobre la calidad del feed de productos, las campañas de Shopping y Performance Max, la automatización creativa y cómo las compras impulsadas por la IA están cambiando la visibilidad de los productos.
LinkedIn
