Skip to content

[ Field guide ]

What makes a product page readable by a shopping agent

[ In short ]

A product page usable by a shopping agent exposes verifiable prices, availability, delivery terms, returns and variant attributes. These details help compare an offer against the customer's constraints. When information is missing, the system may seek clarification, consult other sources or exclude the option: its behavior depends on the agent and task.

Published
Updated
Reading
7 min
On this page

What does a shopping agent do when it reads a page?

Something different from what a person does. A person looks at the photos, forms an impression, reads two lines of description, and decides on criteria they cannot fully articulate. An agent starts from a request with explicit constraints (a budget, a size, a delivery date, a compatibility) and tries to verify each one. Whatever it cannot verify, it treats as risk.

The practical consequence matters to people too: a promise of "fast shipping" does not establish whether a product will arrive before a deadline. An agent asked to meet that date may seek clarification, flag uncertainty or prefer a verifiable alternative. There is no exclusion rule shared by every system; there is missing information that makes the comparison harder.

This is not about writing for a machine instead of a person. It is about making resolvable the information that is already present but implicit: inside an image, inside a menu that opens on click, inside a sentence that says "fast shipping" instead of a number of days.

Which data does it need, and in what form?

The criterion is not whether the data exists, it is whether it resolves: a value, a unit, a stable place to read it. The table separates the two, because almost every catalog I look at has the data and lacks the form.

The same content, two forms. The right column is verifiable without interpretation.
DataForm that failsResolvable form
PriceOnly in the widget after variant selectionValue and currency exposed per variant
AvailabilityGeneric "in stock"State per variant, with quantity or threshold
Delivery"Fast shipping"Business days, by destination area
ReturnsLink to a policy pageWindow in days, conditions, who pays
MeasurementsInside the size-guide imageText attributes with units
Compatibility"Works with recent models"Explicit list of models or standards
IdentifiersAbsentGTIN, MPN, SKU consistent between site and feed
MaterialsInside a descriptive paragraphAttribute-value pairs

Why are price and availability the first filter?

Because they can make other features irrelevant to the request. If the customer needs to buy immediately within a budget, an unavailable or overpriced product does not meet those constraints. Price and availability are therefore priority checks for that task, not a mandatory sequence followed by every agent in every search.

The most common technical problem sits in exactly these two fields. On many storefronts price and availability do not exist in the served HTML: they appear after a cart call, or after the user selects a variant. To a human eye this is invisible, because the browser runs everything and the page looks complete. To whoever reads the server response, those fields are empty.

The check is trivial and I recommend it to anyone with a catalog: fetch the HTML of a product page without executing JavaScript and search for the price. If it is not there, your best page is invisible to anyone not rendering it, and that includes part of the systems now comparing products.

Then there is consistency. The page, feed and structured data must describe the same variant under the same commercial conditions. A discrepancy makes the usable price ambiguous and may require another check. We cannot infer which value every system will select: we can correct the mismatch and state when and under which conditions the price is valid.

How should variants be handled?

Variants are where most catalogs become illegible, because they mix two structures: a product that is a concept (the model) and its variants that are the purchasable things (size, color, capacity). If the page exposes only the concept, no size or color constraint is verifiable.

The form that works keeps the two levels distinct and linked: the model as container, each variant with its own identifier, price, availability, and attributes. You do not need one page per variant. You need every variant readable from the model page, all of them, not just the one selected by default.

The opposite mistake costs as much: multiplying pages and letting each declare itself the main product. The result is a family of near-identical pages competing with each other, where the system cannot tell which one represents the model and picks unstably. A correct canonical and a declared model-to-variant relationship solve both cases.

What role do reviews and verifiable claims play?

Reviews can give people and agents information the catalog does not declare. If several customers report that a garment runs small, they raise a fit issue worth checking. A system may consider it during comparison, but it is not a certified attribute or a source every agent will use in the same way. The page should distinguish manufacturer specifications from customer experiences.

This makes reviews a readability lever, not only a conversion one. If an attribute keeps surfacing in reviews and is missing from the page, the page is incomplete on a point the market considers relevant. Worth reading them with that eye: they are a free list of missing attributes.

On claims the rule is simple: what cannot be verified does not help and can hurt. "Best in class" is not data and enters no comparison. "Waterproof to 5 metres for 30 minutes" is data, enters a comparison, and can win the page on a specific question. Replacing a superlative with a measurement is probably the highest effort-to-result intervention available on a product page.

How do you check whether the page is readable?

With four checks you can run on one page in half an hour, before involving anyone.

  • Take the served HTML without executing JavaScript and look for price, availability, and identifier. If they are missing, everything else is secondary.
  • Compare the same product across page, feed, and structured data. Look for divergence, not presence.
  • Write a customer request with three real constraints (budget, size, date) and try to satisfy them using page text only, no images. Record where clarification is needed: those are gaps to investigate, not proof that every agent will exclude the product.
  • Read the last twenty reviews and list the attributes they mention and the page does not declare. That is your gap list, written by customers.

What should not be done?

Do not fill attributes with generic values to complete the schema. A badly populated attribute is worse than an empty one, because it produces a wrong comparison instead of a missing figure, and the missing figure is at least honest.

Do not add structured data that contradicts the visible page. A price in the schema different from the price on screen is a declared inconsistency, and engine guidelines treat it as one.

Do not start from the whole catalog. One cycle on twenty to a hundred representative products tells you which problems are systemic, and systemic problems are almost always few and repeated. Fixing them on the sample produces the specification for fixing them everywhere, and in that order the work actually finishes.

[ What to take away ]

  • Check that price, availability, and identifier exist in the served HTML, not just on screen.
  • Expose every variant with its own price, state, and attributes, not only the default selection.
  • Replace superlatives with measurements. A number enters a comparison, an adjective does not.
  • State delivery and returns in days and conditions, not with an adjective or a link.
  • Use reviews as a list of attributes missing from the page.

How to measure your brand's visibility in AI answers. Read the article

[ Related services ]

[ Author ]

Nicola Dussin

Founder of Creaitivo. Every analysis is run directly by me.

Full profile

Are your products easy to understand and compare?

Share the catalog, market, and buying decisions you want to influence. Within 48 hours, I will indicate which pages, data, and checks deserve priority.

All field notes