product_detail- en product_highlight-waarden schrijven die Google accepteert, met uitgewerkte feedrijen

Het attribuut product_detail van Google accepteert tot 100 items per product, elk van 1 tot 150 tekens lang, en product_highlight vraagt om minimaal 2 en adviseert 4 tot 6 korte voordeelstellingen per item. Dat staat in de eigen specificaties van Google voor productdetails en producthighlights. Beide zijn optioneel, dus de meeste feeds slaan ze over of plakken er een specificatietabel in die Merchant Center afkeurt vanwege een onjuiste opmaak.

Google zegt dat product_detail helpt om producten te tonen op AI-oppervlakken zoals AI Mode, en in mei 2026 voegde Google op hetzelfde idee meer conversationele attributen toe.

Deze referentie is bedoeld voor feedmanagers en bureaus die productdata naar Google Merchant Center sturen. Aan het eind kun je beide attributen schrijven in TSV en XML, de tekens escapen die ze breken, verboden inhoud weren en een rij beoordelen voordat je die indient.

Waar product_detail en product_highlight voor dienen

De twee attributen lijken op elkaar en worden vaak uit dezelfde bron gevuld, maar Google geeft ze een verschillende taak. product_detail bevat technische, verifieerbare specificaties die niet door een ander attribuut worden gedekt: inhoud van de verpakking, connectiviteit, ingrediënten, stroomvereisten, afwerking, geur en vergelijkbare feiten. product_highlight bevat korte verkoopvoordelen, geschreven als gewone zinnen.

Onze snelle test: als de regel in een specificatietabel past met een label en een waarde, is het een product_detail. Als het klinkt als een zin die een winkelmedewerker zou zeggen, is het een product_highlight. De highlight-specificatie van Google maakt dezelfde splitsing en vraagt je het ene niet in het andere te herhalen.

De specificatie in één overzicht

Dit zijn de limieten zoals Google ze nu publiceert. Google noemt geen schema.org-property voor product_detail, dus het wordt niet opgepikt uit je gestructureerde datamarkup; het moet in de feed staan.

Bronnen: Google Merchant Center Help, Product detail [product_detail] en Product highlight [product_highlight].

product_detail schrijven in TSV, XML en de Merchant API

Het formaat is waar de meeste rijen falen. Elk detail bestaat uit drie waarden die met twee dubbele punten zijn verbonden, in de volgorde sectienaam, attribuutnaam, attribuutwaarde. Google is expliciet: in tekstfeeds moet elk detail twee dubbele punten hebben, en als je een ander aantal subattributen aanlevert dan je header aangeeft, ontstaat een "invalid sub-attribute format"-melding onder "Needs attention".

TSV-header en één enkele cel

Declareer de subattributen in de kolomheader, tussen haakjes en gescheiden door dubbele punten. Zodra ze in de header zijn benoemd, kunnen de waarden in elke volgorde volgen die je declareert. Zonder declaratie gaat Google uit van sectie, naam, waarde.

product_detail(section_name:attribute_name:attribute_value)

Een cel met drie details ziet er dan zo uit:

General:Brew type:Turkish coffee,General:Capacity:4 cups,Power:Rated power:1000 W

Als een detail geen sectie heeft, behoud je de beginnende dubbele punt en laat je het eerste veld leeg:

:What's in the box?:"Machine,Measuring spoon,User manual"

Dubbele punten, komma's en aanhalingstekens escapen

De regels van Google voor attributen tussen aanhalingstekens gelden voor groepsattributen zoals dit:

• Zet elke subattribuutwaarde die een komma of dubbele punt bevat tussen rechte dubbele aanhalingstekens. Citeer de afzonderlijke waarde, niet de hele groep.
• Schrijf een letterlijk dubbel aanhalingsteken als twee dubbele aanhalingstekens. Het eigen voorbeeld van Google is "APS-C max. 12""" voor een waarde die eindigt op een inchteken.
• Gebruik geen backslash-escaping. Google leest een backslash als een letterlijk teken.
• Velden tussen aanhalingstekens worden niet ondersteund voor Google Sheets-gegevensbronnen. Bij bestaande bestandsbronnen moeten velden tussen aanhalingstekens worden ingeschakeld in de instellingen van de gegevensbron.

XML

In XML is elk detail een eigen element met drie onderliggende elementen, dus escaping van dubbele punten of komma's is niet nodig:

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

Voor specificatierijke categorieën is XML het veiligere formaat, omdat natuurlijke komma's en dubbele punten dan geen parseerrisico meer vormen.

Merchant API

Via de Merchant API is elk detail een ProductDetail-object met de velden sectionName, attributeName en attributeValue, volgens de API-clientreferentie.

product_highlight schrijven

Highlights zijn eenvoudiger: één string per highlight. Scheid highlights in een tekstfeed met komma's en zet elke highlight met een komma of dubbele punt tussen dubbele aanhalingstekens. Geef in XML elke highlight een eigen <g:product_highlight>-element.

"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"

Beperk elke highlight tot één voordeel. Google vraagt om professionele, grammaticaal correcte taal zonder hoofdletteremphasis, zonder symbolen en zonder promotionele formuleringen.

Inhoud die Google in geen van beide attributen toestaat

Opmaakfouten leveren zichtbare foutmeldingen op. Inhoudelijke fouten zijn stiller: een rij kan worden geaccepteerd en toch het beleid schenden. Deze tabel combineert de verboden uit beide specificaties.

Google voegt nog een regel toe die makkelijk over het hoofd wordt gezien: als je document_link-bestanden indient die dezelfde informatie al bevatten, laat die dan weg uit deze attributen en laat Google ze uit de documenten halen.

Uitgewerkt voorbeeld: een specificatietabel omgezet in geaccepteerde rijen

Hieronder staat een typische rij van een winkel die zijn productspecificaties als één vrij tekstveld exporteert. Het product is een elektrische Turkse koffiemachine; de winkel verkoopt in Turkije en in het Engels aan de Golfmarkten.

Voor

product_detail: Brand: Acme, Power: 1000W, Material: Stainless Steel, Plastic, FREE SHIPPING, best turkish coffee maker cheap

Vijf problemen in één cel. De scheidingstekens zijn door elkaar gebruikt, dus het aantal dubbele punten komt niet overeen met de header. "Stainless Steel, Plastic" staat niet tussen aanhalingstekens, dus de komma splitst het detail. Brand dupliceert het attribuut brand. "FREE SHIPPING" is verzendtekst in hoofdletters. Het laatste fragment is een reeks zoekwoorden.

Na, Engelse feed

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"

Brand is verplaatst naar een eigen attribuut, verzending naar shipping, zoekwoorden zijn verwijderd, waarden staan in zinshoofdletters zoals Google aanbeveelt, en elke waarde met een komma staat tussen aanhalingstekens. "Automatic shut-off: Yes" blijft staan omdat de fabrikant het bevestigt; een veld dat je platform standaard op "No" zet, zou dat niet doen.

Na, Turkse feed

Google vraagt om sectienamen, attribuutnamen en waarden te lokaliseren in elke taalfeed, dus de Turkse feed krijgt een eigen rij in plaats van de Engelse:

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"

Twee regionale punten voor teams buiten Turkije. Behoud ten eerste de Turkse letters. De ASCII-aanbeveling van Google is een voorkeur, geen vereiste, en de highlight-specificatie staat letters met accenten expliciet toe; "Paslanmaz çelik" transliteren naar "Paslanmaz celik" levert een spelfout op, wat botst met de richtlijnen van Google voor grammatica en spelling. Ten tweede: als een regel deze waarden omzet naar kleine letters of zinshoofdletters, is taalafhankelijke hoofdlettergebruik nodig, zodat "İ" en "I" niet de verkeerde letters worden, een probleem dat we behandelden in onze gids over Turkse hoofdletters in titels.

De waarden opbouwen vanuit je catalogus

Wij vullen deze attributen in vier stappen, in deze volgorde.

1. Breng eerst gestructureerde bronnen in kaart. Maak een lijst van elke specificatie die je platform al opslaat als label-waardepaar, zoals een specificatietab, een metafield of een ERP-attribuut. Elk paar wordt één product_detail, met de brongroep als section_name. Gebruik een feedlaag zoals feed rules of een aanvullende feed, zodat de brondcatalogus onaangeroerd blijft en de Google-output kan afwijken van andere kanalen.
2. Verwijder alles wat een ander attribuut al afdekt. Schrap regels over merk, kleur, maat, materiaal, prijs en verzending als ze al in hun eigen attributen staan. Verwijder daarna elk detail waarvan de tekst al in de titel of beschrijving voorkomt.
3. Schrijf highlights met de hand of met gecontroleerde AI-concepten. Bij highlights helpt AI-verrijking het meest en gaat het ook het vaakst mis. Een model schrijft graag "Ideal gift for coffee lovers", wat promotioneel is, of verzint een functie die het product niet heeft. Genereer concepten alleen op basis van bevestigde specificaties en toets ze aan de verbodstabel hierboven.
4. Valideer lengte en syntaxis vóór export. Controleer dat elk detail en elke highlight maximaal 150 tekens heeft, dat elk detail precies twee dubbele punten zonder aanhalingstekens bevat en dat het aantal highlights per product minimaal 2 is.

Een scoringsrubric om te gebruiken voordat je indient

Beoordeel een steekproef van 20 rijen per categorie. Elke controle is geslaagd (1) of mislukt (0), met een maximum van 10 per rij. Wij beschouwen 9 of 10 als klaar, 7 of 8 als eerst herstellen en dan verzenden, en alles daaronder als teken dat de brondata eerst verbeterd moet worden voordat het de moeite loont deze attributen te sturen.

Waar deze gids tekortschiet

We weten niet hoeveel deze attributen de ranking of het doorklikpercentage beïnvloeden. Google zegt dat product_detail helpt om producten te tonen bij relevante zoekopdrachten, ook in AI Mode, maar publiceert geen cijfer, en we hebben geen gecontroleerde openbare studie gezien. Wees wantrouwend tegenover percentages van leveranciers zolang er geen methode bij zit.

Dit is een Google-referentie. De productfeedspecificatie van OpenAI heeft geen algemeen sleutel-waardeveld voor specificaties en geen highlightsveld; die gebruikt platte velden zoals material, dimensions en weight, plus een beschrijving van 5.000 tekens. Als je die feed ook verstuurt, moeten je specificaties in die velden of in de beschrijving worden gemapt. Voor deze gids hebben we geen equivalenten bij Meta of TikTok geverifieerd.

Ook de nieuwere conversationele attributen, zoals question_and_answer en document_link, blijven buiten beschouwing, op de bovenstaande regel over overlap na. Verschillende feedleveranciers, waaronder Channable en Productsup, publiceerden daar eerder dan wij mappinggidsen over, en die zijn het lezen waard als je die set nu nodig hebt.

Tot slot: als je catalogus geen gestructureerde specificaties heeft, kan deze methode ze niet creëren, en AI-concepten zonder bevestigde bron zijn precies wat de regel van Google om "alleen bevestigde waarden in te dienen" wil tegengaan.

Veelgestelde vragen

Is product_detail verplicht in Google Merchant Center?

Nee. Google noemt het voor elk product optioneel. Het is de moeite waard om toe te voegen waar je geverifieerde specificaties hebt die geen ander attribuut dekt, omdat Google zegt dat het helpt om producten te tonen bij relevante zoekopdrachten, ook in AI Mode.

Hoeveel producthighlights moet ik indienen?

Google vereist er minimaal 2, staat er maximaal 100 toe en adviseert 4 tot 6 per product. Elke highlight mag maximaal 150 tekens lang zijn.

Waarom meldt Merchant Center dat mijn product_detail een "invalid sub-attribute format" heeft?

Het aantal subattributen in een waarde komt niet overeen met de header, meestal omdat er een dubbele punt ontbreekt in een detail of omdat een komma of dubbele punt zonder aanhalingstekens in een waarde het detail splitste. Zet elke waarde met die tekens tussen aanhalingstekens en houd twee dubbele punten per detail aan.

Moet ik Turkse tekens gebruiken in een Turkse feed?

Ja. Google accepteert Unicode en adviseert ASCII slechts als voorkeur, terwijl de highlight-richtlijnen letters met accenten toestaan en om correcte spelling vragen. Het weghalen van Turkse letters leidt tot verkeerd gespelde woorden.

Kan AI mijn producthighlights schrijven?

Het kan concepten maken, maar alleen op basis van specificaties die je hebt bevestigd, en elk concept moet worden gecontroleerd op promotionele formuleringen, vergelijkingen en verzonnen functies. Google verbiedt de eerste twee in highlights, en een verzonnen functie is simpelweg onjuiste productdata.

Ondersteunt Google Sheets product_detail-waarden tussen aanhalingstekens?

Nee. In de richtlijnen van Google over attributen tussen aanhalingstekens staat dat velden tussen aanhalingstekens niet worden ondersteund voor Google Sheets-gegevensbronnen. Specificatiewaarden met komma's of dubbele punten kun je dus beter versturen via een TSV-bestand, XML of de Merchant API.

Controleer je feed voordat je deze attributen toevoegt

Deze attributen helpen alleen als de velden waarop ze voortbouwen schoon zijn. Laat je feed door de gratis productfeed-audittool lopen om per product de volledigheid, kwaliteit en technische problemen te zien voordat je begint met het schrijven van details en highlights.