Wichtig structured data

additionalProperty

Auch bekannt als: schema:additionalProperty


Aktualisiert 2026-05-03 · von Marco Biner

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

5. Best Practices

6. Fakten


Definition von Marco Biner · Certified GEO Expert

Marco Biner — Founder geoquality.ai, 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?

52 /100
Wichtig Range 50–69

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 →