Skip to main content
Glossary

ImageObject Schema

By ยท Updated
Quick definition

ImageObject schema is structured data (JSON-LD) that describes an image with explicit properties โ€” URL, caption, alt text, dimensions, license, author โ€” so search engines and AI search engines can index, validate, and cite the image as a first-class asset rather than guessing from raw HTML.

ImageObject schema in plain English

ImageObject schema is one of the Schema.org types. It lives as a small JSON-LD block in the page's <head> (or inside a parent Article/Product schema) and labels an image with explicit fields. Where an <img> tag tells the browser "render this picture," ImageObject tells search engines "here is what this picture is, who made it, what it depicts, how big it is, and under what license it can be reused." The minimum useful set is contentUrl (the image URL), caption, description, width, and height. The richer set adds license, creditText, creator, and copyrightHolder โ€” fields Google explicitly uses to qualify images for rich-result badges and AI search engines use as citation signals.

ImageObject doesn't replace the regular <img> tag โ€” the image still has to render visually. ImageObject runs alongside, declaring the same image to the machine layer with rich semantics. For a page with one image, that's one ImageObject block. For a product page with five product photos, that's usually an array of five ImageObject entries nested inside the parent Product schema, each describing a specific view (front, back, lifestyle, dimensions diagram, swatch). For an inline SVG diagram embedded in an article body, ImageObject points to the page URL with a fragment ID targeting the SVG and includes a long-form description suitable for the diagram's content.

The vocabulary is part of the wider schema markup standard maintained by Google, Microsoft, Yahoo, and Yandex. Validation runs through Google's Rich Results Test and the Schema Markup Validator โ€” both flag missing required properties and warn on improvable ones. The Search Console's Enhancements report then surfaces image-schema errors over time as Google re-crawls.

Why ImageObject schema matters for ecommerce

For an ecommerce store, ImageObject schema is the difference between an image that Google can show in image results and one that Google can cite with rich-result badges, license attribution, and AI Overview thumbnails. Three concrete wins. First, Google Merchant Center qualifies products for free listings partly on the strength of Product+ImageObject schema โ€” stores with bare image: "url.jpg" get fewer impressions than stores with full ImageObject objects on every product photo. Second, AI search engines (ChatGPT, Perplexity, Claude, Google AI Overviews) preferentially cite visual assets that have explicit schema โ€” see why diagrams make content citable for the citation lift mechanics. Third, image rich results in regular Google Search depend on ImageObject to qualify for the higher-information SERP treatments.

For content pages โ€” guides, articles, glossary entries โ€” ImageObject schema applied to inline SVG diagrams is the highest-leverage move. SVG content is parseable directly, but only when paired with ImageObject schema do AI search engines treat the diagram as a citable asset rather than page decoration. See the 12 diagram types for ecommerce SEO for which diagram patterns most benefit from the schema treatment and how to add inline SVG to Shopify for the implementation walkthrough on a Shopify theme.

Frequently asked

What is ImageObject schema in simple terms?

ImageObject schema is a small block of JSON-LD code attached to an image on your page that tells search engines exactly what the image is โ€” its caption, dimensions, license, author, and the URL where it lives. Instead of letting Google or ChatGPT guess from the surrounding HTML, you declare it explicitly. The result: that image becomes citation-eligible as its own asset, not just a decoration on the page.

Why does ImageObject schema matter for ecommerce SEO?

Three things. First, Google Image Search needs ImageObject schema to render rich image results with attribution and badges. Second, AI search engines preferentially cite pages with explicit ImageObject schema on their visual assets โ€” it's a citation-readiness signal. Third, Google's Merchant Center pulls product image data from Product + ImageObject schema to qualify free listings. A store without ImageObject schema on its product images is competing with both hands tied.

How do I add ImageObject schema to an image?

Add a JSON-LD script block to the page head. Minimum fields are @type ImageObject, contentUrl (the actual image URL), description (alt-text-like description of what's in the image), and width and height in pixels. For maximum AI-search citation eligibility add caption, license (URL to license terms), creditText (who made it), and creator (Person or Organization). For inline SVG diagrams the contentUrl points to the parent page URL with the SVG's id anchor.

Does ImageObject schema work with inline SVG diagrams?

Yes โ€” and this is where ecommerce content engines get the biggest lift. Inline SVG diagrams ship as part of the page HTML, not external image files. Pair each diagram with an ImageObject JSON-LD block (contentUrl pointing to the page URL + a fragment id targeting the SVG, plus caption and description) and the diagram becomes parseable as a structured asset. AI search engines cite pages with this pattern at noticeably higher rates than pages with text-only or image-as-attachment treatment.

What's the difference between ImageObject schema and og:image meta tags?

og:image is a single Open Graph meta tag that declares the page's social-share preview image โ€” used by Facebook, LinkedIn, Slack, and similar platforms. ImageObject is a Schema.org type that can describe any image on the page with rich properties (caption, license, author, dimensions, embedded license). og:image is one image per page; ImageObject can describe many. They're complementary โ€” most well-marked-up pages have both.

Can I use ImageObject schema for product images?

Yes. Inside the Product schema for a product page, the image property can either be a string URL or a full ImageObject. Using full ImageObject lets you declare caption, width, height, and creator โ€” all of which feed into Google Merchant Center, free product listings, and AI shopping search. For multi-image product pages, an array of ImageObject entries describes each image individually with its specific caption (front view, lifestyle shot, dimensions diagram). This is the highest-leverage place to add ImageObject schema to most ecommerce sites.

MG
About the author

Matt Goren

Matt is the founder of RunOctopus. He built All Angles Creatures from zero to page-1 rankings in reptile feeder insects in under 60 days using exactly this method โ€” turning a hard, entrenched niche into RunOctopus's proof store for programmatic SEO and AI search citation.