En resumen
Qué se mide
imágenes y botones de imagen sin atributo alt.
Referencia
el criterio 1.1.1 de las WCAG, de nivel A: todo contenido no textual necesita una alternativa textual con el mismo propósito.
Por qué importa
sin alt, algunos lectores de pantalla anuncian el nombre del archivo; Google usa el alt para entender de qué trata la imagen.
Severidad en Wakaris
Crítico. Falla en el 22 % de las páginas analizadas.
Qué es y qué mide este hallazgo
Este hallazgo salta cuando en tu página hay imágenes sin alternativa textual. La alternativa textual es el valor del atributo alt: según MDN, define un texto que puede reemplazar a la imagen en la página. Es lo que recibe quien navega con un lector de pantalla, y lo que se muestra cuando la imagen no carga por un error de red, un bloqueador o un enlace roto.
Wakaris mira dos tipos de elemento. Las imágenes normales, las etiquetas img del contenido. Y los botones de imagen, los input de tipo imagen que envían un formulario o ejecutan una acción con un gráfico en lugar de texto. En el botón el alt hace además de etiqueta del control, así que MDN pide que sea una cadena no vacía apropiada como nombre del botón.
La referencia es el criterio 1.1.1 de las WCAG, Contenido no textual, de nivel A: todo contenido no textual debe tener una alternativa textual con un propósito equivalente.
Cómo se mide
Wakaris carga la URL que le indiques, recorre todas las imágenes y todos los botones de imagen de la página y comprueba en cada uno si el atributo alt está presente. El resultado es un recuento por tipo de elemento, con la instancia y el fragmento de código de cada uno.
El umbral es estricto: el hallazgo salta desde la primera imagen sin alternativa, y el catálogo marca cortes adicionales en 5 y en 20 elementos que dan idea de la magnitud del problema. La severidad es la del check, Crítico, sea cual sea el recuento.
Un matiz para leer bien el informe: un alt vacío, alt="", no es lo mismo que un alt ausente. MDN documenta que la cadena vacía indica que la imagen no es parte clave del contenido, decoración o un píxel de seguimiento, y que los navegadores no visuales pueden omitirla. Es la forma correcta de marcar una imagen decorativa y no cuenta como fallo. Lo que falla es la imagen sin el atributo, porque el software no sabe si es decorativa o si alguien olvidó describirla.
Por qué importa
Importa porque la imagen sin alt desaparece para parte de tus visitantes, y lo que queda es peor que nada.
MDN lo describe así: cuando el atributo no está presente, algunos lectores de pantalla pueden anunciar el nombre del archivo de la imagen, lo que resulta confuso si ese nombre no representa el contenido. Quien usa un lector de pantalla oye algo como "IMG_4523.jpg" en medio de tu página. Si la imagen era un botón, un gráfico con datos o el único sitio donde aparecía el precio, esa información se ha perdido.
Las WCAG explican la intención del criterio 1.1.1: hacer accesible la información del contenido no textual mediante una alternativa que se pueda presentar por cualquier vía sensorial, visual, auditiva o táctil. Es de nivel A, el escalón más bajo: incumplirlo deja la página fuera de cualquier nivel de conformidad.
Y hay un plano de visibilidad. Google documenta que usa el texto alternativo, junto con algoritmos de visión y el contenido de la página, para entender de qué trata una imagen. Una imagen sin alt es una imagen que Google entiende peor.
Causas comunes
Las causas están en cómo llegan las imágenes a la página, no en una decisión consciente.
La primera es el contenido subido desde un gestor. Muchos editores permiten insertar una imagen sin rellenar el campo de texto alternativo. Si el gestor omite el atributo en lugar de escribirlo vacío, cada imagen del blog o del catálogo se convierte en un fallo.
La segunda son las imágenes generadas por la plantilla: iconos, separadores y adornos que un tema pinta con etiquetas img sin atributo. El arreglo suele ser un alt vacío, pero alguien tiene que ponerlo.
La tercera son los botones de imagen heredados: el de enviar de un formulario antiguo, el de búsqueda con una lupa dibujada, sin etiqueta. Son pocos, pero afectan a acciones clave.
La cuarta es un alt que existe pero no sirve: la palabra "imagen", el nombre del archivo o una ristra de palabras clave. MDN pide un reemplazo claro y conciso del contenido, no una descripción de que hay una imagen; Google advierte de que rellenarlo con palabras clave da mala experiencia y puede hacer que el sitio se vea como spam.
Cómo solucionarlo
Empieza por el informe de Wakaris: te da cada imagen y cada botón de imagen sin alternativa, con su fragmento de código. Antes de escribir nada, clasifica cada una por su función: el alt correcto depende de para qué está la imagen, no de lo que se ve.
Si la imagen informa, una foto de producto, un gráfico, una captura, describe lo que aporta en una frase corta. El ejemplo de Google: "cachorro" es aceptable, "cachorro de dálmata jugando a buscar la pelota" es mejor. No empieces por "imagen de": el lector ya anuncia que es una imagen.
Si la imagen actúa, un botón de imagen o una imagen dentro de un enlace, el alt describe la acción o el destino: "Buscar", "Enviar", "Inicio". MDN pone el ejemplo de un botón gráfico con el texto "Login Now": su alt debe ser también ese.
Si la imagen decora, ponle alt="" para que la tecnología de apoyo la ignore. No la dejes sin atributo. Cuando termines, vuelve a pasar la página por Wakaris y comprueba que el recuento ha bajado a cero.
Tabla con tres tipos de imagen, informativa, funcional y decorativa, y el texto alternativo que corresponde a cada uno
Brief para generar la imagen
Ilustración editorial para una guía técnica de Wakaris. Tema: Tabla con tres tipos de imagen, informativa, funcional y decorativa, y el texto alternativo que corresponde a cada uno. Estilo: fondo blanco con lavado suave lima→verde pálido (#F8F7D6 → #E2F2DC), acento en degradado verde→lima (#8ED390 → #DCD86F), tinta casi negra (#12150B), formas de pastilla y esquinas redondeadas, sombras difusas, aspecto limpio y esquemático, sin fotografía. Formato: 16:9, 1440 píxeles de ancho. Sin texto legible: cualquier rótulo, código o cifra se representa con barras grises de relleno. El significado lo lleva el pie de foto, no la imagen. Sin logotipos reales ni marcas de terceros. Sin personas reconocibles. Etiquetas: alternativas, textuales, tabla, tipos, imagen, informativa, funcional, decorativa
Pregúntale a tu IA
Si quieres profundizar en tu caso concreto, copia uno de estos dos prompts y pégalo en la IA que uses. Elige según tu situación.
Ya tengo el hallazgo medido con Wakaris y quiero solucionarlo
Actúa como un auditor técnico web profesional y prudente. Tu objetivo es ayudarme a entender un hallazgo concreto sobre mi web y decidir qué hacer con él, sin inventarte nada. Contexto: he obtenido este hallazgo con Wakaris, una herramienta que analiza una web en 9 áreas (rendimiento, SEO, seguridad, social, mercado, IA, experiencia, accesibilidad y legal) y explica cada problema de forma que lo entienda cada perfil de un equipo. El hallazgo es: Alternativas textuales. Hay imágenes o botones de imagen en mi página sin atributo alt, es decir, sin el texto que las sustituye para quien usa un lector de pantalla o cuando no cargan. Referencia: el criterio 1.1.1 de las WCAG, de nivel A, exige una alternativa textual para todo contenido no textual; el umbral de Wakaris es cero elementos sin alt. Pega aquí el resultado de Wakaris: cuántas imágenes y cuántos botones de imagen sin alternativa hay, en qué página y, si lo indica, el fragmento de código de cada uno. Si no lo tienes, dímelo y te diré cómo obtenerlo antes de seguir. Reglas que debes seguir en todo momento: 1. No asumas nada sobre mi web. Todo dato que uses tiene que venir de lo que yo te confirme o de lo que Wakaris haya medido. Si no lo sabes, pregúntamelo antes de afirmarlo. 2. Antes de darme conclusiones, hazme SIEMPRE estas preguntas, juntas y en lenguaje sencillo, para saber si este hallazgo me afecta de verdad y por dónde: a) ¿En qué plataforma está tu web? (WordPress, Shopify, web a medida, otra) b) De los elementos señalados, ¿cuántos son imágenes de contenido y cuántos botones de imagen? c) ¿Las imágenes afectadas son fotos de producto o de artículos, gráficos con datos, iconos, o adornos de la plantilla? d) ¿Las imágenes las subes tú desde un editor, o las genera el tema o un plugin? e) ¿Tu editor tiene un campo de "texto alternativo" al insertar imágenes? ¿Lo rellenas? f) ¿Cuántas imágenes tiene la web en total, aproximadamente? ¿Decenas o miles? g) Si hay que aplicar un arreglo técnico, ¿lo harías tú, un técnico interno o una agencia? 3. Toda afirmación o recomendación tiene que ir argumentada respecto a MI contexto, no en general. Si me recomiendas algo, explícame por qué aplica a mi caso. 4. Marca siempre tu nivel de certeza. Si algo es una hipótesis porque no lo puedes medir, dilo: tú no ves mi web, razonas sobre lo que yo te cuento. 5. No me propongas cambios técnicos irreversibles o de riesgo (configuración de servidor, borrar recursos, cambios directos en producción) sin avisarme antes del riesgo y de que conviene una copia de seguridad o un entorno de prueba. 6. Si necesitas un dato que solo se obtiene comprobando la web (confirmar el resultado real, la página exacta, o si el arreglo funcionó), dímelo y recomiéndame volver a pasar la página por Wakaris: eso se comprueba, no se adivina. 7. La decisión final es mía, no tuya. Tu papel es ayudarme a entender y a preparar la acción, no decidir por mí. 8. Si el arreglo excede lo que puedo hacer yo, o lo va a ejecutar un equipo, ayúdame a dejar el problema listo para traspasarlo: qué es, dónde está, por qué importa y qué habría que hacer, en un formato accionable para esa persona. Fuente de este hallazgo: https://www.wakaris.com/es/guias/accesibilidad/alternativas-textuales Para comprobarlo o volver a comprobarlo: https://www.wakaris.com/ Empieza presentándote brevemente en tu rol y haciéndome el primer bloque de preguntas.
Aún no lo he medido y quiero comprobar si mi web tiene este problema
Actúa como un auditor técnico web profesional y prudente. Estoy investigando si mi web tiene un problema concreto y quiero que me ayudes a averiguarlo con honestidad, sin darlo por hecho. Contexto: he llegado a esto a través de Wakaris, una herramienta que analiza una web en 9 áreas (rendimiento, SEO, seguridad, social, mercado, IA, experiencia, accesibilidad y legal) y explica cada problema de forma que lo entienda cada perfil de un equipo. El problema que quiero investigar es: Alternativas textuales. Consiste en que hay imágenes o botones de imagen en mi página sin atributo alt: el texto que las sustituye para quien usa un lector de pantalla o cuando no cargan. Referencia: el criterio 1.1.1 de las WCAG, de nivel A; el umbral es cero elementos sin alt. Todavía NO sé si mi web lo tiene: quiero averiguarlo. Reglas que debes seguir en todo momento: 1. Lo primero y más importante: esto se COMPRUEBA sobre la página real, y tú no puedes comprobar mi web desde esta conversación. Déjame claro desde el principio que no vas a poder darme un "sí lo tienes" o "no lo tienes" definitivo, solo una hipótesis a partir de lo que yo te cuente. 2. No asumas nada. Antes de darme ninguna valoración, hazme SIEMPRE estas preguntas, juntas y en lenguaje sencillo, para estimar si es probable que tenga el problema: a) Cuando subes una imagen a tu web, ¿rellenas un campo de "texto alternativo" o "alt"? ¿Sabes si existe en tu editor? b) ¿Tu web tiene muchas imágenes de producto, de artículos o de galería? c) ¿Algún botón de la web es una imagen en lugar de texto? (una lupa para buscar, un gráfico para enviar un formulario) d) ¿Usas un tema o plantilla comprado, o un diseño hecho a medida? e) ¿En qué plataforma está? (WordPress, Shopify, web a medida, otra; o no lo sé) f) ¿Alguien ha revisado alguna vez la accesibilidad de la web? 3. Con mis respuestas, dame una estimación clara de si es PROBABLE o POCO PROBABLE que lo tenga, argumentada según lo que te he dicho y marcada explícitamente como hipótesis, no como diagnóstico. 4. Dime de forma directa que la única manera de saberlo de verdad es comprobarlo, y que puedo hacerlo gratis y sin crear cuenta pasando mi web por Wakaris, que me dará el resultado real, el recuento de imágenes y botones de imagen sin alternativa con el fragmento de código de cada uno y de paso el estado de las otras áreas. 5. Si te pregunto cómo comprobarlo a mano, no me lo ocultes, pero recuérdame que Wakaris lo hace más rápido, sobre la página real y con información adicional que a mano no obtengo. 6. Si al comprobarlo resulta que sí lo tengo, dime que el siguiente paso es entender cómo me afecta y cómo solucionarlo en mi caso concreto. 7. La conclusión y la decisión son mías, no tuyas. Tú me ayudas a orientarme. Fuente de este hallazgo: https://www.wakaris.com/es/guias/accesibilidad/alternativas-textuales Para comprobarlo: https://www.wakaris.com/ Empieza presentándote brevemente en tu rol, dejando claro el punto 1, y haciéndome el bloque de preguntas.
Preguntas frecuentes
¿Qué diferencia hay entre un alt vacío y no poner alt? +
Un alt="" le dice al lector de pantalla que la imagen es decorativa y puede saltarla; es correcto y Wakaris no lo cuenta como fallo. Sin el atributo, el software no sabe qué hacer y algunos lectores leen el nombre del archivo. Lo que falla es la ausencia del atributo, no el valor vacío.
¿Qué escribo en el alt de una foto de producto? +
Lo que la foto aporta a quien no la ve: qué es, qué la distingue, en una frase corta. Google pone como ejemplo óptimo "cachorro de dálmata jugando a buscar la pelota" frente a "cachorro". Evita "imagen de", el nombre del archivo y las listas de palabras clave.
¿El alt afecta al posicionamiento en Google? +
Google documenta que usa el texto alternativo, junto con algoritmos de visión y el contenido de la página, para entender el tema de una imagen. Un buen alt ayuda a que la imagen aparezca en búsquedas relacionadas, pero rellenarlo con palabras clave produce el efecto contrario: Google lo describe como mala experiencia y posible spam.
¿Un botón de imagen sin alt es tan grave como una imagen sin alt? +
Suele ser más grave. En una imagen se pierde información; en un botón de imagen se pierde el control: el lector de pantalla no puede decir qué hace y quien navega por voz no puede activarlo. MDN pide que el alt de un botón de imagen sea una cadena no vacía que sirva como etiqueta del botón.
Fuentes citadas
- w3.orgUnderstanding Success Criterion 1.1.1: Non-text Content, W3C WAI: texto del criterio, nivel A, excepciones para decoración y controles, e intención de presentar la alternativa por cualquier vía sensorial.
- developer.mozilla.org<img>: The Image Embed element, MDN Web Docs: qué es el atributo
alt, su uso cuando la imagen no carga, elaltvacío para decoración, el nombre de archivo que anuncian algunos lectores y cómo redactarlo. - developer.mozilla.org<input type="image">, MDN Web Docs: el
altdel botón de imagen como etiqueta del control, cadena no vacía, y el ejemplo "Login Now". - developers.google.comGoogle Images SEO best practices, Google Search Central: uso del texto alternativo junto con visión artificial y contenido de la página; ejemplos de
altpobre, mejor y óptimo; advertencia sobre el relleno de palabras clave.
Actualizado: 7 de septiembre de 2026.
Este artículo forma parte de Wakaris, que analiza tu web en 9 áreas y explica cada hallazgo de forma que lo entienda cada perfil de tu equipo.