Specoria
Menu
TR Free test
← All checks
product_media

Images and description

Why it matters Agents show a photo and a short description in the shortlist; without them the product is presented less well.

Category
Product data
Weight
2 of 100 points
Critical blocker
No. If it fails, it only costs its own weight.
Applies to
Online stores
Effort
1-2 hours · developer
Score model
v2.4

How we measure it

We read the product image (structured data or og:image) and the description in the product’s structured data. A description of at least 20 words or 120 characters is enough; 10-19 words is short; fewer doesn’t count as a description. An image plus an adequate description passes; an image with a short description is a mostly partial pass; only one of the two is a half partial pass; neither fails.

What the result page says

These are the sentences in the test result; “…” is replaced by what we found on your site.

  • PassedThe product data includes an image and a description of useful length (at least 20 words or 120 characters).
  • PartialThe product data is missing: ….
  • PartialProduct description is too short (… words); agents can’t answer questions about material, size or use.
  • FailedThe product data has no image or description.

How to fix it

Target: JSON-LD carries a stable https image URL and an original description; og:image is set as well.

Example code

"image": ["https://example.com/img/product-1.jpg", "https://example.com/img/product-2.jpg"],
"description": "An original description with materials, size, use and care."

Example values (example.com, product name, price) are placeholders; replace them with your own.

How to verify it yourself

Check image (https URL) and description in the JSON-LD; add an og:image tag too.

Fix it with an AI coding agent

Paste this into Claude Code, Cursor or another coding agent working on your store’s code. Review the change before you deploy it.

You are working on my online store. Specoria’s agent readiness test checks the item below. Fix it so AI shopping agents can read the store and act on it.

## 1. Images and description (product_media)
Target: JSON-LD carries a stable https image URL and an original description; og:image is set as well.
Example fix (adapt it to this codebase and platform; example values are placeholders):
```
"image": ["https://example.com/img/product-1.jpg", "https://example.com/img/product-2.jpg"],
"description": "An original description with materials, size, use and care."
```
Reference: https://specoria.com/method/checks/product-media/

## Rules
- First look through the codebase and tell me which files or templates you will change, before editing anything.
- Change only what these checks need, and keep the visible page and the structured data saying the same thing.
- Never invent prices, stock, shipping or return terms, reviews or product identifiers (GTIN): take them from the store’s real data or ask me.
- Don’t block or slow down real visitors and don’t add tracking.
- After deploying, run the free test again at https://specoria.com/ to verify the fix.

Specifications and guidance

The check is based on these open sources; links go to the publisher’s own pages.

Where it sits in the 196-criteria framework

The result of this check counts as evidence for these items of the readiness framework:

  • 0.product_media Shopping flow (Specoria) section

The framework and its source →

Run the free test See the sample report →