MediaObject "mediaQuery" text property for signaling preferred rendering context to third parties #4683

jcayzac · 2026-01-13T09:33:57Z

jcayzac
Jan 13, 2026

Following up on issue #4680, I propose the addition of a new property to MediaObject:

:mediaQuery a rdf:Property ;
    rdfs:label "mediaQuery" ;
    rdfs:comment "A valid [CSS Media Query](https://drafts.csswg.org/mediaqueries-5/) representing the preferred surrounding context for rendering the media object." ;
    :domainIncludes :MediaObject ;
    :rangeIncludes :Text ;
    :source <https://github.com/schemaorg/schemaorg/issues/4680> .

For example, the following json+ld provides third-party crawlers with 4 variants of an asset, so they can present the most appropriate one that matches each of their visitors' preferences:

{
  "@context": "https://schema.org",
  "@type": "Article",
  "@id": "https://example.com/article",
  "url": "https://example.com/article",
  "image": [
    {
      "@type": "ImageObject",
      "url": "https://example.com/preview.light.avif",
      "width": 1200,
      "height": 630,
      "encodingFormat": "image/avif"
    },
    {
      "@type": "ImageObject",
      "url": "https://example.com/preview.dark.avif",
      "width": 1200,
      "height": 630,
      "encodingFormat": "image/avif",
      "mediaQuery": "(prefers-color-scheme: dark)"
    },
    {
      "@type": "ImageObject",
      "url": "https://example.com/preview.contrast.avif",
      "width": 1200,
      "height": 630,
      "encodingFormat": "image/avif",
      "mediaQuery": "(prefers-contrast: more)"
    },
    {
      "@type": "ImageObject",
      "url": "https://example.com/preview.dark-contrast.avif",
      "width": 1200,
      "height": 630,
      "encodingFormat": "image/avif",
      "mediaQuery": "(prefers-color-scheme: dark) and (prefers-contrast: more)"
    }
  ]
}

Other usages could include:

Exposing a commentary audio track for videos that match a speech media query.
Using a static image fallback along animations, setting its media query to (prefers-reduced-motion: reduce).

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

MediaObject "mediaQuery" text property for signaling preferred rendering context to third parties #4683

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{editor}}'s edit

{{editor}}'s edit

Uh oh!

Replies: 0 comments

Select a reply

Uh oh!

MediaObject "mediaQuery" text property for signaling preferred rendering context to third parties #4683

Uh oh!

Uh oh!

jcayzac Jan 13, 2026

Replies: 0 comments

jcayzac
Jan 13, 2026