Bloques de Composición: Ingredientes, Materiales y Componentes

Un bloque de composición es una declaración estructurada de de qué está hecho un producto. Mantiene juntos los nombres de los ingredientes, tipos de materiales, cantidades de componentes, porcentajes, funciones y calificadores requeridos para que un comprador no tenga que reconstruir el producto a partir de fotografías del empaque o textos de marketing.

El elemento separa el producto y su alcance de cada componente y valor. «65% poliéster reciclado» solo tiene sentido cuando el lector sabe si describe la tela exterior, el forro, el relleno, la prenda completa o el empaque.

Por qué es importante este elemento

La composición afecta decisiones que los eslóganes del producto no pueden responder. Un comprador puede querer evitar un alérgeno, comparar el contenido de lana, verificar un revestimiento, elegir un empaque monomaterial reciclable o confirmar la concentración de un componente activo. Puede estar decidiendo si el producto es seguro, adecuado, mantenible, conforme a normativas o si vale su precio.

La estructura reduce ese costo de decisión. «Fabricado con algodón, poliéster reciclado y un revestimiento protector» deja que los lectores descubran a qué parte pertenece cada material y si la lista está completa. Las filas etiquetadas hacen que los nombres, valores y omisiones sean fáciles de examinar.

Los motores de búsqueda, sistemas de comparación, agentes de compras, herramientas de accesibilidad y fuentes de productos también necesitan retener la relación entre un componente, cantidad, unidad, parte del producto y variante. Las comas no pueden mostrar de forma confiable si «algodón 35%, forro de poliéster, recubierto de poliuretano» significa tres porcentajes, dos telas y un acabado, o un texto incompleto.

Las declaraciones reguladas hacen que la ambigüedad sea más grave. Las clases de productos controlados pueden tener requisitos específicos de nomenclatura, orden, énfasis, cantidad e idioma según el mercado. Dado que las obligaciones difieren según el producto y la jurisdicción, conserva la declaración aprobada, el mercado, la revisión y la fuente; nunca pidas a un redactor o sistema de renderizado que infiera el cumplimiento. La estructura no hace que el contenido sea conforme, pero hace que los campos requeridos sean verificables.

Cuándo usarlo

Usa un bloque de composición siempre que la identidad o cantidad de los componentes influya en la selección, el uso seguro, el cumplimiento normativo, la comparación, el cuidado, el reciclaje o la adquisición. Las aplicaciones incluyen:

• declaraciones de ingredientes de alimentos y bebidas, con énfasis en alérgenos regulado por separado cuando sea requerido;
• nombres de ingredientes cosméticos en el orden y nomenclatura aprobados;
• composición de fibras textiles desglosada por tela exterior, forro, relleno, adorno u otra parte relevante;
• materiales de muebles y construcción separados por capa estructural o componente;
• mezclas químicas y componentes activos con concentraciones y una base declarada;
• suplementos o productos formulados cuya identidad y cantidad de ingredientes deban mantenerse distintas;
• composición del empaque utilizada para eliminación, reciclaje o declaraciones ambientales;
• conjuntos técnicos donde «composición» significa una lista acotada de materiales constituyentes en lugar de un catálogo completo de piezas.

Usa un bloque por cada alcance aprobado. Un colchón puede tener grupos nombrados de cubierta, capa de confort y núcleo; los diferentes sabores necesitan registros separados. Cada fila debe ser verdadera para el producto, variante, mercado y revisión indicados en la parte superior.

Los casos cercanos necesitan estructuras diferentes. Las dimensiones, el voltaje, la compatibilidad y el rendimiento son especificaciones. La nutrición describe nutrientes y una porción de referencia, no necesariamente ingredientes. Las instrucciones de cuidado describen el comportamiento después de la compra. Las declaraciones de alérgenos separadas necesitan su propio tratamiento aprobado. «Amigable con el planeta» no es ni un componente ni una evidencia. Una lista de materiales de fabricación puede ser demasiado detallada o confidencial para los clientes.

Las reglas de redacción de elementos tienen prioridad: selecciona el elemento tipificado según el propósito del pasaje. Si la función del bloque es identificar de qué consiste el tema, usa composición incluso cuando una tabla genérica, un acordeón o un párrafo podrían imitar su apariencia.

Dónde colocarlo

Coloca el bloque principal después de la identificación del producto y los datos de compra, pero antes de las afirmaciones, instrucciones o guías que dependan de la composición. Normalmente precede al cuidado, seguridad, sostenibilidad y especificaciones detalladas. Los requisitos reglamentarios de ubicación anulan las preferencias editoriales.

Un resumen compacto en la zona de compra debe incluir datos críticos para la decisión y exponer la declaración completa sin cambiar de contexto. Mantén el contenido completo en el código fuente de la página y accesible sin JavaScript.

Mantén el bloque junto a su etiqueta de alcance. Puede situarse junto a una imagen o tabla de especificaciones con encabezados claros. No puede situarse junto a la afirmación de otra variante, una insignia ambiental no calificada o información de marketing contradictoria. Nunca insertes un testimonio, oferta, venta cruzada o llamada a la acción entre el encabezado de la declaración y las filas.

Para paquetes múltiples, kits y productos configurables, coloca cada artículo formulado de forma independiente en un subgrupo etiquetado. Nunca promedies composiciones en todo el lote. En móvil, conserva el orden: sujeto y alcance, base, componentes, calificadores, fuente o revisión. Las columnas visuales pueden colapsarse, pero las relaciones no.

Anatomía

1. Título: nombra la declaración de forma clara, por ejemplo, «Ingredientes», «Composición de materiales» o «Componentes activos».
2. Identidad del sujeto: vincula el contenido a un producto, SKU, variante, formulación o componente exacto.
3. Alcance: indica el mercado, parte del producto, estado de preparación, componente del empaque u otro límite que determina lo que describen las filas.
4. Base de la declaración: explica qué significan las cantidades, como porcentaje del peso de la fibra, miligramos por comprimido o gramos por 100 gramos tal como se vende.
5. Nombre del componente: conserva el nombre aprobado, común, técnico, estandarizado o regulado.
6. Cantidad: proporciona un número, rango, umbral o estado intencionalmente ausente sin hacer suposiciones.
7. Unidad o proporción: permanece unida a su cantidad y utiliza una convención definida dentro de un grupo.
8. Función o calificador: identifica funciones, subingredientes, revestimientos, vehículos, coadyuvantes de procesamiento o exclusiones solo cuando están aprobados y son relevantes.
9. Énfasis requerido: expone un alérgeno, componente activo o frase obligatoria mediante texto y marcado semántico, no solo color.
10. Procedencia: registra la fuente aprobada, el mercado, la revisión y la fecha de revisión utilizados para generar la declaración.

Ejemplos de diseño

Cada variante de diseño utiliza los mismos registros de componentes subyacentes. La variante cambia las etiquetas y la agrupación porque la clase de producto plantea una pregunta diferente; nunca convierte una declaración verificada en texto promocional de formato libre.

Ingredientes ordenados. Úsalo cuando la secuencia sea significativa o esté regulada. Conserva el orden de la fuente, la puntuación, los ingredientes anidados y el énfasis requerido. No ordenes alfabéticamente por estética visual ni combines dos nombres aprobados en una etiqueta más amigable.

Porcentajes de material por componente. Úsalo para textiles, muebles, empaques o productos en capas. Agrupa por parte física, indica a qué suman los porcentajes dentro de cada grupo y distingue un tratamiento superficial de la fibra o material subyacente.

Componentes activos y concentraciones. Úsalo cuando una sustancia activa o un componente funcional deba cuantificarse. Mantén juntos la cantidad, unidad, base y estado del producto. Las advertencias de seguridad y las instrucciones siguen siendo elementos regulados separados incluso cuando derivan de la misma fuente.

Composición técnica en capas. Úsalo para ensamblajes como pisos, aislamientos, filtros o colchones. Representa la jerarquía física de forma explícita. El espesor puede aparecer como un calificador del componente, pero las especificaciones de rendimiento no relacionadas pertenecen a su propia tabla.

Comparación compacta. Úsalo solo cuando dos o más productos tengan categorías de componentes genuinamente comparables. Muestra «No declarado» o «No aplica» en lugar de una celda vacía. Mantén el bloque completo y autoritativo en cada registro de producto; la comparación es una vista derivada, no una nueva fuente.

Parámetros

«Fuente» identifica de dónde obtiene cada campo el sistema de renderizado. El registro aprobado del producto o reglamento sigue siendo autoritativo; el cuerpo puede agregar contexto explicativo controlado pero no puede anular los datos vinculados a la fuente.

Los valores permitidos de item.flag están controlados por la implementación, por ejemplo allergen, active, restricted o regulated-name. Una bandera activa una presentación y validación aprobadas; los autores no pueden usar banderas arbitrarias para crear advertencias o insignias de marketing.

Sintaxis y ejemplos de código

Las tres formas codifican el mismo registro de tela exterior de la chaqueta. La directiva portátil es la representación canónica de autoría; un proyecto debe implementar y probar los adaptadores de Hugo y WordPress antes de publicarlo.

Directiva portátil de Markdown

:::composition{subject="Harbor work jacket" variant="HJ-204" market="US" scope="shell" basis="percent by fiber weight" source="pim:H-J204-US" revision="6" reviewed="2026-08-20"}
## Material composition

- name: Recycled polyester
  amount: 65
  unit: "%"
- name: Organic cotton
  amount: 35
  unit: "%"

Note: Polyurethane coating is excluded from fiber percentages. Lining is declared separately.
:::

Shortcode de Hugo

{{< composition subject="Harbor work jacket" variant="HJ-204" market="US" scope="shell" basis="percent by fiber weight" source="pim:H-J204-US" revision="6" reviewed="2026-08-20" >}}
## Material composition

- name: Recycled polyester
  amount: 65
  unit: "%"
- name: Organic cotton
  amount: 35
  unit: "%"

Note: Polyurethane coating is excluded from fiber percentages. Lining is declared separately.
{{< /composition >}}

Cada parámetro de Hugo tiene nombre. El ejemplo no mezcla parámetros posicionales y nombrados.

WordPress

[composition subject="Harbor work jacket" variant="HJ-204" market="US" scope="shell" basis="percent by fiber weight" source="pim:H-J204-US" revision="6" reviewed="2026-08-20"]
<h2>Material composition</h2>
<ul>
  <li data-name="Recycled polyester" data-amount="65" data-unit="percent">Recycled polyester: 65%</li>
  <li data-name="Organic cotton" data-amount="35" data-unit="percent">Organic cotton: 35%</li>
</ul>
<p>Polyurethane coating is excluded from fiber percentages. Lining is declared separately.</p>
[/composition]

Un bloque nativo de WordPress debe almacenar los componentes como registros tipificados repetibles, no como un solo campo de texto enriquecido. Bloquea los nombres y valores vinculados a la fuente cuando provengan de un sistema de gestión de información de producto, permitiendo al mismo tiempo que un revisor autorizado apruebe la presentación específica del mercado.

Ejemplos buenos y malos

Bueno

Composición de materiales — Chaqueta de trabajo Harbor HJ-204, tela exterior: 65% poliéster reciclado; 35% algodón orgánico. Los porcentajes son del peso de la fibra de la tela exterior. El revestimiento de poliuretano está excluido de los porcentajes de fibra. Forro: 100% poliéster. Fuente aprobada HJ-204-US, revisión 6.

Esto funciona porque nombra el producto y las partes exactas, proporciona una base para cada grupo de porcentajes, distingue el revestimiento de las fibras y expone la revisión aprobada. Los valores suman dentro de su alcance declarado en lugar de pretender describir toda la chaqueta.

Malo

Mezcla ecológica premium: Mayormente algodón natural con fibras de rendimiento recicladas y un acabado protector amigable con el planeta.

Esto falla porque «mayormente» no es una cantidad, «mezcla» oculta la relación entre los materiales y «acabado» no tiene identidad química ni de componente. Omite el alcance tela exterior versus forro, hace una afirmación ambiental sin fundamento y no proporciona fuente ni revisión. Un comprador no puede compararlo y una máquina no puede extraer componentes defendibles.

Marcado de esquema y accesibilidad

No existe un esquema de composición universal que cubra toda clase de producto regulado. Para un Product genuino, un material simple puede asignarse a material de Schema.org. Los datos con nombre a veces pueden asignarse mediante additionalProperty y PropertyValue, manteniendo juntos name, value y unitText o unitCode. Los identificadores estables deben vincularlos a la variante visible.

No fuerces declaraciones en propiedades no relacionadas. Recipe.recipeIngredient describe una receta, no la etiqueta de un producto envasado. Nunca emitas un porcentaje a partir del orden de la lista ni conviertas una inferencia ambiental o de alérgenos en un hecho. Genera los feeds sectoriales a partir del registro aprobado, no del HTML renderizado.

Los datos estructurados complementan, nunca reemplazan, la declaración visible. Las máquinas no deben recibir una versión más completa o de alcance diferente. Si el esquema no puede expresar una base o calificador, omite la propiedad y conserva el dato visible.

Usa un encabezado real y un contenedor semántico por declaración. Los ingredientes ordenados usan listas; los registros nombre-valor usan listas de descripción o tablas con encabezados. Los compuestos anidados necesitan estructura de lista anidada. El orden del lector de pantalla debe coincidir con el orden aprobado.

Nunca confíes solo en negrita, mayúsculas, color, iconos o información emergente para alérgenos o estado regulado. Incluye el texto requerido en contenido accesible. Los expansores necesitan un botón, estado preciso, operación con teclado y un respaldo renderizado en el servidor. Las unidades visibles y accesibles deben coincidir.

Reglas de redacción

El bloque preserva la verdad exacta del producto, por lo que la brevedad no puede justificar omitir el alcance, la base, los calificadores o los nombres requeridos. Aplica estas reglas después de confirmar la fuente y la política del mercado:

• Titula el bloque en una a cinco palabras. Prefiere el vocabulario que compradores y reguladores esperan: «Ingredientes», «Composición de materiales» o «Componentes activos».
• Incluye de una a 100 filas. Por encima de eso, usa agrupación controlada o un documento aprobado; nunca trunques de forma silenciosa.
• Mantén los nombres en 120 caracteres cuando sea posible, pero conserva intactos los nombres regulados más largos.
• Conserva el orden requerido. De lo contrario, mantén la secuencia del registro de producto aprobado en todos los canales.
• Adjunta las cantidades a las unidades y una base. Nunca fuerces capas incomparables a un falso total del 100%.
• Usa números para las cantidades y símbolos de unidad controlados. Localiza la representación decimal y de unidades sin cambiar el valor almacenado.
• Distingue entre «No declarado», «No aplica», «Cantidad no proporcionada» y cero; un espacio en blanco es ambiguo.
• Limita las notas a 40 palabras después del grupo afectado. Aclaran el alcance pero no pueden anular filas.
• Usa un lenguaje factual y neutral. Mantén las explicaciones separadas de los nombres legales o estandarizados.
• Revisa la clase de producto exacta, mercado, idioma, variante y revisión. Vuelve a validar cada cambio relevante.

Nunca pongas precio, stock, entrega, testimonios, afirmaciones promocionales, instrucciones de eliminación, indicaciones de dosificación, advertencias de seguridad, datos nutricionales completos ni especificaciones no relacionadas dentro del bloque de composición. Esos datos pueden estar cerca en sus propios elementos regulados. Nunca infieras «libre de», hipoalergénico, vegano, reciclable, natural, orgánico, no tóxico o ambientalmente preferible solo a partir de una lista de componentes. Nunca uses una fotografía del empaque como única declaración, porque su texto puede ser ilegible, obsoleto, específico del mercado y no disponible para tecnologías de asistencia.

Tipos de publicaciones que lo utilizan

El campo postTypes del frontmatter es la fuente de implementación para esta matriz.

Lista de verificación de control de calidad

• El bloque identifica el producto exacto, SKU o formulación, mercado y alcance físico que describe.
• La declaración proviene de una fuente aprobada, y su ID de fuente, revisión y fecha de revisión se conservan.
• Cada nombre de componente coincide con el nombre aprobado común, técnico, estandarizado o regulado.
• Las declaraciones ordenadas preservan el orden de la fuente; ningún sistema de renderizado alfabetiza, fusiona o reordena las filas.
• Cada valor numérico tiene una unidad y una base visible, y los rangos o umbrales conservan sus operadores.
• Los porcentajes suman solo dentro de un alcance compartido válido; las capas, revestimientos y componentes excluidos están identificados.
• Los valores faltantes, cero, no aplicables y no declarados se representan como estados distintos.
• Los ingredientes compuestos o materiales en capas usan grupos anidados explícitos en lugar de puntuación ambigua.
• El énfasis requerido para alérgenos, componentes activos o regulaciones permanece disponible en texto y para tecnologías de asistencia.
• El bloque visible, la fuente del producto, el empaque, la salida de esquema y la selección de variantes no se contradicen entre sí.
• Ninguna fila de composición contiene precio, disponibilidad, promoción, testimonio, beneficio no respaldado ni afirmaciones ambientales o de seguridad inferidas.
• La declaración completa funciona sin imágenes, cursor, color, JavaScript ni un diseño de escritorio expandido.
• Los cambios en formulación, proveedor, componente, empaque, jurisdicción o revisión activan una revalidación.
• Los tres ejemplos de sintaxis preservan el mismo sujeto, alcance, base, filas, fuente y revisión.

Preguntas frecuentes

¿Es un bloque de composición lo mismo que una tabla de especificaciones?

No. Un bloque de composición identifica de qué está hecho un producto y, cuando corresponde, la cantidad o proporción de cada componente. Una tabla de especificaciones describe características medibles como dimensiones, capacidad, voltaje o compatibilidad. Mantén ambas estructuras separadas incluso cuando aparezcan cerca una de otra.

¿Debe cada ingrediente incluir un porcentaje?

No. Incluye un porcentaje cuando la norma aplicable, la fuente aprobada o la decisión del comprador lo requiera. Nunca infieras un porcentaje a partir del orden de la lista. Conserva el orden aprobado de los ingredientes y muestra una cantidad exacta solo cuando la fuente proporcione una base y unidad válidas.

¿Puede el equipo de marketing modificar los nombres regulados de ingredientes o materiales?

No. Los nombres mostrados pueden complementarse con una explicación en lenguaje sencillo cuando la política lo permita, pero el nombre legal o estandarizado requerido debe permanecer intacto. El texto de marketing no puede reemplazar, abreviar, reordenar ni suavizar una declaración regulada.

¿Un bloque de composición genera automáticamente marcado de esquema?

No. Algunos campos pueden asignarse a valores de Product.material o additionalProperty, pero no existe un objeto de composición universal de Schema.org para cada clase de producto. Emite solo las propiedades compatibles que describan con precisión el producto visible y nunca uses datos estructurados como sustituto de la declaración en página.

¿Cómo debe diferir la composición entre variantes de producto o mercados?

Vincula el bloque al SKU y mercado exactos. Si el color, tamaño, sabor, fórmula, proveedor o destino cambia la declaración, muestra el registro aprobado correspondiente e identifica su alcance. No combines varias variantes en una sola lista a menos que cada componente y cantidad sean genuinamente idénticos.