Sammansättningsblock: Ingredienser, Material och Beståndsdelar
Bygg ett sammansättningsblock som strukturerar ingredienser, material, kvantiteter och reglerade produktfakta tydligt för köpare, sökmotorer och AI-agenter.
Ett sammansättningsblock är en strukturerad deklaration av vad en produkt består av. Det håller samman ingrediensnamn, materialtyper, komponentkvantiteter, procentandelar, funktioner och obligatoriska kvalificeringar så att en köpare inte behöver rekonstruera produkten från förpackningsfotografier eller marknadsföringstext.
Materialsammansättning
Produkt: Harbor arbetsjacka, yttertyg, stil HJ-204
- Återvunnen polyester
- 65 % av fibervikt
- Ekologisk bomull
- 35 % av fibervikt
- Beläggning
- Polyuretan; exkluderad från fiberprocent
Deklarationsgrund: endast yttertyg. Foder: 100 % polyester. Källa: godkänd produktpost HJ-204-US, revision 6.
Elementet separerar produkten och omfattningen från varje beståndsdel och värde. “65 % återvunnen polyester” är meningsfullt endast när läsaren vet om det beskriver yttertyget, fodret, fyllningen, hela plagget eller förpackningen.
Varför detta element är viktigt
Sammansättning påverkar beslut som produktslogans inte kan besvara. En shoppare kan vilja undvika ett allergen, jämföra ullhalt, kontrollera en beläggning, välja en återvinningsbar monomaterialsförpackning eller bekräfta en aktiv komponents koncentration. De kan avgöra om produkten är säker, lämplig, underhållsvänlig, policykompatibel eller värd sitt pris.
Struktur minskar besluts kostnaden. “Tillverkad med bomull, återvunnen polyester och en skyddande beläggning” lämnar läsarna att själva upptäcka vilken del varje material tillhör och om listan är fullständig. Märkta rader gör namn, värden och utelämningar lätta att skanna.
Sökmotorer, jämförelsesystem, shoppingagenter, tillgänglighetsverktyg och produktflöden behöver också behålla relationen mellan en beståndsdel, kvantitet, enhet, produktdel och variant. Kommatecken kan inte tillförlitligt visa om “bomull 35 %, polyesterfoder, polyuretanbelagd” betyder tre procentandelar, två tyger och en ytbehandling, eller ofullständig text.
Reglerade deklarationer gör tvetydighet allvarligare. Kontrollerade produktklasser kan ha marknadsspecifika krav på namn, ordning, betoning, kvantitet och språk. Eftersom skyldigheterna skiljer sig åt mellan produkt och jurisdiktion, bevara den godkända deklarationen, marknaden, revisionen och källan; be aldrig en skribent eller renderare att gissa sig till efterlevnad. Struktur gör inte innehåll kompatibelt, men det gör obligatoriska fält testbara.
När du ska använda det
Använd ett sammansättningsblock när beståndsdelens identitet eller mängd påverkar val, säker användning, efterlevnad, jämförelse, skötsel, återvinning eller upphandling. Användningsområden inkluderar:
- ingrediensdeklarationer för mat och dryck, med separat reglerad allergenmarkering där så krävs;
- kosmetiska ingrediensnamn i godkänd ordning och nomenklatur;
- textila fibersammansättningar uppdelade på yttertyg, foder, fyllning, kantband eller annan relevant del;
- möbel- och byggmaterial separerade efter strukturellt lager eller komponent;
- kemiska blandningar och aktiva komponenter med koncentrationer och en deklarerad grund;
- kosttillskott eller formulerade produkter där ingrediensens identitet och mängd måste vara tydlig;
- förpackningssammansättning som används för avfallshantering, återvinning eller miljöpåståenden;
- tekniska sammansättningar där “sammansättning” avser en avgränsad lista av ingående material snarare än en fullständig delkatalog.
Använd ett block per godkänd omfattning. En madrass kan ha namngivna grupper för överdrag, komfortlager och kärna; olika smaker behöver separata poster. Varje rad måste vara sann för produkten, varianten, marknaden och revisionen som anges högst upp.
Nära träffar behöver andra strukturer. Dimensioner, spänning, kompatibilitet och prestanda är specifikationer. Näring beskriver näringsämnen och en portionsgrund, inte nödvändigtvis ingredienser. Skötselråd beskriver beteende efter köp. Separata allergenuttalanden behöver sin egen godkända behandling. “Miljövänlig” är varken en beståndsdel eller bevis. En tillverkningsstycklista kan vara för detaljerad eller konfidentiell för kunder.
Skrivreglerna för element har företräde: välj det typade elementet efter avsnittets syfte. Om blockets uppgift är att identifiera vad ämnet består av, använd sammansättning även när en generisk tabell, ett generiskt accordeon eller ett stycke skulle kunna imitera dess utseende.
Var du ska placera det
Placera det primära blocket efter produktidentitet och köpfakta men före påståenden, instruktioner eller vägledning som är beroende av sammansättning. Det föregår normalt skötsel, säkerhet, hållbarhet och detaljerade specifikationer. Regulatoriska placeringskrav åsidosätter redaktionella preferenser.
En kompakt sammanfattning i köpområdet måste innehålla beslutskritiska fakta och visa hela deklarationen utan att ändra sammanhang. Behåll hela innehållet i sidkällan och gör det tillgängligt utan JavaScript.
Håll blocket bredvid dess omfångsetikett. Det kan ligga intill en bild eller specifikationstabell med tydliga rubriker. Det får inte ligga intill en annan variants påstående, en okvalificerad miljömärkning eller motsägelsefull marknadsföring. Infoga aldrig ett vittnesmål, erbjudande, korsförsäljning eller CTA mellan deklarationsrubriken och raderna.
För flerpack, kit och konfigurerbara produkter, placera varje självständigt formulerad artikel i en märkt undergrupp. Genomsnittsberäkna aldrig sammansättningar över förpackningen. På mobil, bevara ordningen: ämne och omfattning, grund, beståndsdelar, kvalificeringar, källa eller revision. Visuella kolumner kan kollapsa, men relationer får inte.
Anatomi
- Titel: benämner deklarationen tydligt, till exempel “Ingredienser”, “Materialsammansättning” eller “Aktiva komponenter”.
- Ämnesidentitet: binder innehållet till en exakt produkt, SKU, variant, formulering eller komponent.
- Omfattning: anger marknaden, produktdelen, beredningsstadiet, förpackningskomponenten eller annan avgränsning som bestämmer vad raderna beskriver.
- Deklarationsgrund: förklarar vad kvantiteter betyder, såsom procent av fibervikt, milligram per tablett eller gram per 100 gram som såld.
- Beståndsdelsnamn: bevarar det godkända allmänna, tekniska, standardiserade eller reglerade namnet.
- Mängd: anger ett tal, intervall, tröskelvärde eller avsiktligt frånvarande tillstånd utan gissningar.
- Enhet eller andel: hålls samman med sin mängd och använder en definierad konvention inom en grupp.
- Roll eller kvalificering: identifierar funktioner, underingredienser, beläggningar, bärare, processhjälpmedel eller undantag endast när godkänt och relevant.
- Obligatorisk markering: exponerar ett allergen, aktiv komponent eller obligatorisk fras genom text och semantisk markering, inte enbart färg.
- Ursprung: registrerar den godkända källan, marknaden, revisionen och granskningsdatum som använts för att rendera deklarationen.
Designexempel
Varje designvariant använder samma underliggande beståndsdelsposter. Varianten ändrar etiketter och gruppering eftersom produktklassen ställer en annan fråga; den förvandlar aldrig en verifierad deklaration till fri marknadsföringstext.
Ordnade ingredienser. Använd när ordningsföljden är meningsfull eller reglerad. Bevara källans ordning, skiljetecken, nästlade ingredienser och obligatorisk markering. Alfabetisera inte för visuell prydlighet och slå inte samman två godkända namn till en vänligare etikett.
Materialprocent per komponent. Använd för textilier, möbler, förpackningar eller skiktade varor. Gruppera efter fysisk del, ange vad procentandelarna summerar inom och skilj en ytbehandling från det underliggande fiber- eller materialet.
Aktiva komponenter och koncentrationer. Använd när en aktiv substans eller funktionell beståndsdel måste kvantifieras. Håll mängd, enhet, grund och produktens tillstånd tillsammans. Säkerhetsvarningar och anvisningar förblir separata styrda element även när de härrör från samma källa.
Skiktad teknisk sammansättning. Använd för sammansättningar som golv, isolering, filter eller madrasser. Representera den fysiska hierarkin explicit. Tjocklek kan visas som en kvalificering av beståndsdelen, men orelaterade prestandaspecifikationer hör hemma i sin egen tabell.
Kompakt jämförelse. Använd endast när två eller fler produkter har genuint jämförbara beståndsdelskategorier. Visa “Ej deklarerat” eller “Ej tillämpligt” istället för en tom cell. Behåll det fullständiga auktoritativa blocket i varje produktpost; jämförelsen är en härledd vy, inte en ny källa.
Parametrar
“Källa” identifierar var renderaren hämtar varje fält. Den godkända produkt- eller regulatoriska posten förblir auktoritativ; brödtexten kan lägga till kontrollerad förklarande kontext men får inte åsidosätta källbundna fakta.
| Namn | Typ | Obligatorisk | Min/max | Standard | Källa |
|---|---|---|---|---|---|
| title | Ren sträng | Nej | 1–5 ord | Sammansättning | Första rubrik i brödtext |
| subject | Produkt- eller komponentidentifierare | Ja | 1 värde; 1–80 tecken | Produkt från sidan | Attribut |
| variant | SKU- eller formuleringsidentifierare | Villkorlig | 1 exakt värde; 1–64 tecken | Ägande produkt | Attribut |
| market | Kontrollerad marknads- eller jurisdiktionskod | Ja för reglerat innehåll | 1–8 koder | Webbplatsens marknad | Attribut |
| scope | Ren sträng eller kontrollerad komponent-ID | Ja | 1–8 grupper; 1–50 tecken var | hela-produkten | Attribut |
| basis | Kontrollerad sträng | Krävs när mängder visas | 1 per grupp; 2–12 ord | Ingen | Attribut |
| ordered | Boolesk | Nej | true eller false | false | Attribut |
| items | Beståndsdelsposter | Ja | 1–100 rader | Ingen | Brödtext |
| item.name | Godkänt rent eller standardiserat namn | Ja | 1–120 tecken | Ingen | Brödtext |
| item.amount | Decimal, intervall, tröskelvärde eller null | Villkorlig | 0 eller större; 1 värde | Ej deklarerat | Brödtext |
| item.unit | Kontrollerad enhet eller procent | Krävs med mängd | 1 enhet | Ärvt från grund | Brödtext |
| item.role | Kontrollerad eller godkänd ren sträng | Nej | 1–6 ord | Frånvarande | Brödtext |
| item.flag | Uppräkningslista | Nej | 0–4 värden | Ingen | Brödtext |
| revision | Ren identifierare | Ja för reglerat innehåll | 1 värde; 1–40 tecken | Ingen | Attribut |
| reviewed | ISO 8601-datum | Ja för reglerat innehåll | 1 datum | Ingen | Attribut |
| source | Godkänt system- eller dokument-ID | Ja | 1–3 värden | Ingen | Attribut |
| note | Ren text | Nej | 0–40 ord | Frånvarande | Brödtext |
De tillåtna item.flag-värdena är implementationsstyrda, till exempel allergen, active, restricted eller regulated-name. En flagga utlöser godkänd presentation och validering; författare kan inte använda godtyckliga flaggor för att skapa varningar eller marknadsföringsmärken.
Syntax och kodexempel
Alla tre former kodar samma jackas yttertygspost. Det portabla direktivet är den kanoniska författarrepresentationen; ett projekt måste implementera och testa Hugo- och WordPress-adaptern innan det publiceras.
Portabelt Markdown-direktiv
:::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-kortkod
{{< 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 >}}
Varje Hugo-parameter har ett namn. Exemplet blandar inte positionsbaserade och namngivna parametrar.
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]
Ett inbyggt WordPress-block bör lagra beståndsdelar som repeterbara typade poster, inte som ett riktextfält. Lås källbundna namn och värden när de kommer från ett produktinformationshanteringssystem, samtidigt som du tillåter en auktoriserad granskare att godkänna marknadsspecifik presentation.
Bra och dåliga exempel
Bra
Materialsammansättning — Harbor arbetsjacka HJ-204, yttertyg: 65 % återvunnen polyester; 35 % ekologisk bomull. Procentandelarna är baserade på fibervikt av yttertyget. Polyuretanbeläggning är exkluderad från fiberprocent. Foder: 100 % polyester. Godkänd källa HJ-204-US, revision 6.
Detta fungerar eftersom det namnger den exakta produkten och delarna, anger en grund för varje procentgrupp, skiljer beläggningen från fibrerna och visar den godkända revisionen. Värdena summerar inom sin deklarerade omfattning istället för att låtsas beskriva hela jackan.
Dåligt
Premium ekologisk blandning: Mestadels naturlig bomull med återvunna prestandafibrer och en miljövänlig skyddande ytbehandling.
Detta misslyckas eftersom “mestadels” inte är en mängd, “blandning” döljer relationen mellan material och “ytbehandling” har ingen kemisk eller komponentidentitet. Det utelämnar omfattningen yttertyg kontra foder, gör ett ogrundat miljöpåstående och anger ingen källa eller revision. En köpare kan inte jämföra det, och en maskin kan inte extrahera försvarbara beståndsdelar.
Schemamarkering och tillgänglighet
Ingen universell sammansättningsschema täcker varje reglerad produktklass. För en genuin Product kan ett enkelt material mappas till Schema.orgs material. Namngivna fakta kan ibland mappas via additionalProperty och PropertyValue, med name, value och unitText eller unitCode tillsammans. Stabila identifierare måste binda dem till den synliga varianten.
Tvinga inte deklarationer till orelaterade egenskaper. Recipe.recipeIngredient beskriver ett recept, inte en förpackad produktetikett. Avge aldrig en procentandel från listordning eller förvandla en miljö- eller allergeninferens till fakta. Generera sektorsflöden från den godkända posten, inte från renderad HTML.
Strukturerad data kompletterar, ersätter aldrig, den synliga deklarationen. Maskiner får inte få en rikare eller annorlunda avgränsad version. Om schema inte kan uttrycka en grund eller kvalificering, utelämna egenskapen och bevara det synliga faktumet.
Använd en verklig rubrik och en semantisk behållare per deklaration. Ordnade ingredienser använder listor; namn-värde-poster använder definitionslistor eller tabeller med rubriker. Nästlade föreningar behöver nästlad liststruktur. Skärmläsares ordning måste matcha godkänd ordning.
Förlita dig aldrig enbart på fetstil, versaler, färg, ikoner eller verktygstips för allergener eller reglerad status. Inkludera obligatorisk text i tillgängligt innehåll. Expanderare behöver en knapp, korrekt tillstånd, tangentbordsoperation och serverrenderad reserv. Synliga och tillgängliga enheter måste överensstämma.
Skrivregler
Blocket bevarar exakt produktinformation, så kortfattadhet kan inte motivera att omfattning, grund, kvalificeringar eller obligatoriska namn utelämnas. Tillämpa dessa regler efter att ha bekräftat källan och marknadspolicyn:
- Rubriksätt blocket med ett till fem ord. Använd det vokabulär köpare och regulatorer förväntar sig: “Ingredienser”, “Materialsammansättning” eller “Aktiva komponenter”.
- Inkludera en till 100 rader. Däröver, använd styrd gruppering eller ett godkänt dokument; tyst trunkera aldrig.
- Håll namn till 120 tecken där möjligt, men bevara längre reglerade namn intakta.
- Bevara obligatorisk ordning. Behåll i övrigt den godkända produktpostens sekvens över kanaler.
- Koppla mängder till enheter och en grund. Tvinga aldrig in icke-jämförbara lager i en falsk 100 %-summa.
- Använd siffror för kvantiteter och kontrollerade enhetssymboler. Lokalisera decimal- och enhetspresentation utan att ändra det lagrade värdet.
- Skilj mellan “Ej deklarerat”, “Ej tillämpligt”, “Mängd ej angiven” och noll; en blank är tvetydig.
- Håll anteckningar till 40 ord efter den berörda gruppen. De förtydligar omfattning men kan inte åsidosätta rader.
- Använd sakligt, neutralt språk. Håll förklaringar åtskilda från juridiska eller standardiserade namn.
- Granska den exakta produktklassen, marknaden, språket, varianten och revisionen. Oavalidiera varje relevant förändring.
Sätt aldrig pris, lager, leverans, vittnesmål, reklampåståenden, avfallshanteringsinstruktioner, doseringsanvisningar, säkerhetsvarningar, fullständig näringsinformation eller orelaterade specifikationer inuti sammansättningsblocket. Dessa fakta kan finnas i närheten i sina egna styrda element. Sluta dig aldrig till “fri från”, hypoallergent, veganskt, återvinningsbart, naturligt, ekologiskt, giftfritt eller miljömässigt fördelaktigt enbart från en beståndsdelslista. Använd aldrig ett förpackningsfotografi som enda deklaration, eftersom dess text kan vara oläslig, inaktuell, marknadsspecifik och otillgänglig för hjälpmedelsteknik.
Posttyper som använder det
Fältet postTypes i frontmatter är implementeringskällan för denna matris.
| Posttyp | Roll | Placering | Obligatorisk anpassning |
|---|---|---|---|
| Produktsida | Auktoritativ kunddeklaration | Efter identitet och köpfakta, före beroende påståenden eller instruktioner | Bind till exakt SKU, marknad, omfattning och godkänd revision |
| Kategorisida | Filtrerings- eller kompakt jämförelsefakta | Endast i filter eller produktsammanfattningar när värden är normaliserade | Behåll fullständig deklaration i produktposten och visa saknade tillstånd |
| Köparguide | Beslutskriterium | Efter förklaring av varför ett material eller ingrediens är viktigt | Citera aktuella källbaserade fakta utan att antyda säkerhet eller kvalitet enbart från sammansättning |
| Jämförelsesida | Likvärdig beståndsdelsjämförelse | Inom ett gemensamt kriterieavsnitt | Justera omfattning och grund; jämför aldrig hela produktvärden med en enskild komponent |
| Recensionssida | Verifierad produktfakta som stöder analys | Nära relevant fynd eller produktfaktaavsnitt | Separera tillverkares deklaration från observationer gjorda under testning |
| Standard- eller regelsida | Exempel på en berörd deklaration | Efter att omfattning och skyldighet är definierade | Märk jurisdiktion, giltig version, undantag och auktoritativ källa |
| Agentisk produktdata | Maskinåtgärdbar beståndsdelspost | Inom den exakta produkt- eller variantentiteten | Exponera typade namn, värden, enheter, grund, omfattning, ursprung och revision |
QA-checklista
- Blocket identifierar den exakta produkten, SKU eller formulering, marknad och fysiska omfattning det beskriver.
- Deklarationen kommer från en godkänd källa, och dess käll-ID, revision och granskningsdatum är bevarade.
- Varje beståndsdelsnamn matchar det godkända allmänna, tekniska, standardiserade eller reglerade namnet.
- Ordnade deklarationer bevarar källans ordning; ingen renderare alfabetiserar, slår samman eller omordnar raderna.
- Varje numeriskt värde har en enhet och en synlig grund, och intervall eller tröskelvärden behåller sina operatorer.
- Procentandelar summerar endast inom en giltig gemensam omfattning; exkluderade lager, beläggningar och komponenter är identifierade.
- Saknade, noll, ej tillämpligt och ej deklarerat representeras som distinkta tillstånd.
- Sammansatta ingredienser eller skiktade material använder explicita nästlade grupper snarare än tvetydig interpunktion.
- Obligatorisk allergen-, aktiv-komponent- eller reglerad markering förblir tillgänglig i text och för hjälpmedelsteknik.
- Det synliga blocket, produktflödet, förpackningskällan, schemautmatningen och variantvalet motsäger inte varandra.
- Ingen sammansättningsrad innehåller pris, tillgänglighet, kampanj, vittnesmål, ogrundad förmån eller härledda miljö- eller säkerhetspåståenden.
- Hela deklarationen fungerar utan bilder, hovring, färg, JavaScript eller en expanderad skrivbordslayout.
- Ändringar i formulering, leverantör, komponent, förpackning, jurisdiktion eller revision utlöser omvalidering.
- De tre syntaxexemplen bevarar samma ämne, omfattning, grund, rader, källa och revision.
FAQ
Är ett sammansättningsblock samma sak som en specifikationstabell?
Nej. Ett sammansättningsblock identifierar vad en produkt består av och, där relevant, mängden eller andelen av varje beståndsdel. En specifikationstabell beskriver mätbara egenskaper som dimensioner, kapacitet, spänning eller kompatibilitet. Håll de två strukturerna åtskilda även när de förekommer nära varandra.
Måste varje ingrediens innehålla en procentandel?
Nej. Inkludera en procentandel när den gällande regeln, godkända källan eller köparens beslut kräver det. Dra aldrig slutsatsen om en procentandel från listans ordning. Bevara den godkända ingrediensordningen och visa en exakt mängd endast när källan tillhandahåller en giltig grund och enhet.
Kan marknadsavdelningen skriva om reglerade ingrediens- eller materialnamn?
Nej. Visningsnamn kan kompletteras med en förklaring på klarspråk när policyn tillåter det, men det obligatoriska juridiska eller standardiserade namnet måste förbli intakt. Marknadstext kan inte ersätta, förkorta, omordna eller mildra en reglerad deklaration.
Producerar ett sammansättningsblock automatiskt schemamarkering?
Nej. Vissa fält kan mappas till Product.material- eller additionalProperty-värden, men det finns inget universellt Schema.org-sammansättningsobjekt för varje produktklass. Publicera endast egenskaper som stöds och som korrekt beskriver den synliga produkten, och använd aldrig strukturerad data som ersättning för deklarationen på sidan.
Hur ska sammansättningen skilja sig mellan produktvarianter eller marknader?
Bind blocket till exakt SKU och marknad. Om färg, storlek, smak, formel, leverantör eller destination ändrar deklarationen, rendera den matchande godkända posten och identifiera dess omfattning. Kombinera inte flera varianter i en enda lista om inte varje beståndsdel och mängd är genuint identisk.
Fler tutorials i det här avsnittet
Redo att omsätta det i praktiken?
Gratis kontroll · 7 dagars provperiod · inget kreditkort