--- title: PropertyValue slug: property-value canonical_url: https://www.geoquality.ai/glossar/property-value md_url: https://www.geoquality.ai/glossar/property-value.md language: de last_modified: 2026-05-03T00:00:00+00:00 related_terms: [additional-property, identifier-property, json-ld, organization-schema, schema-org, structured-data] content_hash: c95ab6a50f4cff83 license: CC BY 4.0 author: Marco Biner (geoquality.ai) schema_type: DefinedTerm --- # PropertyValue 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. ## Erläuterung 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. ## 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. ## Häufige Fehler - 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. ## 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. ## 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. ## FAQ ### 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: CHE . Bei Wikidata-Property: P-Nummer wie P31 . Bei Custom-Properties: eigener Namespace-Prefix wie geoquality:metric-name . 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. ## Experten-Definition 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. ## Verwandte Begriffe - [additionalProperty](https://www.geoquality.ai/glossar/additional-property.md) — 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. - [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. - [Organization-Schema](https://www.geoquality.ai/glossar/organization-schema.md) — Organization ist der Schema.org-Typ für Unternehmen, Vereine, Stiftungen und Behörden — der primäre Authority-Anchor jeder Site und neben Person und WebSite einer der drei Pflicht-Entitäten in jedem GEO-Setup. - [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/property-value - Lizenz: CC BY 4.0 - Zitiervorschlag: "PropertyValue (geoquality.ai Glossar, Biner 2026)"