Skip to main content
Checklist

ImageObject Schema Checklist: 10 Items Every Ecommerce Store Should Audit

By · Updated · 4 min read

Why an ImageObject Schema Audit Matters for Ecommerce

ImageObject schema is easy to add badly. A block that technically validates can still be missing the fields that actually make an image citation-eligible, or can describe dimensions and captions that no longer match the real file. This checklist covers the 10 items worth checking on any page carrying product photos or inline diagrams, each with a binary pass or fail standard so fixes can be prioritized rather than argued over.

Core Property Checks (Items 1-4)

ITEM 1. contentUrl Is a Valid, Absolute URL. Check: the contentUrl value resolves directly to the image file with no redirect. Pass: absolute URL, HTTP 200 response, no redirect chain. Fail: relative path, broken link, or a URL that redirects before reaching the file.

ITEM 2. Caption Is Specific, Not Generic. Check: the caption describes what is actually in that specific image. Pass: caption names the specific product view, angle, or diagram content. Fail: caption is a placeholder like "product image" or a generic restatement of the page title.

ITEM 3. Width and Height Match the Real File. Check: declared pixel dimensions match the actual served image. Pass: exact match, verified by checking the file's real dimensions. Fail: any mismatch, including stale values left over from a replaced image.

ITEM 4. description Is Present and Distinct From caption. Check: the description field exists separately from caption and adds detail rather than repeating it. Pass: description gives machine-readable context beyond the short caption. Fail: description is missing or duplicates the caption verbatim.

Citation and Licensing Checks (Items 5-7)

ITEM 5. license Is Present for Reusable or Sourced Images. Check: images meant to be reused or attributed carry a license property pointing to license terms. Pass: valid license URL present where relevant. Fail: missing on images where reuse rights or attribution matter.

ITEM 6. creator or creditText Identifies Who Made the Image. Check: authorship or credit is declared for original photography, diagrams, or illustrations. Pass: creator (Person or Organization) or creditText populated with real, accurate attribution. Fail: field absent on images where attribution is meaningful.

ITEM 7. encodingFormat Matches the Actual File Type. Check: the declared MIME type matches the real file, such as image/jpeg for a JPEG or image/svg+xml for an inline SVG diagram. Pass: exact match. Fail: mismatched or missing encodingFormat.

Placement and Validation Checks (Items 8-10)

ITEM 8. ImageObject Nests Correctly Inside Its Parent Type Where Applicable. Check: a product's featured image ImageObject sits inside Product.image, an article's featured image sits inside BlogPosting.image, rather than floating disconnected elsewhere on the page. Pass: correctly nested. Fail: orphaned block with no relationship to its parent entity.

ITEM 9. The Block Validates With Zero Errors in Rich Results Test. Check: run the page through Google's Rich Results Test. Pass: ImageObject recognized with no errors, only minor optional-field warnings at most. Fail: any hard validation error.

ITEM 10. No Duplicate or Conflicting ImageObject Entries for the Same Image. Check: search the page's full JSON-LD output for the same contentUrl appearing in more than one ImageObject block with different property values. Pass: exactly one authoritative entry per image. Fail: two or more conflicting descriptions of the same file, often left behind after a schema app is added on top of existing theme output.

Running the Audit and Prioritizing Fixes

Pull five representative URLs (homepage, product page, collection page, a blog post with an inline diagram, and an FAQ or policy page) and log a pass or fail for each of the 10 items per image. Prioritize featured product images first, since those feed Google Merchant Center eligibility directly, then move to in-body diagrams on your highest-traffic content pages. Re-run the audit after any theme, template, or plugin update, since those changes can silently strip or duplicate schema that was previously correct. See the Store SEO Grader for a broader pass across a page's full schema stack, not just its images.

Frequently asked questions

How often should I run an ImageObject schema audit?

Run the full 10-item audit whenever a theme, template, or schema-related plugin or app is updated, plus a periodic pass at least quarterly on your highest-traffic pages. Theme updates in particular can silently overwrite custom schema code without any visible change to the page.

Which checklist item has the biggest impact on AI search citation?

Caption and description specificity (Items 2 and 4) tend to matter most for AI citation eligibility, since AI systems use that text to judge whether an image contributes distinct, quotable information. Correct dimensions and encodingFormat (Items 3 and 7) matter most for Google Image Search rich-result qualification.

What is the difference between a missing property and a conflicting duplicate?

A missing property (Items 1 through 7) is an incomplete single ImageObject block, still just one description of the image with a gap in it. A conflicting duplicate (Item 10) is two or more separate ImageObject blocks describing the same contentUrl with different values, usually created when a schema app is layered on top of existing theme output without checking for overlap.

Does every product image need a license property?

No. license matters most for images meant to be reused, syndicated, or attributed elsewhere, such as press-kit photos or licensed stock imagery. Original product photography a store owns outright can skip the license field without failing an otherwise complete audit, though creditText is still worth including where relevant.

How do I find duplicate ImageObject blocks on a page?

View the page's full JSON-LD output, either through browser developer tools or the Schema Markup Validator, and search for the same contentUrl value appearing more than once across separate script blocks. This most commonly happens after installing a schema app on a theme that already generates its own image schema.

MG
Written by

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

Connect on LinkedIn →

See what Ollie would build for your store

Free architecture preview. No card required. Five minutes.

Generate Preview →