Composition Blocks: Inhaltsstoffe, Materialien und Bestandteile

Ein Composition Block ist eine strukturierte Deklaration dessen, woraus ein Produkt besteht. Er hält Inhaltsstoffnamen, Materialarten, Komponentenmengen, Prozentanteile, Funktionen und erforderliche Qualifikatoren zusammen, sodass ein Käufer das Produkt nicht aus Verpackungsfotos oder Marketingprosa rekonstruieren muss.

Das Element trennt das Produkt und den Geltungsbereich von jedem Bestandteil und Wert. „65 % recyceltes Polyester“ ist nur dann aussagekräftig, wenn der Leser weiß, ob es sich auf den Oberstoff, das Futter, die Füllung, das gesamte Kleidungsstück oder die Verpackung bezieht.

Warum dieses Element wichtig ist

Die Zusammensetzung beeinflusst Entscheidungen, die Produktslogans nicht beantworten können. Ein Käufer möchte möglicherweise ein Allergen meiden, Wollanteile vergleichen, eine Beschichtung prüfen, eine recyclingfähige Monomaterialverpackung wählen oder die Konzentration eines Wirkstoffs bestätigen. Er entscheidet möglicherweise, ob das Produkt sicher, geeignet, wartbar, richtlinienkonform oder seinen Preis wert ist.

Struktur reduziert diesen Entscheidungsaufwand. „Hergestellt mit Baumwolle, recyceltem Polyester und einer Schutzbeschichtung“ zwingt Leser herauszufinden, zu welchem Teil jedes Material gehört und ob die Liste vollständig ist. Beschriftete Zeilen machen Namen, Werte und Auslassungen leicht erfassbar.

Auch Suchmaschinen, Vergleichssysteme, Shopping-Agenten, Barrierefreiheits-Tools und Produktfeeds müssen die Beziehung zwischen einem Bestandteil, einer Menge, einer Einheit, einem Produktteil und einer Variante erhalten. Kommata können nicht zuverlässig zeigen, ob „Baumwolle 35 %, Polyesterfutter, polyurethanbeschichtet“ drei Prozentangaben, zwei Stoffe und eine Oberflächenbehandlung oder eine unvollständige Kopie bedeutet.

Regulierte Deklarationen machen Unklarheiten schwerwiegender. Kontrollierte Produktklassen können marktspezifische Anforderungen an Benennung, Reihenfolge, Hervorhebung, Menge und Sprache haben. Da die Pflichten je nach Produkt und Rechtsordnung unterschiedlich sind, bewahren Sie die genehmigte Deklaration, den Markt, die Revision und die Quelle; bitten Sie niemals einen Autor oder Renderer, Compliance zu erraten. Struktur macht Inhalte nicht konform, aber sie macht erforderliche Felder prüfbar.

Wann man es verwendet

Verwenden Sie einen Composition Block, wenn die Identität oder Menge eines Bestandteils die Auswahl, die sichere Verwendung, die Compliance, den Vergleich, die Pflege, das Recycling oder die Beschaffung beeinflusst. Anwendungen umfassen:

• Lebensmittel- und Getränkezutatendeklarationen mit gesondert geregelter Allergenhervorhebung, wo erforderlich;
• kosmetische Inhaltsstoffnamen in der genehmigten Reihenfolge und Nomenklatur;
• textile Faserzusammensetzung aufgeteilt nach Oberstoff, Futter, Füllung, Besatz oder anderen relevanten Teilen;
• Möbel- und Baumaterialien getrennt nach struktureller Schicht oder Komponente;
• chemische Gemische und Wirkstoffe mit Konzentrationen und einer deklarierten Grundlage;
• Nahrungsergänzungsmittel oder formulierte Produkte, bei denen Identität und Menge der Inhaltsstoffe getrennt bleiben müssen;
• Verpackungszusammensetzung für Entsorgung, Recycling oder Umweltaussagen;
• technische Baugruppen, bei denen „Zusammensetzung“ eine abgegrenzte Stückliste der Bestandteilmaterialien bedeutet, nicht ein vollständiges Teileverzeichnis.

Verwenden Sie einen Block für einen genehmigten Geltungsbereich. Eine Matratze kann benannte Bezugs-, Komfortschicht- und Kerngruppen haben; verschiedene Geschmacksrichtungen benötigen separate Datensätze. Jede Zeile muss für das oben genannte Produkt, die Variante, den Markt und die Revision zutreffend sein.

Beinahetreffer benötigen andere Strukturen. Abmessungen, Spannung, Kompatibilität und Leistung sind Spezifikationen. Die Nährwertangabe beschreibt Nährstoffe und eine Portionsbasis, nicht unbedingt Inhaltsstoffe. Pflegehinweise beschreiben das Verhalten nach dem Kauf. Separate Allergenangaben benötigen eine eigene genehmigte Behandlung. „Umweltfreundlich“ ist weder ein Bestandteil noch ein Beleg. Eine Fertigungsstückliste kann zu detailliert oder vertraulich für Kunden sein.

Die Element-Schreibregeln haben Vorrang: Wählen Sie das getypte Element nach dem Zweck des Textabschnitts aus. Wenn der Block dazu dient, zu identifizieren, woraus das Thema besteht, verwenden Sie Composition, auch wenn eine generische Tabelle, ein Akkordeon oder ein Absatz sein Erscheinungsbild nachahmen könnte.

Wo man es platziert

Platzieren Sie den primären Block nach der Produktidentität und den Kaufangaben, aber vor Behauptungen, Anleitungen oder Empfehlungen, die von der Zusammensetzung abhängen. Er steht normalerweise vor Pflege-, Sicherheits-, Nachhaltigkeits- und detaillierten Spezifikationen. Regulatorische Platzierungsanforderungen überschreiben redaktionelle Präferenzen.

Eine kompakte Zusammenfassung im Kaufbereich muss entscheidungsrelevante Fakten enthalten und die vollständige Deklaration offenlegen, ohne den Kontext zu wechseln. Halten Sie den vollständigen Inhalt im Seitenquelltext und ohne JavaScript erreichbar.

Halten Sie den Block neben seiner Geltungsbereichsbeschriftung. Er kann neben einem Bild oder einer Spezifikationstabelle mit klaren Überschriften stehen. Er darf nicht neben der Angabe einer anderen Variante, einem undifferenzierten Umweltzeichen oder widersprüchlichem Marketing stehen. Fügen Sie niemals ein Testimonial, ein Angebot, einen Cross-Sell oder einen CTA zwischen der Deklarationsüberschrift und den Zeilen ein.

Bei Multipacks, Sets und konfigurierbaren Produkten setzen Sie jeden unabhängig formulierten Artikel in eine beschriftete Untergruppe. Mitteln Sie niemals Zusammensetzungen über das gesamte Set. Bewahren Sie auf Mobilgeräten die Reihenfolge: Subjekt und Geltungsbereich, Grundlage, Bestandteile, Qualifikatoren, Quelle oder Revision. Visuelle Spalten können umbrechen, Beziehungen jedoch nicht.

Anatomie

1. Titel: benennt die Deklaration klar, z. B. „Inhaltsstoffe“, „Materialzusammensetzung“ oder „Wirkstoffe“.
2. Subjektidentität: bindet den Inhalt an ein exaktes Produkt, SKU, Variante, Formulierung oder Komponente.
3. Geltungsbereich: gibt den Markt, das Produktteil, den Zubereitungszustand, die Verpackungskomponente oder andere Grenzen an, die bestimmen, was die Zeilen beschreiben.
4. Deklarationsgrundlage: erklärt, was die Mengen bedeuten, z. B. Prozent nach Fasergewicht, Milligramm pro Tablette oder Gramm pro 100 Gramm wie verkauft.
5. Bestandteilname: bewahrt den genehmigten gebräuchlichen, technischen, standardisierten oder regulierten Namen.
6. Menge: liefert eine Zahl, einen Bereich, einen Schwellenwert oder einen bewusst abwesenden Zustand ohne Schätzung.
7. Einheit oder Anteil: bleibt mit seiner Menge verbunden und verwendet innerhalb einer Gruppe eine definierte Konvention.
8. Rolle oder Qualifikator: identifiziert Funktionen, Unterinhaltsstoffe, Beschichtungen, Trägerstoffe, Verarbeitungshilfsstoffe oder Ausschlüsse nur, wenn genehmigt und relevant.
9. Erforderliche Hervorhebung: macht ein Allergen, einen Wirkstoff oder einen vorgeschriebenen Satz durch Text und semantisches Markup sichtbar, nicht nur durch Farbe.
10. Herkunft: dokumentiert die genehmigte Quelle, den Markt, die Revision und das Prüfdatum, die zur Darstellung der Deklaration verwendet wurden.

Gestaltungsbeispiele

Jede Gestaltungsvariante verwendet dieselben zugrundeliegenden Bestandteildatensätze. Die Variante ändert Bezeichnungen und Gruppierung, weil die Produktklasse eine andere Frage stellt; sie macht niemals aus einer geprüften Deklaration werblichen Freitext.

Geordnete Inhaltsstoffe. Verwenden, wenn die Reihenfolge bedeutsam oder reguliert ist. Bewahren Sie die Quellreihenfolge, Zeichensetzung, verschachtelten Inhaltsstoffe und erforderliche Hervorhebungen. Sortieren Sie nicht alphabetisch aus Gründen der optischen Ordnung und verschmelzen Sie nicht zwei genehmigte Namen zu einer freundlicheren Bezeichnung.

Materialanteile nach Komponente. Verwenden für Textilien, Möbel, Verpackungen oder geschichtete Waren. Gruppieren Sie nach physischem Teil, geben Sie an, worauf sich die Prozentangaben innerhalb der Gruppe beziehen, und unterscheiden Sie eine Oberflächenbehandlung vom darunterliegenden Faser- oder Material.

Wirkstoffe und Konzentrationen. Verwenden, wenn ein Wirkstoff oder funktioneller Bestandteil quantifiziert werden muss. Halten Sie Menge, Einheit, Grundlage und Produktzustand zusammen. Sicherheitswarnungen und Anwendungshinweise bleiben separate geregelte Elemente, auch wenn sie aus derselben Quelle stammen.

Geschichtete technische Zusammensetzung. Verwenden für Aufbauten wie Bodenbeläge, Isolierung, Filter oder Matratzen. Stellen Sie die physische Hierarchie explizit dar. Die Dicke kann als Bestandteil-Qualifikator erscheinen, aber nicht zusammenhängende Leistungsspezifikationen gehören in eine eigene Tabelle.

Kompakter Vergleich. Nur verwenden, wenn zwei oder mehr Produkte wirklich vergleichbare Bestandteilkategorien haben. Zeigen Sie „Nicht deklariert“ oder „Nicht zutreffend“ anstelle einer leeren Zelle. Behalten Sie den vollständigen autoritativen Block in jedem Produktdatensatz; der Vergleich ist eine abgeleitete Ansicht, keine neue Quelle.

Parameter

„Quelle“ identifiziert, woher der Renderer jedes Feld bezieht. Der genehmigte Produkt- oder Regulierungsdatensatz bleibt maßgeblich; der Body kann kontrollierten erklärenden Kontext hinzufügen, aber keine quellgebundenen Fakten überschreiben.

Die zulässigen item.flag-Werte sind implementierungsgesteuert, z. B. allergen, active, restricted oder regulated-name. Ein Flag löst eine genehmigte Darstellung und Validierung aus; Autoren können keine beliebigen Flags verwenden, um Warnungen oder Marketingabzeichen zu erzeugen.

Syntax und Codebeispiele

Alle drei Formen kodieren denselben Jackenoberstoff-Datensatz. Die portable Direktive ist die kanonische Autorendarstellung; ein Projekt muss die Hugo- und WordPress-Adapter implementieren und testen, bevor es sie veröffentlicht.

Portable Markdown-Direktive

:::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.
:::

Hugo-Shortcode

{{< 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 >}}

Jeder Hugo-Parameter ist benannt. Das Beispiel mischt keine positionsbasierten und benannten Parameter.

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]

Ein nativer WordPress-Block sollte Bestandteile als wiederholbare getypte Datensätze speichern, nicht als ein einziges Rich-Text-Feld. Sperren Sie quellgebundene Namen und Werte, wenn sie aus einem Produktinformationsmanagementsystem stammen, während Sie einem autorisierten Prüfer erlauben, die marktspezifische Darstellung zu genehmigen.

Gute und schlechte Beispiele

Gut

Materialzusammensetzung — Harbor Arbeitsjacke HJ-204, Oberstoff: 65 % recyceltes Polyester; 35 % Bio-Baumwolle. Die Prozentangaben beziehen sich auf das Fasergewicht des Oberstoffs. Die Polyurethanbeschichtung ist von den Faseranteilen ausgenommen. Futter: 100 % Polyester. Genehmigte Quelle HJ-204-US, Revision 6.

Dies funktioniert, weil es das genaue Produkt und die Teile benennt, eine Grundlage für jede Prozentgruppe liefert, die Beschichtung von den Fasern unterscheidet und die genehmigte Revision offenlegt. Die Werte summieren sich innerhalb ihres deklarierten Geltungsbereichs, anstatt vorzugeben, die gesamte Jacke zu beschreiben.

Schlecht

Premium-Öko-Mischung: Hauptsächlich Naturbaumwolle mit recycelten Performance-Fasern und einer umweltfreundlichen Schutzveredelung.

Dies scheitert, weil „hauptsächlich“ keine Menge ist, „Mischung“ die Beziehung zwischen den Materialien verschleiert und „Veredelung“ keine chemische oder komponentenbezogene Identität hat. Es lässt den Geltungsbereich Oberstoff versus Futter vermissen, macht eine unbelegte Umweltaussage und gibt weder Quelle noch Revision an. Ein Käufer kann es nicht vergleichen, und eine Maschine kann keine belegbaren Bestandteile extrahieren.

Schema-Markup und Barrierefreiheit

Es gibt kein universelles Composition-Schema, das jede regulierte Produktklasse abdeckt. Für ein echtes Product kann ein einfaches Material auf Schema.orgs material abgebildet werden. Benannte Fakten können manchmal über additionalProperty und PropertyValue abgebildet werden, wobei name, value und unitText oder unitCode zusammengehalten werden. Stabile Identifikatoren müssen sie an die sichtbare Variante binden.

Erzwingen Sie keine Deklarationen in nicht zusammenhängenden Eigenschaften. Recipe.recipeIngredient beschreibt ein Rezept, nicht ein verpacktes Produktetikett. Geben Sie niemals einen Prozentanteil aus der Listenreihenfolge aus und machen Sie keine Umwelt- oder Allergenvermutung zur Tatsache. Generieren Sie Branchenfeeds aus dem genehmigten Datensatz, nicht aus gerendertem HTML.

Strukturierte Daten ergänzen die sichtbare Deklaration, ersetzen sie aber niemals. Maschinen dürfen keine umfangreichere oder anders umfangreiche Version erhalten. Wenn Schema keine Basis oder keinen Qualifikator ausdrücken kann, lassen Sie die Eigenschaft weg und bewahren Sie die sichtbare Tatsache.

Verwenden Sie eine echte Überschrift und einen semantischen Container pro Deklaration. Geordnete Inhaltsstoffe verwenden Listen; Name-Wert-Datensätze verwenden Beschreibungslisten oder Tabellen mit Kopfzeilen. Verschachtelte Verbindungen benötigen eine verschachtelte Listenstruktur. Die Screenreader-Reihenfolge muss mit der genehmigten Reihenfolge übereinstimmen.

Verlassen Sie sich niemals allein auf Fettdruck, Großbuchstaben, Farbe, Symbole oder Tooltips für Allergene oder regulierte Angaben. Fügen Sie erforderlichen Text in zugänglichen Inhalten ein. Aufklappelemente benötigen eine Schaltfläche, einen korrekten Zustand, Tastaturbedienung und einen serverseitig gerenderten Fallback. Sichtbare und zugängliche Einheiten müssen übereinstimmen.

Schreibregeln

Der Block bewahrt die exakte Produktwahrheit, daher kann Kürze nicht den Wegfall von Geltungsbereich, Grundlage, Qualifikatoren oder erforderlichen Namen rechtfertigen. Wenden Sie diese Regeln an, nachdem Sie die Quelle und die Marktrichtlinie bestätigt haben:

• Betiteln Sie den Block mit einem bis fünf Wörtern. Bevorzugen Sie das Vokabular, das Käufer und Regulierungsbehörden erwarten: „Inhaltsstoffe“, „Materialzusammensetzung“ oder „Wirkstoffe“.
• Enthalten Sie ein bis 100 Zeilen. Darüber hinaus verwenden Sie geregelte Gruppierung oder ein genehmigtes Dokument; kürzen Sie niemals stillschweigend.
• Halten Sie Namen nach Möglichkeit auf 120 Zeichen, aber bewahren Sie längere regulierte Namen unverändert.
• Bewahren Sie die erforderliche Reihenfolge. Ansonsten behalten Sie die genehmigte Produktdatensatz-Reihenfolge über alle Kanäle hinweg bei.
• Verknüpfen Sie Mengen mit Einheiten und einer Grundlage. Erzwingen Sie niemals eine nicht vergleichbare Aufsummierung auf eine falsche 100 %-Gesamtsumme.
• Verwenden Sie Ziffern für Mengen und kontrollierte Einheitssymbole. Lokalisieren Sie die Darstellung von Dezimaltrennzeichen und Einheiten, ohne den gespeicherten Wert zu ändern.
• Unterscheiden Sie „Nicht deklariert“, „Nicht zutreffend“, „Menge nicht angegeben“ und Null; eine Leerstelle ist mehrdeutig.
• Halten Sie Notizen nach der betroffenen Gruppe auf 40 Wörter. Sie klären den Geltungsbereich, können aber keine Zeilen überschreiben.
• Verwenden Sie sachliche, neutrale Sprache. Halten Sie Erklärungen getrennt von gesetzlichen oder standardisierten Namen.
• Überprüfen Sie die genaue Produktklasse, den Markt, die Sprache, die Variante und die Revision. Validieren Sie jede relevante Änderung erneut.

Setzen Sie niemals Preis, Lagerbestand, Lieferung, Testimonials, Werbeaussagen, Entsorgungshinweise, Dosierungsanleitungen, Sicherheitswarnungen, vollständige Nährwertangaben oder nicht zusammenhängende Spezifikationen innerhalb des Composition Blocks. Diese Fakten können in ihren eigenen geregelten Elementen in der Nähe stehen. Leiten Sie niemals „frei von“, hypoallergen, vegan, recyclingfähig, natürlich, biologisch, ungiftig oder umweltfreundlich allein aus einer Bestandteilliste ab. Verwenden Sie niemals ein Verpackungsfoto als einzige Deklaration, da dessen Text möglicherweise unleserlich, veraltet, marktspezifisch und für assistive Technologien nicht verfügbar ist.

Beitragstypen, die es verwenden

Das postTypes-Feld im Frontmatter ist die Implementierungsquelle für diese Matrix.

QA-Checkliste

• Der Block identifiziert das exakte Produkt, die SKU oder Formulierung, den Markt und den physischen Geltungsbereich, den er beschreibt.
• Die Deklaration stammt aus einer genehmigten Quelle, und Quellen-ID, Revision und Prüfdatum sind erhalten.
• Jeder Bestandteilname entspricht dem genehmigten gebräuchlichen, technischen, standardisierten oder regulierten Namen.
• Geordnete Deklarationen bewahren die Quellreihenfolge; kein Renderer alphabetisiert, verschmilzt oder ordnet die Zeilen um.
• Jeder Zahlenwert hat eine Einheit und eine sichtbare Grundlage, und Bereiche oder Schwellenwerte behalten ihre Operatoren.
• Prozentangaben summieren sich nur innerhalb eines gültigen gemeinsamen Geltungsbereichs; ausgenommene Schichten, Beschichtungen und Komponenten sind gekennzeichnet.
• Fehlend, Null, nicht zutreffend und nicht deklariert werden als unterschiedliche Zustände dargestellt.
• Zusammengesetzte Inhaltsstoffe oder geschichtete Materialien verwenden explizite verschachtelte Gruppen anstelle mehrdeutiger Zeichensetzung.
• Erforderliche Allergen-, Wirkstoff- oder Regulierungshervorhebung bleibt im Text und für assistive Technologien verfügbar.
• Der sichtbare Block, der Produktfeed, die Verpackungsquelle, die Schema-Ausgabe und die Variantenauswahl widersprechen sich nicht gegenseitig.
• Keine Composition-Zeile enthält Preis, Verfügbarkeit, Werbung, Testimonial, unbelegten Nutzen oder abgeleitete Umwelt- oder Sicherheitsaussagen.
• Die vollständige Deklaration funktioniert ohne Bilder, Hover, Farbe, JavaScript oder erweitertes Desktop-Layout.
• Änderungen an Formulierung, Lieferant, Komponente, Verpackung, Rechtsordnung oder Revision lösen eine erneute Validierung aus.
• Die drei Syntaxbeispiele bewahren dasselbe Subjekt, denselben Geltungsbereich, dieselbe Grundlage, dieselben Zeilen, dieselbe Quelle und dieselbe Revision.

FAQ

Ist ein Composition Block dasselbe wie eine Spezifikationstabelle?

Nein. Ein Composition Block gibt an, woraus ein Produkt besteht und gegebenenfalls die Menge oder den Anteil jedes Bestandteils. Eine Spezifikationstabelle beschreibt messbare Eigenschaften wie Abmessungen, Kapazität, Spannung oder Kompatibilität. Halten Sie die beiden Strukturen getrennt, auch wenn sie nebeneinander erscheinen.

Muss jeder Inhaltsstoff einen Prozentanteil enthalten?

Nein. Geben Sie einen Prozentanteil an, wenn die geltende Regelung, die genehmigte Quelle oder die Kaufentscheidung dies erfordert. Leiten Sie niemals einen Prozentanteil aus der Reihenfolge der Liste ab. Bewahren Sie die genehmigte Inhaltsstoffreihenfolge und geben Sie eine exakte Menge nur an, wenn die Quelle eine gültige Basis und Einheit liefert.

Darf das Marketing regulierte Inhaltsstoff- oder Materialbezeichnungen umschreiben?

Nein. Anzeigenamen können durch eine allgemeinverständliche Erklärung ergänzt werden, wenn die Richtlinie dies erlaubt, aber der erforderliche gesetzliche oder standardisierte Name muss intakt bleiben. Marketingtexte dürfen eine regulierte Deklaration nicht ersetzen, abkürzen, umstellen oder abschwächen.

Erzeugt ein Composition Block automatisch Schema-Markup?

Nein. Einige Felder können auf Product.material oder additionalProperty-Werte abgebildet werden, aber es gibt kein universelles Schema.org-Kompositionsobjekt für jede Produktklasse. Geben Sie nur unterstützte Eigenschaften aus, die das sichtbare Produkt korrekt beschreiben, und verwenden Sie niemals strukturierte Daten als Ersatz für die On-Page-Deklaration.

Wie sollte sich die Zusammensetzung zwischen Produktvarianten oder Märkten unterscheiden?

Binden Sie den Block an die exakte SKU und den Markt. Wenn Farbe, Größe, Geschmack, Formel, Lieferant oder Bestimmungsort die Deklaration ändert, rendern Sie den passenden genehmigten Datensatz und kennzeichnen Sie dessen Geltungsbereich. Fassen Sie mehrere Varianten nicht in einer einzigen Liste zusammen, es sei denn, jeder Bestandteil und jede Menge ist wirklich identisch.