ImageObject

ImageObject schema describes an image with structured metadata that search engines use for image indexing, license attribution, and rich result eligibility. It extends MediaObject with properties for image dimensions, captions, credits, and licensing information.

When to use ImageObject

Use this type when you need to provide detailed metadata about a specific image beyond what the image property on other types supports. Common use cases: photographer portfolios, stock photo libraries, image-heavy editorial content, and any page where image licensing or credit attribution matters. For simple image references on Product, Article, or Organization pages, the image property with a URL string is usually sufficient.

Google support

Google supports Image License Metadata structured data using ImageObject. When an image includes license, acquireLicensePage, and at least one of creator, creditText, or copyrightNotice, Google may show a "Licensable" badge on the image in Google Images search results.

Fields

Recommended

• creditText — Person or organization credited for the image

Optional

• caption — Text description of what the image shows
• height — Vertical dimension in pixels
• width — Horizontal dimension in pixels

ImageObject also inherits properties from MediaObject and CreativeWork, including contentUrl, url, license, acquireLicensePage, creator, copyrightNotice, datePublished, and description.

JSON-LD example

{
  "@context": "https://schema.org",
  "@type": "ImageObject",
  "contentUrl": "https://example.com/photos/1x1/black-labrador-puppy.jpg",
  "url": "https://example.com/photos/1x1/black-labrador-puppy.jpg",
  "width": 1200,
  "height": 630,
  "caption": "Black Labrador puppy playing in a sunlit garden",
  "creditText": "Labrador PhotoLab",
  "creator": {
    "@type": "Person",
    "name": "Brixton Brownstone"
  },
  "copyrightNotice": "Clara Kent",
  "license": "https://example.com/license",
  "acquireLicensePage": "https://example.com/how-to-use-my-images"
}

Webflow implementation

For Webflow sites with image-heavy content, add ImageObject markup in Page Settings > Custom Code or through CMS template embeds. For image license metadata, include at minimum contentUrl, license, and creditText. Adding width, height, and caption provides complete image metadata.

Schema HQ automates ImageObject markup for Webflow CMS template pages, mapping image URLs, credit fields, and license information from collection data.