Guide : ImageObject Schema

ImageObject is the schema.org type que describes an image as données structurées — utilisé standalone pour photo-licensing metadata (the Licensable badge) or, plus souvent, nested à l’intérieur Product, Article, Recipe, and Organization schema. Here's quand a plain URL is suffisant and quand vous besoin the complet object.

Première publication : 2 juil. 2026 · Dernière mise à jour : 3 août 2026 · Advanced
Langues
1 indice probant sur cette page

ImageObject is the schema.org type pour describing an image as données structurées — but it's rarely a destination on its propre. Its principal job is as the valeur of an image or logo property nested à l’intérieur un autre type: Product.image, Article.image, Recipe.image, Organization.logo, WebPage.primaryImageOfPage. Quand a property simplement veut a picture, a plain URL string fonctionne; vous upgrade to a complet ImageObject quand vous vouloir to attach metadata (owner, license, caption, dimensions). The un visible fonctionnalité it directement unlocks is Google's Licensable badge, and the trigger is specifically the license property — contentUrl plus creator/creditText/copyrightNotice alone won't do it. Utiliser contentUrl over url (Google dit it's plus precise). Two facts la plupart guides miss: Recipe's image is requis pour the recipe rich result but has aucun impact on votre normal text-result thumbnail (Google clarified ce June 2025), and Product's image n’est pas in Google's formal requis/recommended listes at tout. None of it is a ranking factor — it earns eligibility, pas rank. And every uncited X% traffic-lift stat you'll voir attached to image schema traces to aucun source; ignore les.

TL;DR — ImageObject (Thing > CreativeWork > MediaObject > ImageObject) is primarily a nested valeur type, pas a standalone destination schema. It’s the valeur of Product.image, Article.image, Recipe.image, Organization.logo, WebPage.primaryImageOfPage. A plain URL fonctionne quand vous don’t besoin metadata; upgrade to a complet object pour licensing/attribution. The Licensable-badge recipe is contentUrl + au moins un of creator/creditText/copyrightNotice/license — but license specifically is ce que rend the badge eligible. Utiliser contentUrl over url (Google calls it plus precise). Two commonly-missed facts: Recipe’s image is requis but has aucun impact on votre text-result thumbnail (Google, June 2025), and Product’s image is pas in Google’s formal requis/recommended listes. It’s pas a ranking factor — même indirect story as tout schema.

Evidence for this claim Schema.org ImageObject describes an image media object and its properties; vocabulary validity alone does not create a Google rich result. Scope: Schema.org vocabulary definition, distinct from search-feature eligibility. Confidence: high · Verified: Schema.org: ImageObject Evidence for this claim Google documents structured data or IPTC metadata for image licensing information and the Licensable badge in Google Images. Scope: Current Google image-license metadata feature; not generic ImageObject rich-result eligibility. Confidence: high · Verified: Google Search Central: Image license metadata

Où ImageObject sits, and how it’s en réalité utilisé

On schema.org, ImageObject sits in the hierarchy as Thing > CreativeWork > MediaObject > ImageObject. Que lineage is the whole story of its properties: it inherits licensing and attribution fields from CreativeWork (license, acquireLicensePage, creditText, copyrightNotice, creator, author) and fichier fields from MediaObject (contentUrl, encodingFormat, height, width, contentSize, uploadDate), plus a few of its propre comme caption and exifData.

It obtient utilisé two façons:

  • Standalone — on une page whose whole point is describing un image (a photo-licensing landing page). The raison to do ce is almost toujours the Licensable badge.
  • Nested — as the valeur of un autre type’s image, logo, or primaryImageOfPage property. Ce is by far the plus courant cas, and it’s pourquoi ImageObject is meilleur framed as the utility type the CreativeWork subtypes quietly depend on plutôt que a schema type vous point personnes at. (It’s the thematic cousin of the creative-works schema bucket — Article, Recipe, and VideoObject tout lean on ImageObject via leur image properties sans ever making it leur headline.)

The clé mental unlock: schema.org and Google les deux accept “une URL or a entièrement décrit ImageObject” pour an image property. A bare URL string is a perfectly valid ImageObject valeur. Vous seulement pay the cost of the complet object quand vous have metadata worth attaching.

The core properties

contentUrl vs url — utiliser contentUrl

Les deux point at the image fichier, but Google is explicit à propos de qui to préférer. From the image-metadata documentation: Google uses contentUrl “to determine qui image the photo metadata s’applique to.” And on the choice between the two: “Pendant que the url property n’est pas as precise and we recommend vous utiliser contentUrl à la place, existing markup may encore utiliser url.” Translation: contentUrl pins bas qui image the metadata describes; url is a looser legacy fallback que encore fonctionne but shouldn’t be votre par défaut.

license and acquireLicensePage — the Licensable pair

Ce is the partie with a visible payoff. license liens to une page describing the image’s licensing terms; acquireLicensePage liens to où someone peut en réalité buy a license. Ils pair naturally — un dit “here are the terms,” the autre dit “here’s where to buy one” — but they’re pas equal in weight, qui the suivant section covers.

creator, creditText, copyrightNotice — the attribution trio

Ces credit the image. Un nuance worth keeping: creator isn’t necessarily a person. Google’s doc: “Ce is usually the photographer, but it may be a company or organization (si appropriate).”

caption, exifData, height/width, thumbnail

Descriptive and technical metadata. Utile, occasionally surfaced, but none of les trigger a search fonctionnalité on leur propre.

Getting the Licensable badge

Ce is the un exact recipe worth memorizing, parce que the requirement is subtle.

The requis structure: vous besoin contentUrl, and au moins un of creator, creditText, copyrightNotice, or license. Google’s doc: “In addition to contentUrl, vous doit inclure un of the suivant properties: creator, creditText, copyrightNotice, license. Une fois vous inclure un of ces properties, the autre three properties become recommended in the Résultats enrichis Tester.”

But the badge itself has a stricter trigger. Passing validation n’est pas the même as being badge-eligible. Google: “Si you’re en utilisant données structurées to specify an image, vous doit inclure the license property pour votre image to be eligible to be affiché with the Licensable badge.” So creator or creditText alone va validate fine — and obtenir vous aucun badge. The license property is the switch. Google adds: “We recommend que vous aussi ajouter the acquireLicensePage property si vous have que information.”

Données structurées isn’t the seulement chemin. IPTC embedded photo metadata is an equally valid façon to earn the même eligibility — aucun schema.org markup requis at tout. But si vous utiliser les deux and ils disagree, Google is explicit à propos de the tiebreaker: “Si vous choisir to utiliser les deux IPTC photo metadata and données structurées, and si quelconque information conflicts entre the two, Google va utiliser the données structurées information.” That’s the reverse of ce que a lot of personnes assume (que the file’s embedded metadata is the plus “authoritative” source).

Un policy que catches personnes: the image URL has to be reachable. Google’s structured-data policies dire “All image URLs specified in structured data must be crawlable and indexable” — block the image host in robots.txt and the whole chose silently fails.

ImageObject à l’intérieur spécifique types

Recipe — requis, and the June 2025 clarification

Pour Recipe, image is requis, and it has réel guidance: crawlable and indexable, doit represent the dish, and Google “recommend[s] providing multiple high-resolution images (minimum of 50K pixels quand multiplying width and height) with the suivant aspect ratios: 16x9, 4x3, and 1x1.”

Here’s the counterintuitive partie la plupart guides haven’t caught up to. As of a June 2025 doc mettre à jour, Google states plainly: “Specifying the image property in Recipe markup has aucun impact on the image choisi pour a text result image.” En d’autres termes, votre Recipe image governs recipe rich-result eligibility — pas the thumbnail que montre suivant to votre normal blue-link result. That’s a separate system entirely (covered ci-dessous). Barry Schwartz reported ce modifier at Moteur de recherche Land on June 5, 2025.

Product — pas formally requis (the myth-bust)

Almost everyone asserts que images are “required” pour Product résultats enrichis. They’re pas — au moins pas per Google’s documented listes. The product-snippet doc’s formal Requis properties are name plus un of review/aggregateRating/offers; the Recommended liste is aggregateRating, offers, review. The image property apparaît seulement à l’intérieur the worked exemples, jamais in the requis/recommended tables. Ajouter product images anyway — a listing sans a photo converts worse — but know that’s a UX-and-Shopping argument, pas a documented schema requirement. (And don’t conflate it with Merchant Center’s separate, stricter product-image resolution rules — a différent system from ImageObject entirely.)

Article and Organization

Pour Article, image is a recommended property que feeds Article’s eligibility; it ne fait pas produce a dedicated image card of its propre. Pour Organization.logo, the logo has its propre separate requirements (and is the image Google peut utiliser pour choses comme knowledge-panel and some rich-result branding) — worth marking up, but it’s a logo-specific job, pas general ImageObject licensing.

Controlling votre Search / Découvrir thumbnail

Si vous en réalité vouloir to influence the image Google montre as votre page’s preview, that’s a différent mechanism from quelconque of the ci-dessus — and Google clarified it in a March 2026 documentation mettre à jour. From the image-SEO best-practices doc: “Google’s selection of an image preview is complètement automated and takes into account a number of différent sources to select qui image on a donné page is affiché on Google.”

Three parallel, non-exclusive signals feed que choice:

  1. The schema.org primaryImageOfPage property on votre WebPage.
  2. An image property attached via mainEntity / mainEntityOfPage.
  3. The og:image meta tag.

Google’s guidance pour tout three: “Choisir an image that’s relevant and representative of lune page. Éviter en utilisant a generic image (Par exemple, votre site logo) or an image with text in the schema.org markup or og:image meta tag.” Matt G. Southern covered the mettre à jour at Moteur de recherche Journal on March 2, 2026, noting the clé point: balisage de données structurées and og:image les deux count — they’re parallel inputs, pas an soit/or.

C2PA / “About this image” — adjacent, pas ImageObject

Un forward-looking sibling worth a mention, clearly scoped as separate from ImageObject licensing: C2PA content-provenance metadata (embedded in the image fichier, pas schema.org). Google: “Si an image contient C2PA metadata, Google peut extract ceux details and may montrer information in the ‘À propos de ce image’ fonctionnalité, tel as how the image was créé or si it was edited with AI outils.” Ce is an AI-provenance signal on the même “About this image” surface as licensing info — but it lives in the file’s manifest, pas in votre ImageObject markup. Don’t fold the two ensemble.

Is ImageObject a ranking factor?

Aucun — même indirect story as tout données structurées. The standing Google position (Gary Illyes, John Mueller) is que schema helps engines comprendre content and peut unlock eligibility pour fonctionnalités, but it isn’t a direct ranking input. Pour ImageObject specifically, the wins are concrete but narrow: the Licensable badge (via license), rich-result eligibility pour parent types comme Recipe (via a valid image), and thumbnail-selection input (via primaryImageOfPage). None of ceux is “rank higher,” and Google’s propre troubleshooting guidance is explicit que même a entièrement valid image-metadata block isn’t guaranteed to afficher. The même reviewed sources don’t establish an AI-citation effect from ImageObject soit — I haven’t trouvé a source que montre it improves votre odds of being cited in an AI réponse. Anyone selling vous a spécifique percentage trafic lift from image schema is quoting a number que traces to aucun source.

Erreurs fréquentes

  • En utilisant url au lieu de contentUrl. Les deux fonctionner; Google prefers contentUrl as plus precise.
  • Forgetting license specifically. The autre three attribution properties validate but don’t trigger the Licensable badge.
  • Assuming Recipe’s image contrôle votre text-result thumbnail. It doesn’t (Google, June 2025) — it seulement affecte recipe rich-result eligibility.
  • Assuming Product images are formally requis schema. They’re pas in Google’s documented listes (encore ajouter les pour UX/Shopping).
  • Blocking the image URL. A robots.txt-disallowed or noindexed image host signifie the markup silently fails Google’s crawlable-and-indexable requirement.
  • Repeating invented performances stats. Nearly every competing guide cites an uncited “+X% CTR/traffic” figure. None trace to a source.

Où ce fits

ImageObject is a deep dive in the structured-data sub-cluster, alongside its sibling schema-type articles (article-schema, recipe-schema, product-schema, videoobject-schema, organization-schema). Thematically it’s the utility type the creative-works schema family leans on, and it lives sous the Données structurées pour le SEO hub. Pour the broader picture of texte alternatif, formats, image sitemaps, and lazy-loading, that’s a separate image-SEO topic; ce article is specifically the “how do I décrire an image as données” piece ceux others quietly depend on.

Add an expert note

Pin an expert quote

New person? Create their unclaimed profile at /admin/experts/ → Pin a quote first.