additionalProperty
Auch bekannt als: schema:additionalProperty
1. Kurzdefinition
additionalProperty ist eine Schema.org-Property für strukturierte Zusatz-Metadaten in PropertyValue-Form — der flexible Mechanismus, um branchen-spezifische Wertungen, Identifier oder Kategorien an einer Entity auszuzeichnen, die nicht im Standard-Schema-Vokabular definiert sind.
2. Ausführliche Erklärung
additionalProperty ist die Schema.org-Property für strukturierte Metadaten, die nicht durch standardisierte Schema-Properties abgedeckt werden. Sie nimmt PropertyValue-Sub-Objekte als Werte auf — jedes mit name, value und optional minValue/maxValue, propertyID, description. Damit können beliebige strukturierte Zusatz-Informationen an einer Entity ausgezeichnet werden.
Aus GEO-Sicht ist additionalProperty der Hebel für branchen-spezifische Differenzierung. Wo das Standard-Schema.org-Vokabular endet, kann additionalProperty mit Custom-Eigenschaften ergänzen — z. B. ein eigener Bewertungsindex, ein Branchen-spezifischer Identifier, eine Kategorisierung nach internen Standards. Bei geoquality.ai ist der GEO Importance Rank (0-100) als additionalProperty an jedem DefinedTerm im Glossar ausgezeichnet — eine Custom-Bewertungsachse, die im Standard-Vokabular nicht existiert.
Technisch wird additionalProperty als PropertyValue-Sub-Objekt definiert. Die wichtigsten PropertyValue-Felder: name (sprechende Bezeichnung der Property), value (der eigentliche Wert), propertyID (eindeutiger Identifier der Property selbst, typisch in Format scheme:property), minValue und maxValue bei numerischen Wertungs-Skalen, description für Erklärung der Property.
Eine wichtige Konvention: propertyID sollte einen klaren Namespace tragen, der die Custom-Property als nicht-Standard-Schema markiert. Bei geoquality.ai's GEO Importance Rank: geoquality:geo-importance-rank als propertyID — der geoquality:-Prefix signalisiert „eigene Skala“, nicht zu verwechseln mit Standard-Properties.
Für eine Schweizer KMU mit branchen-spezifischen Wertungen oder Identifiern bedeutet additionalProperty konkret: jede Custom-Metrik kann maschinenlesbar an Entities ausgezeichnet werden. Eine Treuhand-Firma kann interne Service-Kategorien, ein Restaurant kann Stern-Bewertungs-Variationen, eine Beratung kann Schwierigkeitsgrad-Indikatoren über additionalProperty mitliefern. Der Hebel ist niche, aber wertvoll bei spezifischen Differenzierungs-Anforderungen.
3. Praxisbeispiel
DefinedTerm mit GEO Importance Rank als additionalProperty:
{
"@type": "DefinedTerm",
"@id": "https://www.geoquality.ai/glossar/json-ld#term",
"name": "JSON-LD",
"additionalProperty": {
"@type": "PropertyValue",
"propertyID": "geoquality:geo-importance-rank",
"name": "GEO Importance Rank",
"value": 92,
"minValue": 0,
"maxValue": 100,
"description": "Relevanz: 92/100. Stufe Fundamental."
}
}Eine PropertyValue-Sub-Entity mit allen relevanten Feldern: name als sprechende Bezeichnung, propertyID mit Namespace-Prefix, value als numerischer Score, minValue/maxValue für Skala-Definition, description für Bedeutungs-Klärung. Diese Custom-Bewertung ist maschinenlesbar und wird von KI-Modellen als zusätzliche Authority-Information genutzt.
4. Typische Fehler & Missverständnisse
- additionalProperty ohne propertyID auszeichnen — der Identifier ist kritisch für die Erkennbarkeit der Custom-Property.
- Plain-Werte (Strings, Zahlen) statt PropertyValue-Sub-Objekte — verliert die strukturelle Property-Information.
- additionalProperty bei Properties verwenden, die im Standard-Schema existieren — Schema-Standards sollten bevorzugt werden.
- Mehrere identische additionalProperty an derselben Entity ohne klare Differenzierung — propertyID muss innerhalb der Entity eindeutig sein.
- minValue und maxValue bei numerischen Skalen vergessen — ohne Skala-Definition sind Werte schwer interpretierbar.
5. Best Practices
- Verwende additionalProperty nur bei nicht-Standard-Schema-Eigenschaften — bei Standard-Properties die Standard-Properties nutzen.
- Pflege propertyID mit klarem Namespace (z. B. <code>geoquality:metric</code>, <code>company:internal-id</code>) — markiert Custom-Properties.
- Bei numerischen Skalen: minValue, maxValue und description für Skala-Erklärung setzen — macht Werte interpretierbar.
- Halte propertyIDs site-weit konsistent — dieselbe Custom-Property auf verschiedenen Entities mit derselben propertyID.
- Dokumentiere Custom-Properties in einer Konventions-Datei (z. B. <code>/property-definitions</code>) — externe Konsumenten brauchen Referenz.
- Bei mehreren additionalProperties: als Array von PropertyValue-Sub-Objekten — nicht verschachtelte Strukturen.
6. Fakten
- additionalProperty wurde 2014 in Schema.org Version 2.0 eingeführt — als Antwort auf Industrie-Anfragen für branchen-spezifische Erweiterungen.
- PropertyValue ist eine der vielseitigsten Schema.org-Sub-Types — wird sowohl für identifier (Organization-CHE-UID) als auch für additionalProperty genutzt.
- geoquality.ai's GEO Importance Rank ist als <code>geoquality:geo-importance-rank</code> propertyID an allen 56 DefinedTerms ausgezeichnet — strukturierte Branchen-Wertung.
- Im DACH-Raum nutzen 2026 nur etwa 5 Prozent aller KMU-Websites additionalProperty — primär bei E-Commerce-Sites mit branchen-spezifischen Produkt-Eigenschaften.
- Google Knowledge Panel zeigt additionalProperty-Werte teilweise direkt im Panel — wertvoll für Brand-Differenzierung.
- Schema.org's PropertyValue erlaubt auch unitText (Einheit) und unitCode (UN/CEFACT-Code) — wichtig für quantitative Wertungen mit Mass-Einheiten.
Definition von Marco Biner · Certified GEO Expert
additionalProperty ist 2026 das Werkzeug für branchen-spezifische Differenzierung. Bei geoquality.ai habe ich es konsequent für den GEO Importance Rank eingesetzt — eine Custom-Wertung, die im Standard-Vokabular nicht existiert. Was ich konsistent sehe: KMU mit gut gepflegten additionalProperties auf branchen-spezifischen Metriken haben deutlich höhere Differenzierung in KI-Antworten als Wettbewerber mit reinem Standard-Schema.
Mein Standard: bei jeder branchen-spezifischen Metrik (interne Bewertungen, Custom-Identifier, Kategorisierungen) additionalProperty mit klarem propertyID-Namespace. Dokumentation in einer Konventions-Datei. Setup ist minimaler Aufwand, Differenzierung kontinuierlich.
GEO Importance Rank
Wie wichtig ist dieser Begriff für Generative Engine Optimization?
FAQs
Wann nutze ich additionalProperty vs. Standard-Properties?
Standard-Properties immer wenn möglich — Schema.org definiert über 5000 Properties, die meisten gängigen Eigenschaften sind abgedeckt. additionalProperty nur bei wirklich branchen-spezifischen oder Custom-Werten, die nicht im Standard-Vokabular existieren. Beispiel: GEO Importance Rank ist Custom (additionalProperty), aber alternateName ist Standard (eigene Property).
Was muss in propertyID stehen?
Eine eindeutige Identifier-String, idealerweise mit Namespace-Prefix. Format: <code>scheme:property-name</code>. Beispiele: <code>geoquality:geo-importance-rank</code> für eine eigene Skala, <code>iso:9001</code> für ISO-Zertifikate, <code>che:uid</code> für Schweizer UID. Der Prefix signalisiert die Quelle/Definition der Property.
Kann additionalProperty mehrere Werte haben?
Ja, als Array von PropertyValue-Sub-Objekten. Eine Entity kann mehrere additionalProperty haben — z. B. ein Produkt mit mehreren Custom-Metriken (Eco-Score, Schwierigkeitsgrad, interne Kategorie). Jedes ist ein eigenes PropertyValue-Sub-Objekt im additionalProperty-Array.
Wie unterscheidet sich PropertyValue als additionalProperty vs. identifier?
PropertyValue ist ein Sub-Type, der für beide genutzt wird. identifier wird für eindeutige Identifier (CHE-UID, ISBN, GTIN) verwendet. additionalProperty für allgemeine Custom-Properties (Wertungen, Kategorien). Semantisch unterschiedlich, technisch identische PropertyValue-Struktur.
Werden additionalProperties in Rich Results gezeigt?
Eingeschränkt. Google zeigt manche additionalProperties in Knowledge Panels und spezifischen Rich Results — vor allem bei Produkten, Restaurants, Events. Bei generischen Properties ist die Sichtbarkeit gering. Der primäre Wert liegt in der maschinenlesbaren Auszeichnung für KI-Modelle, nicht in unmittelbarer Such-Sichtbarkeit.
Sollte ich Custom-Properties dokumentieren?
Ja, dringend. Eine Konventions-Datei (z. B. <code>/conventions/properties</code>) sollte alle Custom-propertyIDs der Site dokumentieren — mit Bedeutung, Skala, Beispielen. Das ist wichtig für externe Konsumenten und langfristige Konsistenz im eigenen Team. Bei geoquality.ai ist GEO Importance Rank in der zentralen jsonld-Modul-Doku beschrieben.
Verwandte Begriffe
Eigene AI-Sichtbarkeit messen
Kostenlose SEAKT-Analyse für jede Website — Score in unter 2 Minuten.
Jetzt analysieren →