Guide : ImageObject Schema

TL;DR — ImageObject est a façon à décrire an image à moteur de recherches avec plus que simplement son web adresse — qui owns il, comment il peut être licensed, son caption. La plupart de le temps vous ne pas besoin il: quand a piece de schema demande pour an image, a plain URL est suffisant. Vous reach pour le complet ImageObject quand vous vouloir à attach que supplémentaire information — la plupart commonly à earn le “Licensable” badge dans Google Images.

Ce que ImageObject is

Quand vous ajouter données structurées à une page, vous êtes labeling votre contenu donc moteur de recherches comprendre il. ImageObject est le schema.org type que étiquettes an image — pas le words on lune page, mais a picture, décrit as données a machine peut lire.

Ici’s le partie presque chaque guide skips: ImageObject est rarely utilisé on son propre. Son réel job est à être le valeur de un autre type’s image property. Quand vous mark up a produit, an article, or a recipe, chaque de ceux a a spot pour an image. Vous peut fill que spot deux façons:

• Avec a plain URL — simplement le web adresse de le picture. Ce est tout vous besoin la plupart de le temps.
• Avec a complet ImageObject — quand vous vouloir à dire plus que “here’s the file,” comme qui took le photo or comment quelqu’un peut license il.

«So think of ImageObject less as “a thing that gets its own search result” and more as “a richer way to describe the image inside some other piece of schema.” » (Traduction) (Résumé en français de la section huit, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

Quand vous en réalité besoin the complet version

Vous upgrade depuis a plain URL à a complet ImageObject quand vous vouloir à attach metadata à propos de le image itself — la plupart souvent pour licensing. Si vous êtes a photographer, a stock agency, or a publisher qui veut votre images à montrer a Licensable badge dans Google Images (a petit étiquette que liens à où personnes peut buy a license), que badge est le principal raison à bother avec a complet ImageObject.

Le unique property que unlocks que badge est license — a lien à votre licensing terms. Vous pouvez ajouter plus (qui créé le image, a credit line, a copyright notice), mais license est le un que flips le switch.

The chose la plupart personnes obtenir incorrect

ImageObject ne fait pas earn son propre rich résultat. il y a aucun “image card” il produces. Il soit feeds un autre type’s eligibility (comme a recipe’s rich résultat) or il unlocks le séparé Licensable badge — c’est il.

Et être very skeptical de quelconque guide promising a spécifique trafic or click number depuis ajout image schema (“+30% clicks!”). j’ai looked à où ceux numbers come depuis, et le honest réponse est nowhere — ils sont invented. Schema est worth doing, mais pas parce que de a fait-up percentage.

Vouloir le deep version — le exact properties, comment le Licensable badge fonctionne, pourquoi Recipe images ne pas contrôler votre thumbnail, et le Produit-image myth? Switch à le Avancé tab.

TL;DR — ImageObject (Thing > CreativeWork > MediaObject > ImageObject) est primarily a nested valeur type, pas a standalone destination schema. c’est le valeur de Product.image, Article.image, Recipe.image, Organization.logo, WebPage.primaryImageOfPage. A plain URL fonctionne quand vous ne pas besoin metadata; upgrade à a complet object pour licensing/attribution. Le Licensable-badge recipe est contentUrl + au moins un de creator/creditText/copyrightNotice/license — mais license précisément est ce que rend le badge eligible. Utiliser contentUrl over url (Google calls il plus precise). Deux commonly-missed facts: Recipe’s image est requis mais a aucun impact on votre texte-résultat thumbnail (Google, June 2025), et Produit’s image est pas dans Google’s formal requis/recommended listes. c’est pas a facteur de classement — même indirect story as tout schema.

Où ImageObject sits, et comment c’est en réalité utilisé

On schema.org, ImageObject sits dans le hierarchy as Thing > CreativeWork > MediaObject > ImageObject. Que lineage est le entier story de son properties: il inherits licensing et attribution champs depuis CreativeWork (license, acquireLicensePage, creditText, copyrightNotice, creator, author) et fichier champs depuis MediaObject (contentUrl, encodingFormat, height, width, contentSize, uploadDate), plus a quelques de son propre comme caption et exifData.

It obtient utilisé two façons:

«- Standalone — on a page whose whole point is describing one image (a photo-licensing landing page). The reason to do this is almost always the Licensable badge. » (Traduction) (Résumé en français de la section vingt-deux, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.) «- Nested — as the value of another type’s image, logo, or primaryImageOfPage property. This is by far the more common case, and it’s why ImageObject is best framed as the utility type the CreativeWork subtypes quietly depend on rather than a schema type you point people at. (It’s the thematic cousin of the creative-works schema bucket — Article, Recipe, and VideoObject all lean on ImageObject through their image properties without ever making it their headline.) » (Traduction) (Résumé en français de la section vingt-deux, sous-partie deux : le texte source est conservé pour vérification lors de la relecture francophone.)

«The key mental unlock: schema.org and Google both accept “a URL or a fully described ImageObject” for an image property. A bare URL string is a perfectly valid ImageObject value. You only pay the cost of the full object when you have metadata worth attaching. » (Traduction) (Résumé en français de la section vingt-trois, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

«## The core properties » (Traduction) (Résumé en français de la section vingt-quatre, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

«### contentUrl vs url — use contentUrl » (Traduction) (Résumé en français de la section vingt-cinq, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

«Both point at the image file, but Google is explicit about which to prefer. From the image-metadata documentation: Google uses contentUrl “to determine which image the photo metadata applies to.” And on the choice between the two: “While the url property is not as precise and we recommend you use contentUrl instead, existing markup may still use url.” Translation: contentUrl pins down which image the metadata describes; url is a looser legacy fallback that still works but shouldn’t be your default. » (Traduction) (Résumé en français de la section vingt-six, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

«### license and acquireLicensePage — the Licensable pair » (Traduction) (Résumé en français de la section vingt-sept, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

«This is the part with a visible payoff. license links to a page describing the image’s licensing terms; acquireLicensePage links to where someone can actually buy a license. They pair naturally — one says “here are the terms,” the other says “here’s where to buy one” — but they’re not equal in weight, which the next section covers. » (Traduction) (Résumé en français de la section vingt-huit, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

«### creator, creditText, copyrightNotice — the attribution trio » (Traduction) (Résumé en français de la section vingt-neuf, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

«These credit the image. One nuance worth keeping: creator isn’t necessarily a person. Google’s doc: “This is usually the photographer, but it may be a company or organization (if appropriate).” » (Traduction) (Résumé en français de la section trente, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

caption, exifData, height/width, thumbnail

«Descriptive and technical metadata. Useful, occasionally surfaced, but none of them trigger a search feature on their own. » (Traduction) (Résumé en français de la section trente-deux, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

Getting the Licensable badge

Ce est le un exact recipe worth memorizing, parce que le requirement est subtle.

«The required structure: you need contentUrl, and at least one of creator, creditText, copyrightNotice, or license. Google’s doc: “In addition to contentUrl, you must include one of the following properties: creator, creditText, copyrightNotice, license. Once you include one of these properties, the other three properties become recommended in the Rich Results Test.” » (Traduction) (Résumé en français de la section trente-cinq, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

«But the badge itself has a stricter trigger. Passing validation is not the same as being badge-eligible. Google: “If you’re using structured data to specify an image, you must include the license property for your image to be eligible to be shown with the Licensable badge.” So creator or creditText alone will validate fine — and get you no badge. The license property is the switch. Google adds: “We recommend that you also add the acquireLicensePage property if you have that information.” » (Traduction) (Résumé en français de la section trente-six, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

Données structurées n’est pas le seulement chemin. IPTC embedded photo metadata est an equally valide façon à earn le même eligibility — aucun schema.org markup requis à tout. Mais si vous utiliser les deux et ils disagree, Google est explicit à propos de le tiebreaker: “Si vous choisir à utiliser les deux IPTC photo metadata et données structurées, et si quelconque information conflicts entre le deux, Google va utiliser le données structurées information.” c’est le reverse de ce que a lot de personnes assume (que le fichier’s embedded metadata est le plus “authoritative” source).

«One policy that catches people: the image URL has to be reachable. Google’s structured-data policies say “All image URLs specified in structured data must be crawlable and indexable” — block the image host in robots.txt and the whole thing silently fails. » (Traduction) (Résumé en français de la section trente-huit, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

ImageObject à l’intérieur spécifique types

Recipe — requis, et le June 2025 clarification

Pour Recipe, image est requis, et il a réel guidance: crawlable et indexable, doit represent le dish, et Google “recommend[s] providing plusieurs élevé-resolution images (minimum de 50K pixels quand multiplying width et height) avec le suivant aspect ratios: 16x9, 4x3, et 1x1.”

«Here’s the counterintuitive part most guides haven’t caught up to. As of a June 2025 doc update, Google states plainly: “Specifying the image property in Recipe markup has no impact on the image chosen for a text result image.” In other words, your Recipe image governs recipe rich-result eligibility — not the thumbnail that shows next to your normal blue-link result. That’s a separate system entirely (covered below). Barry Schwartz reported this change at Search Engine Land on June 5, 2025. » (Traduction) (Résumé en français de la section quarante-deux, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

«### Product — not formally required (the myth-bust) » (Traduction) (Résumé en français de la section quarante-trois, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

«Almost everyone asserts that images are “required” for Product rich results. They’re not — at least not per Google’s documented lists. The product-snippet doc’s formal Required properties are name plus one of review/aggregateRating/offers; the Recommended list is aggregateRating, offers, review. The image property appears only inside the worked examples, never in the required/recommended tables. Add product images anyway — a listing without a photo converts worse — but know that’s a UX-and-Shopping argument, not a documented schema requirement. (And don’t conflate it with Merchant Center’s separate, stricter product-image resolution rules — a different system from ImageObject entirely.) » (Traduction) (Résumé en français de la section quarante-quatre, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

«### Article and Organization » (Traduction) (Résumé en français de la section quarante-cinq, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

«For Article, image is a recommended property that feeds Article’s eligibility; it does not produce a dedicated image card of its own. For Organization.logo, the logo has its own separate requirements (and is the image Google can use for things like knowledge-panel and some rich-result branding) — worth marking up, but it’s a logo-specific job, not general ImageObject licensing. » (Traduction) (Résumé en français de la section quarante-six, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

«## Controlling your Search / Discover thumbnail » (Traduction) (Résumé en français de la section quarante-sept, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

«If you actually want to influence the image Google shows as your page’s preview, that’s a different mechanism from any of the above — and Google clarified it in a March 2026 documentation update. From the image-SEO best-practices doc: “Google’s selection of an image preview is completely automated and takes into account a number of different sources to select which image on a given page is shown on Google.” » (Traduction) (Résumé en français de la section quarante-huit, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

«Three parallel, non-exclusive signals feed that choice: » (Traduction) (Résumé en français de la section quarante-neuf, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

«1. The schema.org primaryImageOfPage property on your WebPage. 2. An image property attached via mainEntity / mainEntityOfPage. 3. The og:image meta tag. » (Traduction) (Résumé en français de la section cinquante, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

«Google’s guidance for all three: “Choose an image that’s relevant and representative of the page. Avoid using a generic image (for example, your site logo) or an image with text in the schema.org markup or og:image meta tag.” Matt G. Southern covered the update at Search Engine Journal on March 2, 2026, noting the key point: schema markup and og:image both count — they’re parallel inputs, not an either/or. » (Traduction) (Résumé en français de la section cinquante et un, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

«## C2PA / “About this image” — adjacent, not ImageObject » (Traduction) (Résumé en français de la section cinquante-deux, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

«One forward-looking sibling worth a mention, clearly scoped as separate from ImageObject licensing: C2PA content-provenance metadata (embedded in the image file, not schema.org). Google: “If an image contains C2PA metadata, Google can extract those details and may show information in the ‘About this image’ feature, such as how the image was created or if it was edited with AI tools.” This is an AI-provenance signal on the same “About this image” surface as licensing info — but it lives in the file’s manifest, not in your ImageObject markup. Don’t fold the two together. » (Traduction) (Résumé en français de la section cinquante-trois, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

Est ImageObject a facteur de classement?

Aucun — même indirect story as tout données structurées. Le standing Google position (Gary Illyes, John Mueller) est que schema aide moteurs comprendre contenu et peut unlock eligibility pour fonctionnalités, mais il n’est pas a direct classement entrée. Pour ImageObject précisément, le wins sont concrete mais narrow: le Licensable badge (via license), rich-résultat eligibility pour parent types comme Recipe (via a valide image), et thumbnail-selection entrée (via primaryImageOfPage). None de ceux est “rank higher,” et Google’s propre troubleshooting guidance est explicit que même a entièrement valide image-metadata bloquer n’est pas guaranteed à afficher. Le même reviewed sources ne pas establish an AI-citation effect depuis ImageObject soit — Je haven’t trouvé a source que montre il améliore votre odds de étant cited dans an AI réponse. Anyone selling vous a spécifique percentage trafic lift depuis image schema est quoting a number que traces à aucun source.

Erreurs fréquentes

• En utilisant url au lieu de contentUrl. Les deux fonctionner; Google prefers contentUrl as plus precise.
• Forgetting license précisément. Le autre three attribution properties valider mais ne pas trigger le Licensable badge.
• Assuming Recipe’s image contrôle votre texte-résultat thumbnail. Il ne fait pas (Google, June 2025) — il seulement affecte recipe rich-résultat eligibility.
• Assuming Produit images sont formally requis schema. ils sont pas dans Google’s documented listes (encore ajouter les pour UX/Shopping).
• Blocking le image URL. A robots.txt-disallowed or noindexed image host signifie le markup silently fails Google’s crawlable-et-indexable requirement.
• Repeating invented performances stats. Nearly chaque competing guide cites an uncited “+X% CTR/traffic” figure. None trace à a source.

Où ce fits

ImageObject est a deep dive dans le structured-données sub-cluster, alongside son sibling schema-type articles (article-schema, recipe-schema, product-schema, videoobject-schema, organization-schema). Thematically c’est le utility type le creative-fonctionne schema family leans on, et il lives sous le Données structurées pour le SEO hub. Pour le broader picture de texte alternatif, formats, image sitemaps, et lazy-loading, c’est a séparé image-SEO topic; ce article est précisément le “comment faire Je décrire an image as données” piece ceux others quietly depend on.

AI summary

A condensed prendre on the Avancé version:

«- ImageObject is a nested value type, not a standalone rich result. Hierarchy: Thing > CreativeWork > MediaObject > ImageObject. It’s the value of Product.image, Article.image, Recipe.image, Organization.logo, WebPage.primaryImageOfPage. A plain URL is a valid image value; upgrade to a full object only when you have metadata to attach. » (Traduction) (Résumé en français de la section soixante-quatre, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.) «- Licensable badge recipe: contentUrl + at least one of creator/creditText/copyrightNotice/license to validate — but the license property specifically is what makes the badge eligible. Add acquireLicensePage too if you have it. » (Traduction) (Résumé en français de la section soixante-quatre, sous-partie deux : le texte source est conservé pour vérification lors de la relecture francophone.) «- contentUrl over url — Google says contentUrl is more precise for pinning down which image the metadata describes; url is a legacy fallback. » (Traduction) (Résumé en français de la section soixante-quatre, sous-partie trois : le texte source est conservé pour vérification lors de la relecture francophone.) «- IPTC is an equal alternative path to the same eligibility — but if IPTC and structured data conflict, Google uses the structured data. » (Traduction) (Résumé en français de la section soixante-quatre, sous-partie quatre : le texte source est conservé pour vérification lors de la relecture francophone.) «- Recipe: image is required (50K px² min; 16x9/4x3/1x1) but has no impact on your text-result thumbnail (Google clarified June 2025). » (Traduction) (Résumé en français de la section soixante-quatre, sous-partie cinq : le texte source est conservé pour vérification lors de la relecture francophone.) «- Product: image is not in Google’s formal required/recommended lists — add it anyway for UX/Shopping, but it’s not a documented schema requirement. » (Traduction) (Résumé en français de la section soixante-quatre, sous-partie six : le texte source est conservé pour vérification lors de la relecture francophone.) «- Thumbnail control is a separate March 2026 mechanism: primaryImageOfPage, main-entity image, and og:image as three parallel signals. » (Traduction) (Résumé en français de la section soixante-quatre, sous-partie sept : le texte source est conservé pour vérification lors de la relecture francophone.) «- C2PA feeds “About this image” (AI-provenance) but lives in the file, not in ImageObject markup — don’t conflate. » (Traduction) (Résumé en français de la section soixante-quatre, sous-partie huit : le texte source est conservé pour vérification lors de la relecture francophone.) «- Not a ranking factor — indirect at most, display itself isn’t guaranteed, and no source establishes an AI-citation effect either; ignore invented “+X%” stats. » (Traduction) (Résumé en français de la section soixante-quatre, sous-partie neuf : le texte source est conservé pour vérification lors de la relecture francophone.)

Documentation officielle

Primary-source documentation depuis Google et schema.org.

Google

• Image Metadata (Google Images SEO) — le core ImageObject/licensing doc: requis properties, contentUrl vs url, le license/Licensable-badge règle, IPTC-vs-structured-données conflicts, et C2PA.
• Données structurées General Guidelines — le crawlable-et-indexable et pertinence requirements que appliquer à quelconque image dans données structurées.
• Recipe données structurées — image requis, le size/aspect-ratio guidance, et le “no impact on the text-result image” clarification.
• Produit extrait données structurées — le formal Requis/Recommended property listes (remarque image est dans aucun).
• Image SEO meilleur practices — primaryImageOfPage, main-entity image, et og:image as thumbnail-selection signaux.

schema.org

• ImageObject — le type definition, hierarchy (Thing > CreativeWork > MediaObject > ImageObject), et complet property liste.
• contentUrl · license · acquireLicensePage — le properties Google’s licensing guidance leans on.

Quotes from the source

On-le-record statements depuis Google. Chaque lien est a deep lien que jumps à le quoted passage on le page source.

Google — contentUrl vs url

«- “Google uses contentUrl to determine which image the photo metadata applies to.” — Google Search Central docs. Jump to quote » (Traduction) (Résumé en français de la section soixante-seize, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.) «- “While the url property is not as precise and we recommend you use contentUrl instead, existing markup may still use url.” Jump to quote » (Traduction) (Résumé en français de la section soixante-seize, sous-partie deux : le texte source est conservé pour vérification lors de la relecture francophone.)

Google — le requis structure et le Licensable-badge trigger

«- “In addition to contentUrl, you must include one of the following properties: creator, creditText, copyrightNotice, license.” Jump to quote » (Traduction) (Résumé en français de la section soixante-dix-huit, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.) «- “If you’re using structured data to specify an image, you must include the license property for your image to be eligible to be shown with the Licensable badge.” Jump to quote » (Traduction) (Résumé en français de la section soixante-dix-huit, sous-partie deux : le texte source est conservé pour vérification lors de la relecture francophone.) «- “We recommend that you also add the acquireLicensePage property if you have that information.” Jump to quote » (Traduction) (Résumé en français de la section soixante-dix-huit, sous-partie trois : le texte source est conservé pour vérification lors de la relecture francophone.)

Google — IPTC vs données structurées, and creator

«- “If you choose to use both IPTC photo metadata and structured data, and if any information conflicts between the two, Google will use the structured data information.” Jump to quote » (Traduction) (Résumé en français de la section quatre-vingts, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.) «- On creator: “This is usually the photographer, but it may be a company or organization (if appropriate).” Jump to quote » (Traduction) (Résumé en français de la section quatre-vingts, sous-partie deux : le texte source est conservé pour vérification lors de la relecture francophone.)

Google — image policy, Recipe, et thumbnail selection

«- “All image URLs specified in structured data must be crawlable and indexable.” Jump to quote » (Traduction) (Résumé en français de la section quatre-vingt-deux, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.) «- “Specifying the image property in Recipe markup has no impact on the image chosen for a text result image.” Jump to quote » (Traduction) (Résumé en français de la section quatre-vingt-deux, sous-partie deux : le texte source est conservé pour vérification lors de la relecture francophone.) «- “Specify the schema.org primaryImageOfPage property with a URL or ImageObject.” Jump to quote » (Traduction) (Résumé en français de la section quatre-vingt-deux, sous-partie trois : le texte source est conservé pour vérification lors de la relecture francophone.)

Plain URL or complet ImageObject? And qui fonctionnalité am I même après?

«The most common real question with ImageObject isn’t “how do I write it” — it’s “do I need the full object at all, and if so, why.” Answer for the image you’re marking up. » (Traduction) (Résumé en français de la section quatre-vingt-sept, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

ImageObject — cheat sheet

«Standalone vs. nested » (Traduction) (Résumé en français de la section quatre-vingt-douze, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

«| Mode | What it looks like | Why | | --- | --- | --- | | Plain URL | "image": "https://example.com/pic.jpg" | You just need to point at the picture — no metadata | | Nested ImageObject | "image": { "@type": "ImageObject", ... } inside a parent type | You want to attach license/credit/caption/dimensions | | Standalone ImageObject | An ImageObject as the top-level item | A photo-licensing page chasing the Licensable badge | » (Traduction) (Résumé en français de la section quatre-vingt-treize, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

«The Licensable-badge recipe » (Traduction) (Résumé en français de la section quatre-vingt-quatorze, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

«| Step | Property | Notes | | --- | --- | --- | | Required | contentUrl | The actual image file URL (prefer over url) | | Required (one of) | creator / creditText / copyrightNotice / license | At least one to validate | | Badge trigger | license | The only one of the four that unlocks the badge | | Recommended | acquireLicensePage | Where to buy a license | » (Traduction) (Résumé en français de la section quatre-vingt-quinze, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

contentUrl vs url

Image property par parent type

«Fast facts » (Traduction) (Résumé en français de la section cent, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.) «- Hierarchy: Thing > CreativeWork > MediaObject > ImageObject. » (Traduction) (Résumé en français de la section cent, sous-partie deux : le texte source est conservé pour vérification lors de la relecture francophone.) «- Not a ranking factor — earns eligibility, not rank. » (Traduction) (Résumé en français de la section cent, sous-partie trois : le texte source est conservé pour vérification lors de la relecture francophone.) «- IPTC is an equal path to the badge; on conflict, structured data wins. » (Traduction) (Résumé en français de la section cent, sous-partie quatre : le texte source est conservé pour vérification lors de la relecture francophone.) «- Image URLs must be crawlable and indexable or the markup fails silently. » (Traduction) (Résumé en français de la section cent, sous-partie cinq : le texte source est conservé pour vérification lors de la relecture francophone.) «- Thumbnail control = primaryImageOfPage / main-entity image / og:image (March 2026), a separate mechanism. » (Traduction) (Résumé en français de la section cent, sous-partie six : le texte source est conservé pour vérification lors de la relecture francophone.) «- C2PA ≠ ImageObject — it’s file-embedded provenance for “About this image.” » (Traduction) (Résumé en français de la section cent, sous-partie sept : le texte source est conservé pour vérification lors de la relecture francophone.)

Anti-patterns — the ImageObject mistakes I voir la plupart

Ajout creator or creditText et expecting le Licensable badge. Le la plupart courant near-miss. Ceux valider, mais le badge est gated on license précisément. Credit sans a license lien earns vous rien visible.

Reaching pour a complet ImageObject quand une URL string voudrait faire. Si vous ont aucun metadata à attach, a bare URL est le correct valeur pour an image property — schema.org et Google les deux accept il. Wrapping chaque image dans a complet object simplement ajoute surface area à obtenir incorrect.

En utilisant url parce que a generator emitted it. Plenty of outils encore output url. It fonctionne, but Google prefers contentUrl pour precision. Préférer contentUrl in nouveau markup.

Believing Recipe’s image sets votre recherche thumbnail. c’est requis pour le recipe rich résultat, mais Google explicitly dit il a aucun impact on le texte-résultat thumbnail. Si vous vouloir à influence que image, c’est a séparé job (primaryImageOfPage / og:image).

Treating Produit images as a requis schema champ. ils sont pas dans Google’s documented requis/recommended listes. Ajouter les pour conversion et Shopping, mais ne pas cite “required schema” as le raison — et ne pas confuse ce avec Merchant Center’s séparé image-resolution règles.

Blocking le image host. A robots.txt-disallowed or noindexed image URL fails le crawlable-et-indexable requirement. Le markup peut être perfect et encore ne faites pashing.

Repeating invented percentage stats. “ImageObject schema gives a 30% CTR lift” et friends trace à aucun source. Schema est worth doing on son réel merits (eligibility, understanding), pas a fait-up number.

«Conflating C2PA provenance with ImageObject licensing. “About this image” AI-provenance info comes from C2PA metadata in the file, not from your schema. Two different systems on the same surface. » (Traduction) (Résumé en français de la section cent onze, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

Implementation exemples

Two patterns cover almost everything: a standalone licensing image, and an ImageObject nested à l’intérieur a parent type.

1. Standalone photo-licensing image (chasing le Licensable badge)

Le license property est ce que rend ce badge-eligible; acquireLicensePage, creator, creditText, et copyrightNotice round il out.

{
  "@context": "https://schema.org/",
  "@type": "ImageObject",
  "contentUrl": "https://example.com/photos/harbor-at-dawn.jpg",
  "license": "https://example.com/licenses/standard/",
  "acquireLicensePage": "https://example.com/photos/harbor-at-dawn/buy/",
  "creator": {
    "@type": "Person",
    "name": "Alex Rivera"
  },
  "creditText": "Alex Rivera / Example Studio",
  "copyrightNotice": "© 2026 Example Studio",
  "caption": "The harbor at dawn, long exposure",
  "width": 2400,
  "height": 1600
}

2. ImageObject nested à l’intérieur a Product

Ici le ImageObject est le valeur de Product.image. Remarque que image n’est pas a formally requis Produit property — ce est le “attach metadata” upgrade over a plain URL string.

{
  "@context": "https://schema.org/",
  "@type": "Product",
  "name": "Trailhead 30L Backpack",
  "image": {
    "@type": "ImageObject",
    "contentUrl": "https://example.com/products/trailhead-30l.jpg",
    "license": "https://example.com/licenses/product-photography/",
    "creditText": "Example Gear Co."
  },
  "offers": {
    "@type": "Offer",
    "price": "129.00",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock"
  }
}

3. Quand a plain URL is the correct réponse

Si vous have aucun metadata to attach, don’t over-engineer it — a bare URL string is a valid image valeur:

{
  "@context": "https://schema.org/",
  "@type": "Product",
  "name": "Trailhead 30L Backpack",
  "image": "https://example.com/products/trailhead-30l.jpg",
  "offers": {
    "@type": "Offer",
    "price": "129.00",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock"
  }
}

Valider quelconque de ces dans le Résultats enrichis Tester et le schema.org validator avant shipping.

Outils pour building et checking ImageObject markup

Vérifier il avec le Balisage de données structurées Validator: paste votre JSON-LD (or a complet HTML page, or récupérer a actif URL) et il detects le ImageObject bloquer — standalone or nested à l’intérieur Product, Article, or Recipe — et flags problèmes par severity. c’est le fastest façon à vérifier le exact patterns depuis le Exemples tab: fait il catch contentUrl vs. url, est license présent (pas simplement creator/creditText/copyrightNotice), et fait a nested Product.image parse correctement as an ImageObject plutôt que a bare string quand vous meant à attach metadata.

Alors confirmer eligibility avec le Rich-Résultat Eligibility Checker: validating clean JSON-LD n’est pas le même as étant eligible pour a fonctionnalité. Exécuter l’URL via ce checker à voir si le parent type (Recipe, Produit) en réalité rapports as eligible pour son rich résultat — utile since, as covered dans Avancé, Produit’s image n’est pas a formally requis property et a manquant or malformed un peut silently sit à l’extérieur Google’s requis/recommended listes sans failing validation.

Tiers — Google’s Résultats enrichis Tester: le source Google itself points à pour le Licensable-badge requirements quoted throughout ce article. Utiliser il as a deuxième vérifier on badge eligibility précisément, since c’est a stricter bar que passing basic JSON-LD validation (vous besoin license, pas simplement un de le autre three attribution properties).

Validation tests — did votre ImageObject modifier en réalité prendre effect?

Proof que a spécifique ImageObject edit shipped correctement, pas simplement que it semble correct in the source.

Tester 1 — The JSON-LD parses with aucun errors

• Tester à exécuter — Paste lune page’s JSON-LD (or récupérer le actif URL) dans le Balisage de données structurées Validator.
• Attendu résultat — Le ImageObject bloquer (standalone or nested) est detected avec aucun syntax/parse erreurs, et contentUrl resolves à le champ vous prévu.
• Échec interpretation — A parse échec généralement signifie a templating bug — a malformed nested object où Product.image devrait hold an ImageObject mais obtenu broken JSON, or a stray string où an object était attendu.
• Monitoring window — Immediate.
• Rollback trigger — Le validator ne peut pas detect le ImageObject à tout après a template deploy — le markup n’est pas rendu; roll back le modifier.

Tester 2 — Licensable-badge validation passes (but vérifier the stricter trigger)

• Tester à exécuter — Exécuter le même URL via le Balisage de données structurées Validator or Google’s Résultats enrichis Tester, checking précisément pour contentUrl plus au moins un de creator/creditText/ copyrightNotice/license.
• Attendu résultat — Le image-metadata bloquer valide avec aucun requis-property erreurs.
• Échec interpretation — le “validates but no badge” mode: validation passing est pas le même as badge eligibility. Si vous ajouté creator or creditText mais pas license, le bloquer va valider cleanly et encore jamais montrer le Licensable badge — Google’s doc est explicit que license précisément est le trigger. ne pas lire a validation réussir as confirmation le badge va apparaître.
• Monitoring window — Immediate pour validation; le Licensable badge itself peut prendre plus long à surface dans Google Images après a successful explorer, donc autoriser a quelques weeks avant concluding c’est manquant.
• Rollback trigger — Si license est présent, validation passes, et le badge encore hasn’t appeared après a reasonable explorer window, vérifier que le image URL itself est crawlable et indexable (a robots.txt bloquer on le image host rend le markup échouer silently) avant assuming le markup est incorrect.

Tester 3 — Recipe eligibility n’est pas confused avec thumbnail contrôler

• Tester à exécuter — Pour Recipe pages, exécuter l’URL via le Rich-Résultat Eligibility Checker à confirmer le recipe rich résultat rapports eligible, séparément depuis checking qui image montre suivant à votre normal texte résultat dans Recherche.
• Attendu résultat — Le recipe rich résultat montre eligible avec a valide image présent. Séparément, le texte-résultat thumbnail est whatever primaryImageOfPage, main-entity image, or og:image selects — pas necessarily le même image.
• Échec interpretation — Si le recipe rich résultat est ineligible, le problème est le image property on le Recipe type itself (manquant, incorrect aspect ratio, pas crawlable). Si le texte-résultat thumbnail semble incorrect, c’est a séparé signal entirely (per Google’s June 2025 clarification, Recipe’s image ne fait pas contrôler il) — vérifier primaryImageOfPage et og:image à la place.
• Monitoring window — Rich-résultat eligibility peut être vérifié immédiatement après a successful explorer; thumbnail selection est automated et peut prendre plus long à settle dans actif Résultats de recherche — autoriser a quelques weeks avant troubleshooting plus loin.
• Rollback trigger — Recipe rich-résultat eligibility drops après a template modifier — roll back et re-vérifier le image property’s crawlability et size.

Ressources utiles

Mon connexe writing

• Données structurées: Ce que c’est et Comment utiliser Il — mon Ahrefs guide à schema types, formats, validation, et le sameAs entity angle; le broader context ImageObject sits à l’intérieur.
• Le Beginner’s Guide à SEO technique — où données structurées (et images) fit dans le bigger technique picture.

Mon speaking

• Comment Recherche Fonctionne (SlideShare) — mon walkthrough de exploration, rendu, indexation, et comment markup feeds understanding. (Mon standing disclaimer s’applique: “This is my understanding of systems… not going to be 100% complete or accurate.”)

Official

• Google’s Image Metadata doc — le canonical ImageObject/licensing référence.
• Google’s Recipe et Produit extrait docs — pour le requis/recommended property realities.
• Google’s Image SEO meilleur practices — le primaryImageOfPage / og:image thumbnail-selection guidance.
• schema.org/ImageObject — le type definition et complet property liste.

«From around the industry » (Traduction) (Résumé en français de la section cent quarante-huit, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.) «- Google updates Event and Recipe structured data (Barry Schwartz, Search Engine Land, June 5, 2025) — the source for the “Recipe image doesn’t affect the text-result thumbnail” clarification. » (Traduction) (Résumé en français de la section cent quarante-huit, sous-partie deux : le texte source est conservé pour vérification lors de la relecture francophone.) «- Google clarifies how it picks thumbnails for Search & Discover (Matt G. Southern, Search Engine Journal, March 2, 2026) — the primaryImageOfPage / main-entity image / og:image thumbnail update. » (Traduction) (Résumé en français de la section cent quarante-huit, sous-partie trois : le texte source est conservé pour vérification lors de la relecture francophone.) «- Quick guide to IPTC Photo Metadata and Google Images (IPTC) — the IPTC-field-to-schema.org mapping for the alternative licensing path. » (Traduction) (Résumé en français de la section cent quarante-huit, sous-partie quatre : le texte source est conservé pour vérification lors de la relecture francophone.) «- Yoast — the Image schema piece (Yoast developer portal) — a solid technical reference for ImageObject inside a JSON-LD @graph, referenced by @id when the same image is reused. » (Traduction) (Résumé en français de la section cent quarante-huit, sous-partie cinq : le texte source est conservé pour vérification lors de la relecture francophone.) «- r/TechSEO — the community for structured-data and image-markup debugging. » (Traduction) (Résumé en français de la section cent quarante-huit, sous-partie six : le texte source est conservé pour vérification lors de la relecture francophone.)

Testez vos connaissances: ImageObject Schema

Five rapide questions on how ImageObject en réalité fonctionne. Pick an réponse pour chaque, alors vérifier.

Journal des modifications