El texto alternativo es la breve descripción de una imagen que se guarda en el atributo alt del elemento img, y es la mejora de accesibilidad con más impacto que puede aplicar la mayoría de los sitios web. Los lectores de pantalla lo leen en voz alta a las personas ciegas y con baja visión, los navegadores lo muestran cuando una imagen no carga y los buscadores se apoyan en él para entender qué muestra una imagen. También es un asunto legal: el criterio de conformidad 1.1.1 de las WCAG exige una alternativa textual para todo el contenido no textual en el nivel A, el nivel mínimo, y leyes como el European Accessibility Act se construyen justo sobre esos criterios. La buena noticia es que escribir bien un texto alternativo es una habilidad de minutos, no de semanas. Las reglas caben en una ficha: describe lo que importa de la imagen en su contexto, quédate en una frase concisa, evita fórmulas como imagen de, da a las imágenes puramente decorativas un atributo alt vacío y nunca omitas el atributo por completo. Esta guía recorre cada regla con ejemplos, muestra dónde vive el texto alternativo en WordPress y termina explicando cómo encontrar todas las imágenes de tu sitio a las que todavía les falta.
¿Qué es el texto alternativo y quién depende de él?
En el código HTML, el texto alternativo es un atributo del elemento de imagen:
<img src="lighthouse.jpg" alt="Faro de rayas rojas y blancas en una costa rocosa al atardecer">Lo consumen tres públicos, y pensar en ellos explica casi todas las reglas que siguen. Quien usa lector de pantalla escucha el texto alternativo en lugar de la imagen, así que para esa persona el texto sencillamente es la imagen. Alrededor de 2.200 millones de personas en el mundo viven con alguna forma de discapacidad visual según la OMS, y los lectores de pantalla son la forma en que navega una parte importante de ellas. Los navegadores muestran el texto cuando la imagen no puede cargar, algo que sigue pasando a diario con conexiones lentas y despliegues rotos. Y los rastreadores de los buscadores, que no ven las imágenes como las ven las personas, usan el atributo alt como su principal señal textual sobre el contenido de una imagen.
El requisito formal procede del criterio de conformidad 1.1.1 Non-text Content de las WCAG. Está en el nivel de conformidad A, lo que significa que un sitio sin alternativas textuales suspende el listón más bajo de la conformidad en accesibilidad, por muy bien hecho que esté todo lo demás.
Cómo escribir buenos textos alternativos: cinco reglas que cubren casi todo
El texto alternativo es escritura, y como toda escritura mejora con unas cuantas restricciones. Estas cinco te sacan de casi cualquier imagen:
- Describe contenido y propósito, no píxeles. Pregúntate qué comunica la imagen en este contexto y di eso. La misma foto de una persona ante un portátil puede ser Agente de soporte atendiendo chats de clientes en una página de soporte y Trabajando desde la mesa de la cocina en un artículo sobre trabajo en remoto.
- Sé específico, pero párate en lo relevante. Perro dice menos que Cachorro de golden retriever persiguiendo una pelota por el césped. Pero si el artículo va del cuidado del césped, puede que la raza importe menos que la hierba mordisqueada.
- Quédate en torno a una frase. Una guía muy extendida es rondar los 125 caracteres, una convención heredada de los lectores de pantalla antiguos que partían los textos largos en trozos. No es un límite estricto, pero es un buen empujón hacia la concisión. Pon delante las palabras importantes.
- Evita imagen de y foto de. Los lectores de pantalla ya anuncian el elemento como imagen, así que esas fórmulas son pura repetición. Decir el tipo aporta valor solo cuando importa: pintura de, captura de pantalla de y gráfico de sí orientan a quien escucha.
- En imágenes enlazadas o funcionales, describe el destino o la acción. Un logotipo que enlaza a la página de inicio debería decir Nombre de la empresa, página de inicio, no describir el diseño del logotipo. Un botón de icono que lanza una búsqueda debería decir Buscar. La función gana a la apariencia siempre que una imagen haga algo.
Un caso especial merece su propia frase: las imágenes que contienen texto. Las WCAG desaconsejan de entrada meter texto dentro de las imágenes, pero cuando existe, por ejemplo en un banner promocional, el texto alternativo debe incluir ese texto, porque es invisible para todo el que dependa de la alternativa.
Textos alternativos buenos y malos: ejemplos comparados
| Imagen | Texto alternativo flojo | Buen texto alternativo |
|---|---|---|
| Foto de producto en una tienda | shoe | Zapatilla de running Nike Air Zoom azul, vista lateral |
| Foto de equipo en la página Sobre nosotros | IMG_4032.jpg | El equipo de cinco personas de InspectWP delante de la oficina de Hamburgo |
| Gráfico en una entrada de blog | chart | Gráfico de barras: el tiempo de carga baja de 4,2 a 1,8 segundos tras activar la caché |
| Logotipo que enlaza a la página de inicio | logo-final-v3 | ExampleCorp, volver a la página de inicio |
| Adorno separador decorativo | elemento grafico decorativo separador con espiral | (atributo alt vacío) |
Fíjate en el patrón de la columna floja: nombres de archivo, palabras sueltas y descripciones de píxeles en lugar de significado. La fila del gráfico muestra la mayor diferencia. Para quien usa lector de pantalla, gráfico no transmite nada, mientras que un resumen de una línea del hallazgo sustituye a toda la imagen. Si un gráfico es demasiado complejo para una línea, resume la conclusión clave en el texto alternativo y ofrece los datos completos en una tabla cercana.
Imágenes decorativas: cuándo el texto alternativo vacío es lo correcto
No todas las imágenes transmiten significado. Los separadores ornamentales, las formas abstractas de fondo y las fotos de archivo que solo añaden ambiente son decoración, y el marcado correcto para ellas es un atributo alt vacío:
<img src="divider-ornament.svg" alt="">El atributo vacío es una señal deliberada que dice a los lectores de pantalla que se salten la imagen por completo, que es justo lo que hace en la práctica quien ve la página. Esto es muy distinto de omitir el atributo: sin ningún atributo alt, muchos lectores de pantalla recurren a anunciar el nombre del archivo, y quien visita la página escucha grafico barra separador guion adorno guion final guion v2 punto svg leído en voz alta a mitad de frase. Por eso los verificadores de accesibilidad marcan los atributos alt ausentes como errores mientras tratan los vacíos como válidos. El W3C ofrece un práctico árbol de decisión para el texto alternativo para los casos límite honestos.
Una prueba pragmática para saber si algo es decorativo: imagina la imagen desaparecida. Si la página no pierde información ni función, el alt vacío es lo correcto. Si desaparece algo con significado, descríbelo.
Cómo añadir texto alternativo en WordPress
WordPress da a cada imagen un campo de texto alternativo, y se llega a él en tres clics:
- En el editor de bloques: selecciona el bloque de imagen y el campo Texto alternativo aparece en la barra lateral de ajustes del bloque, dentro de Ajustes. Este es el valor que acaba en el HTML de la página.
- En la biblioteca de medios: abre cualquier imagen y rellena el campo Texto alternativo en los detalles del adjunto. Este valor se usa como predeterminado cuando la imagen se inserte en algún sitio en el futuro.
- En las imágenes destacadas: el texto alternativo procede del valor guardado en la biblioteca de medios para esa imagen, así que las miniaturas de las entradas heredan lo que haya ahí.
Una peculiaridad de WordPress es responsable de mucha confusión y merece un aviso destacado: actualizar el texto alternativo en la biblioteca de medios no cambia las imágenes que ya están colocadas en las entradas. El editor de bloques copia el texto alternativo dentro del contenido de la entrada en el momento de insertarla, y a partir de ahí la copia es independiente. Si corriges textos alternativos en la biblioteca de medios y te preguntas por qué las páginas no han cambiado, ese es el motivo. Las inserciones existentes hay que editarlas en las propias entradas, o con una herramienta de search-replace si la escala lo exige.
Ya que estás en el flujo de medios: el campo de texto alternativo no es el campo de título ni la leyenda. El título es sobre todo interno, la leyenda es el texto visible bajo la imagen, y solo el atributo alt sirve a los lectores de pantalla y a los rastreadores. Rellenar el campo equivocado es la forma más común de acabar con leyendas bonitas y atributos alt vacíos.
Texto alternativo y SEO: qué dice Google en realidad
La documentación de SEO de imágenes de Google no deja lugar a dudas: un texto alternativo descriptivo es un factor de posicionamiento en Google Images y ayuda a Google a entender tanto la imagen como la página que la rodea. Para tiendas y sitios de contenido, la búsqueda de imágenes es un canal de tráfico real, y el atributo alt es su palanca más directa. El mismo documento contiene la advertencia igual de clara: llenar los atributos alt de palabras clave produce una experiencia negativa para la persona usuaria y puede hacer que tu sitio se perciba como spam.
La traducción práctica: escribe el texto alternativo pensando primero en quien escucha y, si el tema de la página encaja de forma natural en la descripción, inclúyelo una vez. Zapatilla de running Nike Air Zoom azul, vista lateral es un buen texto alternativo que casualmente contiene las palabras que buscaría quien compra. zapatillas running comprar zapatillas running baratas mejores zapatillas running 2026 es spam disfrazado de atributo alt. Los nombres de archivo descriptivos (zapatilla-running-azul.jpg en lugar de IMG_4032.jpg) y un texto circundante que encaje con la imagen completan el cuadro, pero el texto alternativo sigue siendo la señal más fuerte que controlas por completo.
Cómo encontrar imágenes sin texto alternativo en tu sitio
Escribir buenos textos alternativos empieza por saber dónde faltan, y hay herramientas para cada escala. Para una sola página, el navegador puede responder directamente: abre la consola de las herramientas de desarrollo y ejecuta una línea que liste todas las infractoras.
// Lista todas las imágenes sin atributo alt en la página actual
document.querySelectorAll('img:not([alt])').forEach((img) => console.log(img.src));Para auditar página a página con feedback visual, la herramienta gratuita WAVE de WebAIM marca cada atributo alt ausente o sospechoso directamente sobre la página renderizada, y Lighthouse en Chrome incluye la comprobación en su auditoría de accesibilidad. La magnitud del problema está bien documentada: el análisis anual WebAIM Million, que revisa el millón de páginas de inicio más visitadas, encuentra año tras año los textos alternativos ausentes entre los fallos de accesibilidad más comunes, en aproximadamente la mitad de todas las páginas de inicio analizadas. Sea lo que sea que encuentres en tu propio sitio, estás en muy buena compañía y, a diferencia de la mayoría de los problemas de accesibilidad, este se arregla imagen a imagen, en cuestión de minutos.
Cómo comprueba InspectWP tus textos alternativos
Un informe de InspectWP cuenta las imágenes de una página analizada e indica, en la sección de SEO, cuántas llevan atributo alt y cuántas no lo tienen, marcando las ausencias como aviso. Eso te da el inventario de textos alternativos que faltan en un sitio WordPress sin abrir las herramientas de desarrollo y, como los informes se pueden programar, también detecta las regresiones que aparecen inevitablemente cuando se publica contenido nuevo con prisas. Combina el recuento del informe con las reglas de escritura de esta guía y el camino es corto: encuentra las imágenes, describe lo que importa, deja la decoración en silencio con el alt vacío, y tanto quienes usan lector de pantalla como tu tráfico de búsqueda de imágenes se llevan el beneficio.