Structured dataIntermediate

ImageObject Schema

ImageObject schema describes an image, its URL, creator, credit and license, and can make images eligible for the Licensable badge in Google Images.

Also called: Image metadata, Image license structured data

ImageObject is the Schema.org type for an image file. It is used in two ways: as the value of image properties inside other types, such as an Article's image or an Organization's logo, and on its own to describe licensing details. Google uses the licensing properties to show a Licensable badge and license links in Google Images.

Image license metadata

For Google Images license details, Google requires contentUrl plus at least one of license, acquireLicensePage, creditText, creator or copyrightNotice. It accepts this either as structured data or as IPTC photo metadata embedded in the image file. If both exist and conflict, Google documents that it uses structured data.

{
  "@context": "https://schema.org",
  "@type": "ImageObject",
  "contentUrl": "https://www.heathercombe.example/charts/churn-cohorts.png",
  "license": "https://www.heathercombe.example/image-license",
  "acquireLicensePage": "https://www.heathercombe.example/press",
  "creditText": "Heathercombe",
  "creator": { "@type": "Organization", "name": "Heathercombe" }
}

ImageObject inside other types

Most of the time an image property can take a plain URL. Using an ImageObject instead lets you add width, height and caption, which some parsers use and which is good practice for logos and article hero images. Google requires images in markup to be crawlable and indexable.

Example

Research report charts

Heathercombe, a subscription analytics vendor, publishes a yearly benchmark report with original charts. It adds ImageObject markup to each chart with creditText and a license page asking for a link back when reused, and embeds matching IPTC metadata in the files.

Common mistakes

License pages that say nothing

The license URL should lead to real terms. A generic homepage link is not useful.

Questions

No. Google Images indexes images without markup. ImageObject adds licensing details and context.

Know the terms. Now win the searches.

We find the searches your buyers make, then build, publish and improve the pages that win them.