¿Cómo de accesible es su sitio web?Comprobar gratis
WCAG 1.1.1Nivel APerceptible

Falta el atributo alt: el error explicado y corregido

También llamado: Imagen sin atributo alt, Las imágenes deben tener texto alternativo, Sin atributo alt

Definición

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.

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 es un criterio de nivel A de las 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)

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 o un botón vacío.

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="">
Qué hacer

Decida para cada imagen: informativa → describa su contenido o su finalidad; decorativa → 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.

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 y en WooCommerce en WordPress, el texto alternativo se puede definir imagen por imagen en los ajustes de medios o de producto.

    Preguntas frecuentes

    ¿Qué significa el error «image missing alt attribute»?

    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.

    ¿Es alt="" lo mismo que la falta del atributo alt?

    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.

    ¿Las imágenes decorativas necesitan un atributo alt?

    Sí, uno vacío: alt="". Omitirlo incumple el criterio WCAG 1.1.1; el W3C lo recoge como fallo F65.

    ¿Cómo encuentro las imágenes sin atributo alt?

    Analice su página de inicio con el comprobador WCAG gratuito. Para una sola imagen, haga clic con el botón derecho sobre ella y elija Inspeccionar para ver si el atributo existe.

    ¿Puede allyWay corregir automáticamente los atributos alt que faltan?

    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 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 y dé alternativas textuales a sus imágenes sin editarlas una por una.

    • Texto alternativo

      El texto alternativo es una breve descripción escrita de una imagen. Los lectores de pantalla la leen en voz alta y los navegadores la muestran cuando la imagen no se carga, de modo que las personas que no pueden ver la imagen también captan su significado.

      Leer la definición: Texto alternativo
    • Enlace vacío: qué significa el error y cómo corregirlo

      Un enlace vacío es un elemento de enlace sin nombre accesible: sin texto, sin texto alternativo en una imagen que contenga y sin aria-label. Los lectores de pantalla solo pueden anunciarlo como un simple enlace, así que el usuario no sabe adónde lleva.

      Leer la definición: Enlace vacío: qué significa el error y cómo corregirlo
    • Botón vacío: qué significa el error y cómo corregirlo

      Un botón vacío es un elemento button sin nombre accesible: sin texto, sin aria-label y sin texto alternativo en una imagen que contenga. Los lectores de pantalla solo anuncian que es un botón, no lo que hace.

      Leer la definición: Botón vacío: qué significa el error y cómo corregirlo
    • Imágenes decorativas: cuándo usar alt=""

      Las imágenes decorativas son imágenes puramente ornamentales o usadas solo para dar formato visual, que no aportan información a la página. El criterio WCAG 1.1.1 exige que se implementen de forma que las tecnologías de apoyo puedan ignorarlas, por ejemplo con un atributo alt vacío o como fondo CSS.

      Leer la definición: Imágenes decorativas: cuándo usar alt=""

    Deje que la IA se ocupe de la accesibilidad web

    Hecho en Europa. Se instala en 2 minutos, sin necesidad de desarrolladores. Ponga la accesibilidad de su sitio web en piloto automático con correcciones con IA y monitorización automática.

    1. 1Elija su plan
    2. 2Instalación en 2 min
    3. 3Deje que la IA corrija su sitio web
    4. Listo