Texto alternativo, título, leyenda, descripción ¿todo eso hay que rellenar para las imágenes? ¿sirve de algo? ¿es por SEO, por accesibilidad, por fastidiar?

Cada vez que subes una imagen a WordPress te aparece un campo llamado texto alternativo, y casi siempre se queda en blanco. Es una pena, porque rellenarlo bien es la diferencia entre una imagen que se entiende y una que no le sirve a nadie.

El texto alternativo es lo que hace que tus imágenes se entiendan cuando no se ven, sobre todo para las personas que navegan con un lector de pantalla. Si lo pones bien ayudas a quien no puede ver la imagen y de paso le das a Google algo que entender. Si no lo pones, o lo pones mal, no le sirve a nadie.

En este tutorial vamos a ver que es el texto alternativo, para qué sirve, en qué se diferencia del título, la leyenda y la descripción, qué imágenes hay que describir y cuáles van vacías, cómo escribir un alt que sea útil, y cómo te puede echar una mano la IA sin que te la líe. Y sí, de camino te pones a bien con la accesibilidad, que cada vez es menos opcional.

Qué es el texto alternativo o alt y para qué sirve

El texto alternativo, o atributo alt, es la descripción que le pones a una imagen para cuando esa imagen no se puede ver. Y es eso, un atributo de la etiqueta de imagen, no una etiqueta en sí misma, que esto lo confunde muchísima gente. En el código se ve así:<img src="logo.png" alt="Logo de Ayuda WordPress">.

Sirve para tres cosas, y el orden es importante.

1. La primera, y la que justifica su existencia, es lo que un lector de pantalla le lee en voz alta a una persona ciega o con baja visión. Si la imagen aporta información y no tiene alt, a esa persona la pierdes como lector (o cliente).
2. El navegador muestra si la imagen no carga, porque el servidor falla o la conexión va a pedales.
3. Es una señal que Google usa para entender de qué va la imagen y colocarla en su buscador de imágenes.

Te lo apunto aquí porque es el origen de muchos malentendidos … y errores:

El alt es, primero accesibilidad, y luego, SEO, no al revés.

Cuando rellenas el alt pensando solo en meter la palabra clave, le estás colgando un cartel a alguien que no lo puede leer. No le aporta nada, y encima a Google hace años que no le cuela.

En los estándares esto es el criterio 1.1.1 de las WCAG, «Contenido no textual», y es de nivel A, o sea el suelo, el requisito de accesibilidad más básico que existe. Si no cumples ese, no cumples ninguno.

Alt, título, leyenda y descripción, para qué sirve cada uno

Cuando subes una imagen a WordPress te encuentras con cuatro campos para rellenar, y aquí empieza el jaleo, porque cada uno se guarda en un sitio distinto, acaba en un lugar distinto y se comporta de forma distinta.

Por resumirte, el único que de verdad importa para accesibilidad es el texto alternativo. El resto son … otra cosa.

Y ahora unas cuantas mentiras que conviene ir aparcando, porque llevan años circulando, y alguna la conté yo mismo hace siglos, todo hay que decirlo, que algo he aprendido 20 años después y si la cago la cago.

• WordPress no te rellena el alt con el nombre del archivo. Lo que autocompleta a partir del nombre del archivo es el campo título, no el alt, que sale vacío y lo tienes que escribir tú.
• El atributo título no es obligatorio ni hace falta para «cumplir el W3C», nunca lo fue. El navegador lo enseña como un globito al pasar el ratón por encima, en el móvil ni se ve, y los lectores de pantalla no lo leen de forma fiable. No te vale como sustituto del alt.
• El campo «Descripción» no es el atributo título. Son cosas distintas que van a sitios distintos.

Sobre la pregunta de siempre, la de si el título de la imagen ayuda al SEO, pues resulta que no, el alt sí, el título prácticamente nada. Si tienes que dedicarle tiempo a algo dedícaselo al alt.

¿Las imágenes decorativas necesitan alt?

No todas las imágenes hay que describirlas. Las que son puro adorno, una línea separadora, un fondo, un icono decorativo que no aporta información, tienen su propia regla, y es justo la que más se incumple.

Para una imagen decorativa el alt va vacío del todo. Así: alt="".

Con eso le dices al lector de pantalla que se salte la imagen, que no hace falta que la narre. Es como el hilo musical del ascensor, está bien que esté, pero no necesitas que nadie te lo vaya cantando.

Hay tres maneras de hacerlo y solo una es correcta:

• alt="" vacío del todo: correcto. El lector de pantalla la ignora y a otra cosa.
• Sin atributo alt: mal. Algunos lectores de pantalla, al no encontrar alt, leen el nombre del archivo o sueltan un «imagen» a secas, que es ruido.
• alt="-", un asterisco, un espacio o «lo que te apetezca»: mal, mal y mal. Eso es contenido, y el lector de pantalla lo lee. Le estás metiendo basura en los oídos a quien intenta navegar.

Para saber si una imagen es decorativa hay un truco sencillo, quítala mentalmente. Si al quitarla no se pierde nada de información, es decorativa y va con el alt vacío. Si se pierde algo, hay que describirla.

Y si quieres afinar caso por caso hay dos herramientas que vienen de perlas.

• El árbol de decisión del W3C, que te va preguntando por el tipo y la función de la imagen hasta decirte qué poner.
• El mapa de decisión en español de Olga Carreras, que es de lo mejor que hay sobre esto en nuestro idioma.

Cómo escribir un alt útil

El alt describe la función de la imagen en esa página, no solo lo que se ve en ella. Esa es la idea fundamental, porque la misma foto puede necesitar un alt distinto según para qué la has puesto.

Unas zapatillas en un artículo sobre running se describen de una forma, y esas mismas zapatillas en la ficha de producto de tu tienda, de otra.

Con eso claro, cuatro reglas sencillas:

• Describe lo importante, no todo: Ve a lo que aporta la imagen en ese contexto.
• No te repitas empezando con cosas como «imagen de» o «foto de»: El lector de pantalla ya avisa de que es una imagen, así que se lo estarías diciendo dos veces.
• Sé breve: Como referencia, unos 125 caracteres suelen bastar, pero sin obsesionarse, que lo que importa es que sea útil.
• Mete la palabra clave solo si encaja de forma natural: Si tienes que forzarla con calzador, fuera.

No te lo cuento, te lo muestro con ejemplos, que se entiende mucho mejor.

• Una foto informativa:
  • Mal: alt="foto".
  • Peor: alt="zapatillas running comprar mejores zapatillas baratas".
  • Bien: alt="Zapatillas de running azules con suela de espuma, vistas de perfil".
• Una captura de pantalla: Describe lo relevante de la captura, no pongas «captura de pantalla».
  • Bien: alt="Ajustes de Medios de WordPress con la opción de organizar por carpetas activada".
• Una imagen que es un enlace o un botón: El alt describe a dónde lleva o qué hace, no cómo es.
  • Para un logo que enlaza al inicio: alt="Ayuda WordPress, ir al inicio", no alt="logo".
• Una gráfica o una infografía: Resume el dato principal en el alt, y si lleva mucha chicha, pon el detalle en el texto de al lado o enlaza a una versión larga.

¿Vale generar el alt automáticamente?, con IA por ejemplo

Sí, es posible, y no es ni siquiera mala idea. WordPress no te genera el alt por su cuenta, así que necesitas un plugin, y hay dos formas de hacerlo automático que conviene no confundir, porque dan resultados muy distintos.

Usando plantillas, sin IA

Varios plugins de SEO rellenan el alt a partir de datos que ya tienes, el título de publicación, el nombre del archivo o la palabra clave.

• AIOSEO, por ejemplo, con su función de SEO para imágenes, te deja montar una plantilla con sus tags y aplicarla a toda la biblioteca de una tacada.
  El problema es que el alt o sale genérico y casi siempre repetido, porque todas las imágenes de un artículo acaban con el mismo texto, y para alguien con un lector de pantalla eso es casi tan inútil como no tener nada.
• SEOPress, por su parte, hace algo parecido, creando el alt a partir del nombre del archivo, así que depende de ti subirlos en nombres descriptivos.
  En este caso la dependencia eres tú, o los redactores, que no suban las imágenes como las captura la cámara, tipo DSC22999W.JPG o parecido.

La ventaja de estos sistemas, de ambos es que son automáticos, baratos y no te cuestan nada por imagen. Te sirven de red de seguridad para que ninguna imagen quede pelada, no para tener un alt bueno.

Con IA

La segunda es con modelos IA, plugins y servicios que de verdad miran la imagen y la describen.

Aquí entran incluso el propio WordPress, que tiene un plugin oficial de experimentos IA que también lo hace, pero eso sí, vale para trastear en entornos de pruebas, no para tenerlo en producción.

Da igual el que elijas, hay muchos, tienes que conectar tu clave de un proveedor como OpenAI, Google o Anthropic, y todos te cobran por uso.

Un aviso para los del editor clásico, que sois somos unos cuantos, casi todas estas funciones están pensadas para el editor de bloques, así que igual ni ves los botones, aunque la generación en lote desde la biblioteca suele funcionar igual.

Y tanto por plantilla como con IA, hay un techo que conviene tener clarísimo.

La IA describe lo que ve en la imagen, pero no sabe para qué la has puesto tú en esa página, ni cuándo una imagen es solo decoración.

Es como pedirle el pie de foto a alguien que no ha leído tu artículo, te describe la foto de maravilla, pero no tiene ni idea de qué pinta ahí. Te va a poner un alt a todo, incluida la línea separadora que debería ir vacía, y a la imagen que en realidad es un botón le describe el dibujito en lugar de decir a dónde lleva.

Incluso el plugin oficial intenta seguir el árbol de decisión del W3C que te enseñé antes, y aun así arrastra fallos con las imágenes decorativas.

Así que lo automático, sea plantilla o IA, úsalo como punto de partida para no tener miles de imágenes a cero, y repasa tú a mano las que importen de verdad.

Las decorativas, a vaciarles el alt, las que son enlaces o botones, a describir la acción, y las que cumplen una función concreta en el artículo, a comprobar que se entienden.

Lo automático te quita el ochenta por ciento del trabajo, pero el veinte por ciento que decide si cumples o no lo pones tú.

¿Y la accesibilidad? La regulación EAA

Y ya que hablamos de hacer las cosas bien, va un plus que quizá no tenías en la cabeza, y es que desde el 28 de junio de 2025 poner bien el texto alternativo, además de ser lo suyo, ahora también te lo pide la ley.

La European Accessibility Act, que en España se traspone con la Ley 11/2023, es de obligado cumplimiento desde esa fecha, y esta vez con sanciones de las que duelen, no como las recomendaciones de antes que no cumplía ni el tato.

La buena noticia, y va en serio, es que el alt es de los requisitos más fáciles de cumplir de toda la normativa.

La técnica de referencia es la norma EN 301 549, apoyada en las WCAG a nivel AA, y dentro de eso el alt, ese criterio 1.1.1 de antes, es nivel A, el básico.

También es de los más fáciles de auditar, porque un validador de accesibilidad te canta en segundos qué imágenes se han quedado sin alt.

¿Te afecta?, pues depende

Las microempresas que prestan servicios, menos de 10 trabajadores y menos de 2 millones de euros de facturación o de balance, están exentas de parte de los requisitos, aunque ojo, que la exención hay que poder justificarla si te la vienen a mirar, no es un «como soy pequeño paso de todo».

Y, por supuesto, si tienes una tienda online, vendes a consumidores o prestas según qué servicios, lo más probable es que sí estés dentro.

No voy a entrar en un análisis jurídico sobre EEA, ni de lejos, no es lo mío ni procede, de momento quédate con lo práctico, pon bien el alt de tus imágenes y este requisito, el más visible y el más fácil de comprobar, lo tienes cubierto.

Por cierto, si quieres ver cómo queda esto por escrito, tienes mi propia declaración de accesibilidad como ejemplo. Y si tienes una web con la que te juegas algo y prefieres que alguien le eche un vistazo serio a la accesibilidad, para eso está mi consultoría.

¿Y las imágenes que ya tengo sin texto alternativo?

Si llevas años publicando, tendrás un buen montón de imágenes sin alt, y ponerte al día es parte del trabajo. La cosa tiene dos fases, encontrarlas y arreglarlas.

Para encontrarlas tienes herramientas de accesibilidad como WAVE o la extensión axe DevTools, que te marcan en la propia página qué imágenes van sin alt, y el informe de accesibilidad de Lighthouse, dentro de las herramientas de desarrollo de Chrome, que te lista los fallos de una URL.

Y más visual, mi analizador de accesibilidad online y gratis.

Para una entrada suelta, a veces basta con abrir el código fuente y buscar las etiquetas de imagen sin alt, para arreglarlas en lote valen los mismos dos enfoques de antes (plantilla, automatismos, con o sin IA)

Una cosa muy chula que poca gente sabe es que el plugin oficial de pruebas de WordPress trae hasta un comando de consola, wp ai alt-text generate, para lanzarlo por WP-CLI.

Sea como sea prioriza con sentido común y lógica de equilibrio entre esfuerzo y resultados. Primero ponte con las imágenes que aportan información en tus artículos más visitados, que son las que más gente con lector de pantalla se va a encontrar. Las decorativas las vacías, y para el resto, lo automático como red y el repaso a mano de las que son importantes.

Preguntas rápidas

¿Pongo el título o el alt cuando la imagen es un enlace?

Lo que importa es el alt, y debe describir a dónde lleva el enlace o qué hace el botón, no cómo es la imagen. El título del enlace aporta poco y no te hace falta.

Lo importante es que quien no ve la imagen entienda qué va a pasar si hace clic.

¿Puedo poner el mismo alt en varias imágenes?

Si son la misma imagen cumpliendo la misma función se puede repetir sin problema.

Lo que no tiene sentido es copiar y pegar el mismo altTu código aquí en imágenes distintas por pereza, porque cada una muestra algo diferente y merece su propia descripción.

¿Cambia algo en las imágenes de productos de WooCommerce?

El criterio es el mismo, pero en una ficha de producto el alt de la imagen principal debería describir el producto de forma útil, con el modelo, el color o algún detalle que lo identifique, que además es justo lo que te ayuda a aparecer en Google Imágenes. Nada de rellenar con la palabra clave repetida una y otra vez.

¿Hago algo ya mismo?

Si quieres terminar el día habiendo hecho algo de provecho esto es lo mínimo:

1. Abre tus 5 entradas más visitadas y revísalas imagen por imagen.
2. La que no tenga alt, o tenga el nombre del archivo metido como alt, arréglala ahora describiendo su función en ese artículo.
3. La que sea pura decoración déjale el alt vacío.

En diez minutos le has arreglado el día a alguien que navega con lector de pantalla, y de paso le has dado a Google algo mejor que entender.

Lo demás, la auditoría completa, el repaso de toda la biblioteca, dejarlo automático con IA, lo puedes ir haciendo con calma. Pero ese primer paso dalo ya hoy.

Si te ha quedado alguna duda, o no ves claro si una imagen va con alt o sin él, me tienes ahí abajo en los comentarios. Cuéntamelo y lo vemos.

¿Te gustó este artículo? ¡Ni te imaginas lo que te estás perdiendo en YouTube!