# seo/image-alt

Every <img> has an alt attribute. Reglen seo/image-alt kører i page-scope med severity 'error' og indgår i teknisk seo-domænet sammen med 23 andre kontrakter i frameworket.

## Hvorfor image-alt findes

Alt text is how search engines index images and how screen readers and AI agents read them. Gold standard: every <img> has alt — descriptive for content images, empty (alt="") for purely decorative ones.

## Sådan håndhæves image-alt

Reglen image-alt evalueres på hver enkelt renderet HTML-side for sig, så et fund altid kan føres tilbage til én konkret side og én konkret rettelse i data eller template. Fejler en side, får agenten en finding, hvor fix-instruktionen for image-alt er formuleret som en konkret arbejdsordre med filnavne og målbare krav — aldrig et vagt råd. Severity 'error' betyder at et brud på image-alt fejler hele verifikationen med exit-kode 1, så hverken CI eller en agent kan skibe sitet før fundet er rettet.

## Test og fixtures

Som alle kontrakter i frameworket har seo/image-alt en mutant-test, der beviser at reglen fejler, når kravet brydes — en regel uden en fejlende test er ikke en regel. Golden-fixturet beviser omvendt, at en fuldt compliant side består image-alt sammen med de øvrige 85 regler, og denne demoside er selv underlagt hele kontrakten.

## Relaterede regler

- [seo/descriptive-links](https://pseo.mikkelkrogsholm.dk/regler/seo/descriptive-links/)
- [seo/charset](https://pseo.mikkelkrogsholm.dk/regler/seo/charset/)
- [seo/favicon](https://pseo.mikkelkrogsholm.dk/regler/seo/favicon/)