Is the cart button accessible?
Why it matters What works for screen readers works for agents; an icon button with no name can’t be clicked reliably.
- Category
- Action (cart and orders)
- Weight
- 3 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
If add-to-cart was found, we check whether it’s a real button or form and whether it has a readable name (text or aria-label). Both pass, one is a 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.
- PassedAdd to cart is a real button with a readable name.
- PartialThe cart button is missing: ….
- FailedAdd to cart is a <div> with no name; an agent can’t tell what it is.
How to fix it
Target: The button is a <button> or form submit with visible text or an aria-label.
How to verify it yourself
In the browser’s accessibility tree the button’s role should be “button” and its name “Add to cart”.
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. Is the cart button accessible? (cart_accessible)
Target: The button is a <button> or form submit with visible text or an aria-label.
Reference: https://specoria.com/method/checks/cart-accessible/
## 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.cart_accessibleShopping flow (Specoria) section