--- title: additionalProperty slug: additional-property canonical_url: https://www.geoquality.ai/glossar/additional-property md_url: https://www.geoquality.ai/glossar/additional-property.md language: de last_modified: 2026-05-03T00:00:00+00:00 related_terms: [defined-term, identifier-property, json-ld, property-value, schema-org, structured-data] content_hash: 28762d90ae6acb4a license: CC BY 4.0 author: Marco Biner (geoquality.ai) schema_type: DefinedTerm --- # additionalProperty 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. ## Erläuterung 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. ## 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. ## Häufige Fehler - 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. ## Best Practices - Verwende additionalProperty nur bei nicht-Standard-Schema-Eigenschaften — bei Standard-Properties die Standard-Properties nutzen. - Pflege propertyID mit klarem Namespace (z. B. geoquality:metric, company:internal-id) — 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. /property-definitions) — externe Konsumenten brauchen Referenz. - Bei mehreren additionalProperties: als Array von PropertyValue-Sub-Objekten — nicht verschachtelte Strukturen. ## 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 geoquality:geo-importance-rank 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. ## FAQ ### 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: scheme:property-name . Beispiele: geoquality:geo-importance-rank für eine eigene Skala, iso:9001 für ISO-Zertifikate, che:uid 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. /conventions/properties ) 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. ## Experten-Definition 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. ## Verwandte Begriffe - [DefinedTerm](https://www.geoquality.ai/glossar/defined-term.md) — DefinedTerm ist ein Schema.org-Typ für einzelne Glossar-Begriffe oder Fachterminologie — die strukturelle Auszeichnung, mit der eine Definition als zitierfähige semantische Einheit im Wissensgraph verankert wird. - [identifier (Schema-Property)](https://www.geoquality.ai/glossar/identifier-property.md) — identifier ist eine Schema.org-Property für eindeutige Identifikatoren einer Entity — typisch als PropertyValue-Sub-Objekt mit propertyID (CHE für Schweizer UID, GTIN für Produkte, ORCID für Forscher) und value, das die Entity an offizielle Identifier-Systeme bindet. - [JSON-LD](https://www.geoquality.ai/glossar/json-ld.md) — JSON-LD ist ein W3C-standardisiertes Format zur Einbettung strukturierter Daten in Webseiten — typischerweise nach Schema.org-Vokabular — und der von Google sowie allen grossen KI-Crawlern bevorzugte Weg, Entitäten und Beziehungen maschinenlesbar zu beschreiben. - [PropertyValue](https://www.geoquality.ai/glossar/property-value.md) — PropertyValue ist ein Schema.org-Sub-Type für strukturierte Eigenschafts-Werte — der vielseitige Container für Identifier, Custom-Metriken und numerische Werte mit Skala, Einheit oder propertyID. - [Schema.org](https://www.geoquality.ai/glossar/schema-org.md) — Schema.org ist das von Google, Microsoft, Yahoo und Yandex gemeinsam entwickelte Vokabular zur strukturierten Beschreibung von Web-Inhalten — der De-facto-Standard für maschinenlesbare Auszeichnung und das technische Fundament jeder GEO-Strategie. - [Strukturierte Daten](https://www.geoquality.ai/glossar/structured-data.md) — Strukturierte Daten sind maschinenlesbare Auszeichnungen von Web-Inhalten — typischerweise als JSON-LD im HTML-Head — die Entitäten, Beziehungen und Metadaten explizit benennen statt sie nur implizit im Fliesstext zu hinterlassen. ## Quelle und Zitation - HTML-Original: https://www.geoquality.ai/glossar/additional-property - Lizenz: CC BY 4.0 - Zitiervorschlag: "additionalProperty (geoquality.ai Glossar, Biner 2026)"