What an AI agent sees
A person sees a page. An AI agent reads it: the text in the HTML, the product data, and the names of its buttons and fields. Here are the practice store's pages both ways, with the problems we often find and with them fixed.
A product page
In a browser, both versions show the jacket, its price, its sizes and colours, and a button to add it to the cart. Here is what an agent gets from each.
Broken version
- Product data: none
- Price in the page text: no, it's added later by JavaScript
- Size and colour: 8 boxes with click handlers, not form controls; 3 have no text at all
- Add to cart: nothing by that name, just a box with a click handler and no text
Fixed version
- Product data: Harbor Rain Jacket, 15 options with prices and stock
- Price in the page text: yes
- Size: a choice of "XS", "S", "M", "L", "XL"
- Colour: a list to choose from, labelled "Colour"
- Add to cart: a button named "Add to cart"
A checkout page
Both versions show the same form to a person. An agent filling it in for someone needs to know which box is which.
Broken version
- Field
f1: no label, no autocomplete hint - Field
f2: no label, no autocomplete hint - Field
f3: no label, no autocomplete hint - Field
f4: no label, no autocomplete hint - Field
f5: no label, no autocomplete hint - Field
f6: no label, no autocomplete hint
Fixed version
- Field
email: labelled "Email", autocomplete email - Field
name: labelled "Full name", autocomplete name - Field
address: labelled "Address", autocomplete address-line1 - Field
city: labelled "City", autocomplete address-level2 - Field
postcode: labelled "Postcode", autocomplete postal-code - Field
country: labelled "Country", autocomplete country-name
The two versions look almost the same to a person, so these problems ship without anyone noticing. Agents notice at once: they can't tell the price, can't find the button and can't tell which box takes the email.
See any page this way with What does ChatGPT see?, check your own markup with the HTML checker, or read how each problem is fixed.