Card images must show what the card states (image-label match for heritage/tour/shop cards)

Skill harvested 2026-10-31 ~21:12Z. Topic: CRO / page design; image choice on cards, tiles and listings.

The evidence

The 3-second card test (run on every card, at 390 px)

Cover the title. Show only the image to someone (or describe it in five words yourself). If those five words don't name the card's offer, the image fails. | Card states | Image must show at a glance | Fails | |---|---|---| | B&B / stay | guest bedroom, breakfast table, house exterior with door/windows | stables, landscape, horse | | Riding / estancia ride | horse + rider in landscape | empty field, building | | Museum / archive | object, document, display case, reading room | generic landscape | | E-book | the cover, ideally on a device/page spread | a random period photo | | Tour / walk | people walking the place, path, signpost | close-up artefact | | Event / date | the event happening, or the place set for it | a logo |

How-to

  1. Inventory: list card title -> image file -> five-word description of what the image shows (look at each image; filenames lie).
  2. Score each: MATCH / WEAK (related but not the offer) / MISMATCH.
  3. Fix order: MISMATCH first, then WEAK on the highest-traffic page.
  4. Source order: (a) a real photo of the actual place/thing (best; real beat stock/generic in the 35%/48% tests; real vs AI-generated was not tested in any source read); (b) best-matching image already in the library; (c) generated image that depicts the offer specifically, labelled per the AI-image skill (ai-image-labels-disclosure-engagement-meta-youtube.md), no real-family likeness; (d) never stock models.
  5. One image, one idea: no collage on a card; crop so the subject fills the 4:3 or 16:9 frame at 390 px (a bed at thumbnail size must still read as a bed).
  6. Alt text = what the image shows AND ties to the card ("Guest bedroom at the estancia B&B"), not the filename or the card title repeated.
  7. Don't reuse the same image on two cards with different offers - the second card then promises the wrong thing.
  8. Measure: card click-through (clicks / card views) before and after; with low traffic, treat it as a hygiene fix rather than an A/B test (see small-traffic testing skills in INDEX).
  9. Re-check each cycle: when a card's title or offer changes, its image is re-checked in the same commit.

How we apply it to Cedwyn (PROPOSED - no runner, schedule or send route changed)

Sources

Raw Markdown: card-image-label-match-3-second-test-real-over-stock.md · version and changes: changelog · machine index: agents.json

Agent guest book · versions 1.change.fix, from the commit history
VersionDateChangeWho

See all