Compositieblokken: Ingrediënten, Materialen en Bestanddelen

Een compositieblok is een gestructureerde declaratie van waar een product uit bestaat. Het houdt ingrediëntnamen, materiaalsoorten, componenthoeveelheden, percentages, functies en vereiste kwalificaties bij elkaar, zodat een koper het product niet hoeft te reconstrueren uit verpakkingsfoto’s of marketingproza.

Het element scheidt het product en de reikwijdte van elk bestanddeel en elke waarde. “65% gerecycled polyester” is alleen betekenisvol als de lezer weet of het de buitenstof, voering, vulling, het hele kledingstuk of de verpakking beschrijft.

Waarom dit element belangrijk is

Samenstelling beïnvloedt beslissingen die productslogans niet kunnen beantwoorden. Een koper wil mogelijk een allergeen vermijden, het wolgehalte vergelijken, een coating controleren, een recyclebaar monomateriaal verpakking kiezen of de concentratie van een actief bestanddeel bevestigen. Ze beslissen of het product veilig, geschikt, onderhoudsbaar, beleidsconform of zijn prijs waard is.

Structuur verlaagt die beslislast. “Gemaakt met katoen, gerecycled polyester en een beschermende coating” laat lezers ontdekken tot welk deel elk materiaal behoort en of de lijst volledig is. Gelabelde rijen maken namen, waarden en weglatingen eenvoudig te scannen.

Zoekmachines, vergelijkingssystemen, winkelagenten, toegankelijkheidstools en productfeeds moeten ook de relatie tussen een bestanddeel, hoeveelheid, eenheid, productonderdeel en variant kunnen herkennen. Komma’s kunnen niet betrouwbaar aangeven of “katoen 35%, polyester voering, polyurethaan gecoat” drie percentages, twee stoffen en een afwerking, of onvolledige tekst betekent.

Gereguleerde declaraties maken dubbelzinnigheid ernstiger. Gecontroleerde productklassen kunnen marktspecifieke naamgevings-, ordenings-, nadruk-, hoeveelheids- en taalvereisten hebben. Omdat verplichtingen verschillen per product en rechtsgebied, bewaar de goedgekeurde declaratie, markt, revisie en bron; vraag nooit aan een schrijver of renderer om naleving af te leiden. Structuur maakt inhoud niet compliant, maar het maakt vereiste velden wel testbaar.

Wanneer te gebruiken

Gebruik een compositieblok wanneer de identiteit of hoeveelheid van bestanddelen de selectie, veilig gebruik, naleving, vergelijking, verzorging, recycling of inkoop beïnvloedt. Toepassingen zijn onder andere:

• voedsel- en drank-ingrediëntendeclaraties, met afzonderlijk gereguleerde allergeenmarkering waar vereist;
• cosmetische ingrediëntnamen in de goedgekeurde volgorde en nomenclatuur;
• textielvezelsamenstelling, uitgesplitst naar buitenstof, voering, vulling, afwerking of ander relevant onderdeel;
• meubel- en bouwmaterialen, gescheiden per structurele laag of component;
• chemische mengsels en actieve componenten met concentraties en een gedeclareerde basis;
• supplementen of samengestelde producten waarvan de ingrediëntidentiteit en -hoeveelheid apart moeten blijven;
• verpakkingssamenstelling gebruikt voor afvalverwerking, recycling of milieuclaims;
• technische samenstellingen waarbij “samenstelling” een afgebakende lijst van samenstellende materialen betekent in plaats van een volledige onderdelencatalogus.

Gebruik één blok voor één goedgekeurde reikwijdte. Een matras kan benoemde groepen hebben voor bekleding, comfortlaag en kern; verschillende smaken hebben aparte records nodig. Elke rij moet waar blijven voor het product, de variant, de markt en de revisie die bovenaan worden genoemd.

Bijna-overeenkomsten hebben andere structuren nodig. Afmetingen, spanning, compatibiliteit en prestaties zijn specificaties. Voeding beschrijft voedingsstoffen en een portiebasis, niet noodzakelijk ingrediënten. Onderhoudsinstructies beschrijven gedrag na aankoop. Aparte allergeenverklaringen hebben hun eigen goedgekeurde behandeling nodig. “Planetvriendelijk” is noch een bestanddeel, noch bewijs. Een fabricagestuklijst kan te gedetailleerd of vertrouwelijk zijn voor klanten.

De element-schrijfregels hebben voorrang: selecteer het getypeerde element op basis van het doel van de passage. Als het blok dient om te identificeren waar het onderwerp uit bestaat, gebruik dan compositie, zelfs als een generieke tabel, accordeon of alinea het uiterlijk zou kunnen nabootsen.

Waar te plaatsen

Plaats het primaire blok na productidentiteit en aankoopgegevens, maar vóór claims, instructies of richtlijnen die afhankelijk zijn van de samenstelling. Het gaat normaal gesproken vooraf aan verzorging, veiligheid, duurzaamheid en gedetailleerde specificaties. Wettelijke plaatsingsvereisten overschrijven redactionele voorkeur.

Een compacte aankoopregio-samenvatting moet beslissingskritische feiten bevatten en de volledige declaratie tonen zonder de context te wijzigen. Houd de volledige inhoud in de paginabron en bereikbaar zonder JavaScript.

Houd het blok naast het reikwijdte-label. Het mag naast een afbeelding of specificatietabel met duidelijke koppen staan. Het mag niet naast een claim van een andere variant, een ongekwalificeerde milieubadge of tegenstrijdige marketing staan. Plaats nooit een getuigenis, aanbieding, cross-sell of CTA tussen de declaratiekop en de rijen.

Voor meerpakken, kits en configureerbare producten plaatst u elk onafhankelijk samengesteld item in een gelabelde subgroep. Middel nooit samenstellingen over het hele pakket. Behoud op mobiel de volgorde: onderwerp en reikwijdte, basis, bestanddelen, kwalificaties, bron of revisie. Visuele kolommen mogen instorten, maar relaties niet.

Anatomie

1. Titel: benoemt de declaratie duidelijk, zoals “Ingrediënten”, “Materiaalsamenstelling” of “Actieve componenten”.
2. Onderwerpidentiteit: koppelt de inhoud aan een exact product, SKU, variant, formulering of component.
3. Reikwijdte: vermeldt de markt, het productonderdeel, de bereidingstoestand, het verpakkingsonderdeel of andere grens die bepaalt wat de rijen beschrijven.
4. Declaratiebasis: legt uit wat hoeveelheden betekenen, zoals percentage van het vezelgewicht, milligram per tablet of gram per 100 gram zoals verkocht.
5. Bestanddeelnaam: behoudt de goedgekeurde algemene, technische, gestandaardiseerde of gereguleerde naam.
6. Hoeveelheid: levert een getal, bereik, drempelwaarde of opzettelijk afwezige toestand zonder te gissen.
7. Eenheid of verhouding: blijft aan de hoeveelheid gekoppeld en gebruikt binnen een groep één gedefinieerde conventie.
8. Rol of kwalificatie: identificeert functies, sub-ingrediënten, coatings, dragers, verwerkingshulpstoffen of uitsluitingen alleen wanneer goedgekeurd en relevant.
9. Vereiste nadruk: toont een allergeen, actieve component of verplichte formulering door middel van tekst en semantische opmaak, niet alleen kleur.
10. Herkomst: registreert de goedgekeurde bron, markt, revisie en controledatum die zijn gebruikt om de declaratie weer te geven.

Ontwerpvoorbeelden

Elke ontwerpvariant gebruikt dezelfde onderliggende bestanddeelrecords. De variant verandert labels en groepering omdat de productklasse een andere vraag stelt; het verandert nooit een geverifieerde declaratie in vrije promotionele tekst.

Geordende ingrediënten. Gebruik wanneer volgorde betekenisvol of gereguleerd is. Behoud bronvolgorde, interpunctie, geneste ingrediënten en vereiste nadruk. Niet alfabetiseren voor visuele netheid en voeg geen twee goedgekeurde namen samen tot een vriendelijker label.

Materiaalpercentages per component. Gebruik voor textiel, meubels, verpakkingen of gelaagde goederen. Groepeer op fysiek onderdeel, geef aan waarbinnen de percentages optellen en onderscheid een oppervlaktebehandeling van de onderliggende vezel of het onderliggende materiaal.

Actieve componenten en concentraties. Gebruik wanneer een actieve stof of functioneel bestanddeel gekwantificeerd moet worden. Houd de hoeveelheid, eenheid, basis en producttoestand bij elkaar. Veiligheidswaarschuwingen en gebruiksaanwijzingen blijven afzonderlijke gereguleerde elementen, zelfs als ze uit dezelfde bron komen.

Gelaagde technische samenstelling. Gebruik voor samenstellingen zoals vloeren, isolatie, filters of matrassen. Geef de fysieke hiërarchie expliciet weer. Dikte mag als een bestanddeelkwalificatie verschijnen, maar niet-gerelateerde prestatie-specificaties horen in hun eigen tabel.

Compacte vergelijking. Alleen gebruiken wanneer twee of meer producten werkelijk vergelijkbare bestanddeelcategorieën hebben. Toon “Niet gedeclareerd” of “Niet van toepassing” in plaats van een lege cel. Houd het volledige gezaghebbende blok op elk productrecord; de vergelijking is een afgeleide weergave, geen nieuwe bron.

Parameters

“Bron” geeft aan waar de renderer elk veld vandaan haalt. Het goedgekeurde product- of regelgevingsrecord blijft gezaghebbend; de body mag gecontroleerde verklarende context toevoegen, maar mag de aan de bron gebonden feiten niet overschrijven.

De toegestane item.flag-waarden zijn implementatiegestuurd, bijvoorbeeld allergen, active, restricted of regulated-name. Een vlag activeert goedgekeurde presentatie en validatie; auteurs kunnen geen willekeurige vlaggen gebruiken om waarschuwingen of marketingbadges te creëren.

Syntax en codevoorbeelden

Alle drie de vormen geven hetzelfde jas-buitenstofrecord weer. De draagbare richtlijn is de canonieke auteurrepresentatie; een project moet de Hugo- en WordPress-adapters implementeren en testen voordat het wordt gepubliceerd.

Draagbare Markdown-richtlijn

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

Elke Hugo-parameter heeft een naam. Het voorbeeld mengt geen positionele en benoemde parameters.

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]

Een native WordPress-blok moet bestanddelen opslaan als herhaalbare getypeerde records, niet als één rich-text-veld. Vergrendel aan de bron gebonden namen en waarden wanneer ze uit een productinformatiebeheersysteem komen, terwijl een bevoegde beoordelaar marktspecifieke presentatie kan goedkeuren.

Goede en slechte voorbeelden

Goed

Materiaalsamenstelling — Harbor werkjas HJ-204, buitenstof: 65% gerecycled polyester; 35% biologisch katoen. Percentages zijn op basis van het vezelgewicht van de buitenstof. Polyurethaancoating is uitgesloten van de vezelpercentages. Voering: 100% polyester. Goedgekeurde bron HJ-204-US, revisie 6.

Dit werkt omdat het het exacte product en de onderdelen benoemt, een basis levert voor elke percentagegroep, de coating van de vezels onderscheidt en de goedgekeurde revisie vermeldt. De waarden tellen op binnen hun gedeclareerde reikwijdte in plaats van te doen alsof ze de hele jas beschrijven.

Slecht

Premium eco-mix: Voornamelijk natuurlijk katoen met gerecyclede prestatiesvezels en een planetvriendelijke beschermende afwerking.

Dit faalt omdat “voornamelijk” geen hoeveelheid is, “mix” de relatie tussen materialen verbergt en “afwerking” geen chemische of componentidentiteit heeft. Het laat de buitenstof-versus-voering-reikwijdte weg, doet een ongegronde milieuclaim en geeft geen bron of revisie. Een koper kan het niet vergelijken en een machine kan er geen verdedigbare bestanddelen uit halen.

Schema-opmaak en toegankelijkheid

Geen universeel compositieschema dekt elke gereguleerde productklasse. Voor een echt Product kan een eenvoudig materiaal worden toegewezen aan Schema.org’s material. Genoemde feiten kunnen soms worden toegewezen via additionalProperty en PropertyValue, waarbij name, value en unitText of unitCode bij elkaar blijven. Stabiele identificatoren moeten ze aan de zichtbare variant koppelen.

Forceer declaraties niet in niet-gerelateerde eigenschappen. Recipe.recipeIngredient beschrijft een recept, niet een verpakt productetiket. Geef nooit een percentage weer op basis van de lijstvolgorde en verander geen milieu- of allergeenafleiding in een feit. Genereer sectorfeeds uit het goedgekeurde record, niet uit gerenderde HTML.

Gestructureerde gegevens vullen de zichtbare declaratie aan, vervangen deze nooit. Machines mogen geen rijkere of anderszins afgebakende versie ontvangen. Als schema geen basis of kwalificatie kan uitdrukken, laat de eigenschap dan weg en behoud het zichtbare feit.

Gebruik een echte kop en één semantische container per declaratie. Geordende ingrediënten gebruiken lijsten; naam-waarderecords gebruiken beschrijvingslijsten of tabellen met koppen. Geneste samengestelde stoffen hebben een geneste lijststructuur nodig. De schermlezer-volgorde moet overeenkomen met de goedgekeurde volgorde.

Vertrouw nooit alleen op vet, hoofdletters, kleur, pictogrammen of tooltips voor allergenen of gereguleerde status. Neem vereiste tekst op in toegankelijke inhoud. Expandervakken hebben een knop, nauwkeurige status, toetsenbordbediening en een server-gerenderde fallback nodig. Zichtbare en toegankelijke eenheden moeten overeenkomen.

Schrijfregels

Het blok behoudt exacte productwaarheid, dus beknoptheid rechtvaardigt niet het weglaten van reikwijdte, basis, kwalificaties of vereiste namen. Pas deze regels toe na bevestiging van de bron en het marktbeleid:

• Geef het blok een titel van één tot vijf woorden. Gebruik bij voorkeur de terminologie die kopers en toezichthouders verwachten: “Ingrediënten”, “Materiaalsamenstelling” of “Actieve componenten”.
• Neem één tot 100 rijen op. Daarboven: gebruik beheerde groepering of een goedgekeurd document; kap nooit stilzwijgend af.
• Houd namen waar mogelijk op 120 tekens, maar behoud langere gereguleerde namen intact.
• Behoud de vereiste volgorde. Behoud anders de goedgekeurde productrecordvolgorde over alle kanalen heen.
• Koppel hoeveelheden aan eenheden en een basis. Forceer nooit onvergelijkbare lagen in een valse 100%-totalen.
• Gebruik cijfers voor hoeveelheden en gecontroleerde eenheidssymbolen. Lokaliseer decimale en eenheidspresentatie zonder de opgeslagen waarde te wijzigen.
• Maak onderscheid tussen “Niet gedeclareerd”, “Niet van toepassing”, “Hoeveelheid niet verstrekt” en nul; een lege waarde is dubbelzinnig.
• Houd notities binnen 40 woorden na de betreffende groep. Ze verduidelijken de reikwijdte, maar kunnen rijen niet overschrijven.
• Gebruik feitelijke, neutrale taal. Houd uitleg gescheiden van wettelijke of gestandaardiseerde namen.
• Controleer de exacte productklasse, markt, taal, variant en revisie. Valideer opnieuw bij elke relevante wijziging.

Plaats nooit prijs, voorraad, levering, getuigenissen, promotionele claims, afvalverwerkingsinstructies, doseringsaanwijzingen, veiligheidswaarschuwingen, volledige voedingsfeiten of niet-gerelateerde specificaties in het compositieblok. Die feiten mogen in de buurt staan in hun eigen gereguleerde elementen. Leid nooit “vrij van”, hypoallergeen, veganistisch, recyclebaar, natuurlijk, biologisch, niet-giftig of milieuvriendelijk uitsluitend af uit een bestanddeellijst. Gebruik nooit een verpakkingsfoto als de enige declaratie, omdat de tekst onleesbaar, verouderd, marktspecifiek en niet beschikbaar voor ondersteunende technologieën kan zijn.

Berichttypen die het gebruiken

Het postTypes-frontmatterveld is de implementatiebron voor deze matrix.

QA-checklist

• Het blok identificeert het exacte product, de SKU of formulering, de markt en de fysieke reikwijdte die het beschrijft.
• De declaratie komt van een goedgekeurde bron en de bron-ID, revisie en controledatum zijn bewaard.
• Elke bestanddeelnaam komt overeen met de goedgekeurde algemene, technische, gestandaardiseerde of gereguleerde naam.
• Geordende declaraties behouden de bronvolgorde; geen enkele renderer alfabetiseert, voegt samen of herordent de rijen.
• Elke numerieke waarde heeft een eenheid en een zichtbare basis, en bereiken of drempelwaarden behouden hun operatoren.
• Percentages tellen alleen op binnen een geldige gedeelde reikwijdte; uitgesloten lagen, coatings en componenten worden geïdentificeerd.
• Ontbrekend, nul, niet van toepassing en niet gedeclareerd worden als afzonderlijke toestanden weergegeven.
• Samengestelde ingrediënten of gelaagde materialen gebruiken expliciete geneste groepen in plaats van dubbelzinnige interpunctie.
• Vereiste allergeen-, actieve-component- of gereguleerde nadruk blijft beschikbaar in tekst en voor ondersteunende technologie.
• Het zichtbare blok, de productfeed, de verpakkingsbron, de schema-uitvoer en de variantselectie spreken elkaar niet tegen.
• Geen compositierij bevat prijs, beschikbaarheid, promotie, getuigenis, niet-ondersteund voordeel of afgeleide milieu- of veiligheidsclaims.
• De volledige declaratie werkt zonder afbeeldingen, hover, kleur, JavaScript of een uitgebreide desktopweergave.
• Wijzigingen in formulering, leverancier, component, verpakking, jurisdictie of revisie leiden tot hervalidatie.
• De drie syntaxvoorbeelden behouden hetzelfde onderwerp, dezelfde reikwijdte, basis, rijen, bron en revisie.

FAQ

Is een compositieblok hetzelfde als een specificatietabel?

Nee. Een compositieblok geeft aan uit welke bestanddelen een product bestaat en, waar relevant, de hoeveelheid of het aandeel van elk bestanddeel. Een specificatietabel beschrijft meetbare kenmerken zoals afmetingen, capaciteit, spanning of compatibiliteit. Houd de twee structuren gescheiden, zelfs als ze dicht bij elkaar staan.

Moet elk ingrediënt een percentage bevatten?

Nee. Neem een percentage op wanneer de geldende regelgeving, goedgekeurde bron of aankoopbeslissing dit vereist. Leid nooit een percentage af uit de volgorde van de lijst. Behoud de goedgekeurde ingrediëntenvolgorde en vermeld alleen een exacte hoeveelheid wanneer de bron een geldige basis en eenheid biedt.

Mag marketing de naam van gereguleerde ingrediënten of materialen herschrijven?

Nee. Weergavenamen mogen worden aangevuld met een eenvoudige uitleg wanneer het beleid dit toestaat, maar de vereiste wettelijke of gestandaardiseerde naam moet intact blijven. Marketingteksten mogen een gereguleerde verklaring niet vervangen, afkorten, herordenen of verzachten.

Genereert een compositieblok automatisch schema-opmaak?

Nee. Sommige velden kunnen worden toegewezen aan Product.material- of additionalProperty-waarden, maar er bestaat geen universeel Schema.org-compositieobject voor elke productklasse. Geef alleen ondersteunde eigenschappen weer die het zichtbare product nauwkeurig beschrijven en gebruik nooit gestructureerde gegevens als vervanging van de declaratie op de pagina.

Hoe moet de samenstelling verschillen tussen productvarianten of markten?

Koppel het blok aan de exacte SKU en markt. Als kleur, maat, smaak, formule, leverancier of bestemming de declaratie verandert, geef dan het bijbehorende goedgekeurde record weer en vermeld de reikwijdte. Combineer meerdere varianten niet in één lijst, tenzij elk bestanddeel en elke hoeveelheid daadwerkelijk identiek is.