Check explainer · v1

Image license metadata: what the Licensable badge needs

Automated

Last reviewed

Google Images can show a Licensable badge only when the markup names the image file and its rights. One without the other is ignored.

How this check works

Every ImageObject in the page’s JSON-LD is read except the site logo — a logo is not licensable content. Each node needs contentUrl (or a compatible url) plus at least one rights field: creator, creditText, copyrightNotice or license. Pages without ImageObject markup are not judged.

What does a failure look like?

An ImageObject carries only a thumbnail URL and no rights field at all; a CMS migration empties the license field while the visible credit line survives; a template fills contentUrl for every image but never emits creator, creditText, copyrightNotice or license.

How to fix it, step by step

  1. Emit one ImageObject per licensable image, with contentUrl pointing at the image file itself.
  2. Fill at least one rights field — license is the one that unlocks the badge; creator, creditText and copyrightNotice support it.
  3. Re-run the audit after media-library or template changes; images added without markup are invisible to the check.

What does a pass or fail look like?

Good

3 ImageObject nodes, each with contentUrl plus a license URL — every marked image is badge-eligible.

Fail

An ImageObject declares contentUrl but no creator, credit, copyright or license — rights unknown, no badge.

Frequently asked questions

Which rights field turns on the badge?

license is the field Google requires for the Licensable badge; creator, creditText and copyrightNotice satisfy rights and attribution but not badge eligibility. The audit accepts any one of the four so valid but less specific markup is not failed.

Why is the site logo skipped?

The logo is also an ImageObject, but it is not licensable content. Requiring rights metadata on it would produce failures nobody can act on, so the audit excludes it deliberately.

Do images without markup fail?

No. Only declared ImageObject nodes are graded. An unmarked image is invisible to the check — and also ineligible for the badge, so the fix is to mark it.

This rule is one of the checks the audit runs. Run the full site audit

Free preview; no account needed.

Visdenda check explainers · one page per published ruleImage license · v1