XooCode(){

QualitativeValue

QualitativeValue is an Enumeration subtype for qualitative values along an ordered scale ("short", "tall", "left-hand drive"). It parents SteeringPositionValue, DriveWheelConfigurationValue, and the WearableSizeGroup / BodyMeasurement values used in apparel markup.

Unlike a plain Enumeration value, a QualitativeValue can carry greater, greaterOrEqual, lesser, lesserOrEqual, equal, and nonEqual comparative links to other values, making the ordering machine-readable.

Full example of schema.org/QualitativeValue json-ld markup

The markup is verified as valid with Rich Results Test from Google.

schema.org/QualitativeValue
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Volvo 122S Amazon, 1967",
  "vehicleConfiguration": {
    "@type": "QualitativeValue",
    "name": "Left-hand drive",
    "equal": "https://schema.org/LeftHandDriving"
  }
}
</script>

Minimal valid version

The smallest markup that still produces a valid QualitativeValue entity. Use it as the floor. Reach for the advanced example above when you want search engines and AI agents to understand more about your content.

schema.org/QualitativeValue (minimal)
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "QualitativeValue",
  "name": "Tall"
}
</script>

Google rich results this unlocks

QualitativeValue is a structural type. It does not produce a rich result on its own.

Its value comes from combining it with a primary type whose markup earns a rich result (Article, Product, Event, and so on). QualitativeValue becomes the trunk that the primary type branches off viamainEntityorbreadcrumb. Include it on every page as the backbone of your markup.

Common QualitativeValue mistakes

Mistakes that pass validation but silently fail to earn rich results or mislead consumers walking the graph. Avoid these and your markup will be ahead of most sites in the wild.

  1. 01

    QualitativeValue where QuantitativeValue fits

    Wrong
    QualitativeValue "1.8 L" for engine displacement
    Right
    QuantitativeValue with value + unitCode for numeric facts

    Qualitative = ordered-scale label; quantitative = number + unit. Mixing them hides numeric comparability.

Schema properties in this example

QualitativeValueEnumerationvehicleConfigurationequalLeftHandDrivinggreaterlesser

Also mentioned in 4 other examples

QualitativeValue also appears in BedType, DriveWheelConfigurationValue, SizeSpecification, and SteeringPositionValue. See the full QualitativeValue schema page for every reference.

About the example data

The QualitativeValue base type powers the taxonomy behind every ordered schema.org scale.

Comments

Loading comments...

Leave a comment