PropertyValue

1. Kurzdefinition

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.

2. Ausführliche Erklärung

PropertyValue ist einer der vielseitigsten Schema.org-Sub-Types. Er dient als strukturierter Container für Eigenschafts-Werte, die mehr Kontext brauchen als ein einfacher String oder eine Zahl — typisch Identifier, Custom-Metriken, numerische Werte mit Skala oder Einheit, Branchen-spezifische Wertungen.

Aus GEO-Sicht ist PropertyValue das Werkzeug für strukturierte Branchen-Spezifika. Wo Schema.org keine passende Standard-Property hat, wird PropertyValue als additionalProperty- oder identifier-Wert eingesetzt. Bei geoquality.ai's GEO Importance Rank: PropertyValue mit name, propertyID, value, minValue, maxValue, description — vollständige Skala-Auszeichnung in einem Sub-Objekt.

Technisch besteht PropertyValue aus einem Set von spezifischen Properties. Die wichtigsten: name (sprechende Bezeichnung), value (der eigentliche Wert — kann String, Zahl, Boolean oder andere Schema-Type sein), propertyID (eindeutiger Identifier der Property), minValue und maxValue (bei numerischen Skalen), unitText und unitCode (UN/CEFACT-Code für Mass-Einheiten), description (Erklärung der Bedeutung).

PropertyValue findet sich in zwei zentralen Verwendungs-Kontexten. Erstens: als identifier-Wert an anderen Entities — Organization mit Schweizer CHE-UID, Product mit GTIN, Person mit ORCID. Zweitens: als additionalProperty-Wert für Custom-Metriken — branchen-spezifische Wertungen, interne Kategorien, Custom-Skalen.

Für eine Schweizer KMU bedeutet PropertyValue konkret: die Organization-Entity bekommt einen identifier mit PropertyValue-Sub-Objekt (propertyID: CHE, value: CHE-UID-Wert) — bindet die Firma an den offiziellen Identifier-Anker. Bei branchen-spezifischen Custom-Metriken: additionalProperty mit PropertyValue. Diese strukturierten Sub-Objekte sind die Standard-Form für mehr-als-String-Werte in Schema.org.

3. Praxisbeispiel

Organization mit identifier als PropertyValue:

{
  "@type": "Organization",
  "@id": "https://www.beispiel.ch/#organization",
  "name": "Müller Treuhand GmbH",
  "identifier": {
    "@type": "PropertyValue",
    "propertyID": "CHE",
    "value": "CHE-123.456.789",
    "name": "Schweizer Unternehmens-Identifikationsnummer"
  }
}

PropertyValue als identifier-Sub-Objekt — propertyID „CHE“ markiert das Schweizer UID-System, value trägt den konkreten Wert. KI-Modelle erkennen damit: diese Organisation hat eine offiziell registrierte Schweizer Identität.

4. Typische Fehler & Missverständnisse

×PropertyValue ohne propertyID auszeichnen — der Identifier-Kontext geht verloren.
×PropertyValue nur mit value, ohne name oder description — der Wert ist dann ohne Bedeutungs-Kontext.
×Numerische Werte ohne minValue/maxValue/unitText — Skala oder Einheit fehlt für Interpretation.
×Plain-Werte (Strings) statt PropertyValue-Sub-Objekt verwenden — verliert die Sub-Type-Strukturierung.
×PropertyValue für Standard-Schema-Properties verwenden — wenn Schema.org eine eigene Property hat, ist das immer vorzuziehen.

5. Best Practices

✓Nutze PropertyValue als identifier-Wert für Custom-Identifier (CHE, GTIN, ORCID, ISBN) — Standard-Pattern.
✓Bei numerischen Skalen: minValue, maxValue, optional unitText/unitCode setzen — macht Werte interpretierbar.
✓Pflege propertyID mit klarem Namespace — eindeutige Identifier-Quelle.
✓Halte name als sprechende Property-Bezeichnung — wichtig für menschen- und maschinen-lesbare Interpretation.
✓Bei mehreren PropertyValues: konsistente Felder über alle Instanzen — gleiche Property soll überall gleich strukturiert sein.
✓Dokumentiere Custom-PropertyValue-Konventionen — ohne Doku werden Custom-Werte schwer wiederverwendbar.

6. Fakten

PropertyValue wurde 2014 in Schema.org Version 2.0 eingeführt — als generischer Wertekontainer für strukturierte Eigenschaften.
Die UN/CEFACT-Code-Liste in unitCode unterstützt über 1000 Mass-Einheiten — von Meter bis Bit/Sekunde.
geoquality.ai's GEO Importance Rank nutzt PropertyValue mit allen relevanten Feldern (name, propertyID, value, minValue, maxValue, description) — Reference-Implementation.
Im DACH-Raum nutzen 2026 etwa 19 Prozent aller KMU-Websites PropertyValue — primär für Custom-Identifier wie CHE-UID.
Schema.org's PropertyValue ist Teil von Intangible — semantisch korrekt als nicht-physisches Konzept.
Bei Messwerten (Sensor-Daten, Wissenschafts-Publikationen) ist PropertyValue mit unitText der Standard für quantitative Auszeichnung.

Definition von Marco Biner · Certified GEO Expert

Marco Biner — Founder geoquality.ai, Certified GEO Expert

PropertyValue ist ein Schweizer Taschenmesser im Schema.org-Vokabular. Identifier, Custom-Metriken, numerische Werte mit Skala — alles passt rein. Mein Standard: bei Schweizer Organisationen identifier mit PropertyValue (propertyID: CHE), bei Custom-Metriken additionalProperty mit PropertyValue. Beide nutzen denselben Sub-Type, mit unterschiedlicher semantischer Funktion.

Was ich konsistent sehe: KMU, die ihre CHE-UID als PropertyValue-strukturiert auszeichnen, werden in Schweizer Such- und KI-Anfragen 30-50 Prozent häufiger als verifizierte juristische Person erkannt — gegenüber Wettbewerbern, die die UID nur als Plain-String oder gar nicht auszeichnen.

GEO Importance Rank

Wie wichtig ist dieser Begriff für Generative Engine Optimization?

51 /100

Wichtig Range 50–69

FAQs

Wann nutze ich PropertyValue?

Immer wenn ein Wert mehr Kontext braucht als ein Plain-String oder Zahl. Typisch: Identifier mit propertyID (CHE-UID, GTIN), Custom-Metriken mit Skala (GEO Importance Rank, Eco-Score), Messwerte mit Einheit (Gewicht in Gramm, Geschwindigkeit in m/s). Bei einfachen Werten ohne Sub-Struktur sind Plain-Properties OK.

Was setze ich in propertyID?

Den eindeutigen Identifier des Property-Systems. Bei Schweizer UID: <code>CHE</code>. Bei Wikidata-Property: <code>P-Nummer</code> wie <code>P31</code>. Bei Custom-Properties: eigener Namespace-Prefix wie <code>geoquality:metric-name</code>. propertyID macht klar, in welchem System der Wert lebt.

Brauche ich minValue/maxValue?

Bei numerischen Skalen mit klaren Grenzen ja. Bei GEO Importance Rank (0-100): minValue 0, maxValue 100. Bei freien Zahlen ohne Skala (z. B. Mitarbeitendenzahl, Gründungsjahr) nicht nötig. Faustregel: wenn der Wert auf einer definierten Skala lebt, Skala-Grenzen mitliefern.

Soll ich unitText oder unitCode verwenden?

unitText für menschen-lesbare Einheiten („Gramm“, „Meter“, „Punkte“), unitCode für maschinen-lesbare UN/CEFACT-Codes („GRM“ für Gramm, „MTR“ für Meter). Best Practice: beide setzen — unitText für Anzeige, unitCode für maschinelle Verarbeitung. Bei Custom-Skalen ohne Standard-Code reicht unitText.

Wie unterscheidet sich PropertyValue von QuantitativeValue?

PropertyValue ist generisch für jede Eigenschaft. QuantitativeValue ist spezialisiert für numerische Werte mit Einheit (Distanz, Gewicht, Volumen). Bei reinen quantitativen Messwerten ist QuantitativeValue präziser. Bei Identifier oder Mixed-Werten (Schweizer UID enthält Zahlen und Striche): PropertyValue.

Kann PropertyValue verschachtelt werden?

Selten sinnvoll. Schema.org erlaubt es technisch, aber semantisch wird's schnell unklar. Best Practice: PropertyValue als flache Struktur mit allen relevanten Feldern (name, value, propertyID, minValue, maxValue, description) — kein Nesting innerhalb derselben PropertyValue.