# Falta el atributo alt: el error explicado y corregido

Source: https://allyway.ai/es/glossary/falta-atributo-alt

La falta del atributo alt significa que un elemento img (o un botón de imagen o un área de mapa de imagen) no tiene ningún atributo alt. Las tecnologías de apoyo no pueden saber si la imagen es informativa o decorativa y pueden leer en voz alta el nombre del archivo.

La falta del atributo alt es el error que señalan los escáneres cuando una etiqueta de imagen no tiene ningún atributo `alt`. Se notifica como «Image missing alt attribute» (imagen sin atributo alt) o «Images must have alternate text» (las imágenes deben tener texto alternativo). Esta página trata del error en sí; para saber cómo redactar buenas descripciones, consulte la guía del [texto alternativo](https://allyway.ai/es/glossary/texto-alternativo).

## Qué significa

El atributo `alt` es la forma en que una imagen indica a los lectores de pantalla lo que muestra. Cuando el atributo falta por completo, la tecnología de apoyo no tiene ninguna información: no puede saber si la imagen es importante o si es mera decoración. Entonces los lectores de pantalla pueden recurrir al nombre del archivo, y se lee en voz alta «IMG_4711.jpg» o «hero-banner-final-2.webp» en lugar de contenido real.

El criterio [WCAG 1.1.1 Contenido no textual](https://www.w3.org/WAI/WCAG22/Understanding/non-text-content.html) es un criterio de nivel A de las [WCAG 2.2](https://allyway.ai/es/regulations/wcag-2-2): todo contenido no textual necesita una alternativa textual que cumpla una finalidad equivalente, y las imágenes puramente decorativas deben ocultarse a las tecnologías de apoyo. El W3C clasifica como fallo F65 omitir el atributo alt o la alternativa textual en los elementos img, en los elementos area y en los elementos input de tipo image. Los nombres de archivo o los textos provisionales usados como texto alternativo también son un fallo (F30).

| Marcado | Qué indica el escáner | Qué significa |
|---|---|---|
| `<img src="team.jpg">` | **Missing alt attribute** (falta el atributo alt) | Ninguna información: hay que corregirlo |
| `<img src="line.svg" alt="">` | Sin error | Decorativa, se ignora correctamente |
| `<img src="team.jpg" alt="Our team of five at the office">` | Sin error | Informativa, descrita |
| `<img src="team.jpg" alt="IMG_4711.jpg">` | A menudo, sin error | No cumple el criterio 1.1.1 de todos modos (F30) |

> **Warning:** > **Un atributo ausente no es lo mismo que uno vacío**
> `alt=""` es una decisión deliberada: «esta imagen es decorativa, omítala». Sin ningún `alt`, nadie ha decidido nada, y por eso los escáneres lo señalan como un error.

## Ejemplos

El error suele esconderse en las imágenes de productos, en los logotipos y en las imágenes dentro de enlaces. Cuando la imagen es el único contenido de un enlace o de un botón, la falta de alt crea además un [enlace vacío](https://allyway.ai/es/glossary/enlace-vacio) o un [botón vacío](https://allyway.ai/es/glossary/boton-vacio).

```html title="Ejemplo"
<!-- Error: no alt attribute -->
<img src="/images/sneaker-red.jpg">

<!-- Fixed: informative image -->
<img src="/images/sneaker-red.jpg" alt="Red running sneaker, side view">

<!-- Fixed: decorative image -->
<img src="/images/divider.svg" alt="">
```

**Do:** Qué hacer

Decida para cada imagen: informativa → describa su contenido o su finalidad; [decorativa](https://allyway.ai/es/glossary/imagenes-decorativas) → `alt=""`. Defina el texto alternativo en la biblioteca de medios de su CMS, para que se use en todos los lugares donde aparezca la imagen.

**Don't:** Qué evitar

Omitir el atributo, rellenarlo con el nombre del archivo o escribir «imagen» o «espaciador» en las imágenes decorativas: el W3C lo considera un fallo (F39).

## Cómo corregir la falta del atributo alt



Las tiendas online son las más afectadas, porque cada foto de producto cuenta. En [Shopify](https://allyway.ai/es/integrations/shopify-accessibility-integration) y en [WooCommerce en WordPress](https://allyway.ai/es/integrations/wordpress-accessibility-integration), el texto alternativo se puede definir imagen por imagen en los ajustes de medios o de producto.

## Preguntas frecuentes

Q: ¿Qué significa el error «image missing alt attribute»?
A: La etiqueta `<img>` no tiene ningún atributo `alt`. Los lectores de pantalla no disponen de alternativa textual y pueden leer en voz alta el nombre del archivo.

Q: ¿Es alt="" lo mismo que la falta del atributo alt?
A: No. `alt=""` marca una imagen como decorativa para que los lectores de pantalla la omitan: es lo correcto para la decoración. La ausencia del atributo es un error, porque nadie ha decidido si la imagen es importante.

Q: ¿Las imágenes decorativas necesitan un atributo alt?
A: Sí, uno vacío: `alt=""`. Omitirlo incumple el criterio WCAG 1.1.1; el W3C lo recoge como fallo F65.

Q: ¿Cómo encuentro las imágenes sin atributo alt?
A: Analice su página de inicio con el [comprobador WCAG gratuito](https://allyway.ai/es/free-wcag-accessibility-scanner-for-websites). Para una sola imagen, haga clic con el botón derecho sobre ella y elija *Inspeccionar* para ver si el atributo existe.

Q: ¿Puede allyWay corregir automáticamente los atributos alt que faltan?
A: Sí. La IA de allyWay examina sus imágenes y redacta textos alternativos que describen lo que realmente muestran, y después los aplica en todas las páginas. Las [correcciones automáticas](https://allyway.ai/es/automatic-accessibility-fixes-for-website) se ejecutan a través del script de allyWay: su CMS, su tema y sus archivos permanecen tal cual, y cada corrección queda registrada. [Empiece gratis](https://app.allyway.ai/register) y dé alternativas textuales a sus imágenes sin editarlas una por una.
