Texto alternativo, título, leyenda y descripción: qué rellenar en tus imágenes (y qué no)

Cuando subes una imagen a WordPress, la biblioteca de medios te ofrece cuatro campos: texto alternativo, título, leyenda y descripción. La reacción habitual es rellenar todos con lo mismo o no rellenar ninguno.

Ninguna de las dos es buena idea. Cada campo tiene una función distinta, y solo uno es realmente importante.

Para qué sirve cada campo

• Texto alternativo (alt): describe la imagen para quien no puede verla. Lo leen los lectores de pantalla que usan personas ciegas, lo usa Google para entender la imagen y lo leen las IAs cuando resumen tu página. Este es el importante.
• Título: WordPress lo crea a partir del nombre del archivo. Sirve para que tú encuentres la imagen en la biblioteca. Los buscadores casi no le dan importancia.
• Leyenda (caption): el texto que se ve debajo de la imagen, para todos. Úsala cuando aporte algo: el crédito de una foto, una explicación de un gráfico, un dato.
• Descripción: se mostraba en la página de adjunto de cada imagen. Si esas páginas están desactivadas (lo normal desde WordPress 6.4), no se ve en ninguna parte.

Cómo escribir un buen texto alternativo

La pregunta que tienes que responder es: ¿qué perdería alguien que no puede ver esta imagen?

• Concreto y breve. Una o dos frases. «Panel de cPanel con la opción Copias de seguridad marcada en rojo» es mejor que «captura de pantalla».
• No empieces con «imagen de» o «foto de». Los lectores de pantalla ya avisan que es una imagen.
• Si la imagen tiene texto importante, inclúyelo. En una captura de un error, el alt debería decir el mensaje del error.
• No rellenes con palabras clave. «WordPress WordPress hosting barato Chile» no describe nada y Google lo detecta.
• Las imágenes decorativas llevan el alt vacío. Separadores, fondos o íconos que acompañan a un texto que ya dice lo mismo. Vacío no es lo mismo que olvidado: le dice al lector de pantalla que puede saltarla.
• En productos, describe lo que se ve: «Polera de algodón azul marino, cuello redondo, vista frontal». Ayuda en Google Imágenes y en las búsquedas de compras con IA.

La trampa que casi nadie conoce

Cuando insertas una imagen en una entrada con el editor de bloques, el texto alternativo se copia dentro de la entrada en ese momento. Si después lo corriges en la biblioteca de medios, las entradas donde ya la usaste no se actualizan.

Por eso, para corregir imágenes ya publicadas, tienes que hacerlo en el bloque de imagen de cada entrada (barra lateral → Texto alternativo), no solo en la biblioteca.

Las imágenes destacadas sí toman el texto alternativo de la biblioteca, porque el tema las muestra en el momento. Así que para ellas basta con corregirlo una vez.

Encontrar las imágenes sin texto alternativo

En phpMyAdmin, pestaña SQL (cambia wp_ si usas otro prefijo), esta consulta lista las imágenes de la biblioteca que no tienen alt:

SELECT p.ID, p.post_title, p.guid
FROM wp_posts p
LEFT JOIN wp_postmeta m
  ON m.post_id = p.ID AND m.meta_key = '_wp_attachment_image_alt'
WHERE p.post_type = 'attachment'
  AND p.post_mime_type LIKE 'image/%'
  AND (m.meta_value IS NULL OR m.meta_value = '')
ORDER BY p.ID DESC;

Y esta otra encuentra entradas publicadas que contienen imágenes con el alt vacío dentro del contenido:

SELECT ID, post_title
FROM wp_posts
WHERE post_status = 'publish'
  AND post_type IN ('post', 'page')
  AND post_content LIKE '%alt=""%';

Revisa los resultados con calma: algunas serán imágenes decorativas que está bien dejar vacías.

Nivel pro: que no se te vuelva a olvidar

Este mu-plugin agrega una columna en Entradas → Todas las entradas que marca con un aviso las entradas cuya imagen destacada no tiene texto alternativo. Así las ves todas de un vistazo. Guárdalo como wp-content/mu-plugins/cwp-aviso-alt.php:

<?php
/**
 * Plugin Name: Aviso de texto alternativo (Curso WordPress)
 */

add_filter( 'manage_posts_columns', function ( $columnas ) {
	$columnas['cwp_alt'] = 'Alt destacada';
	return $columnas;
} );

add_action( 'manage_posts_custom_column', function ( $columna, $post_id ) {
	if ( 'cwp_alt' !== $columna ) {
		return;
	}
	$id_imagen = get_post_thumbnail_id( $post_id );
	if ( ! $id_imagen ) {
		echo '—';
		return;
	}
	$alt = get_post_meta( $id_imagen, '_wp_attachment_image_alt', true );
	echo '' === trim( (string) $alt )
		? '<span style="color:#b32d2e">⚠ falta</span>'
		: '<span style="color:#008a20">✓</span>';
}, 10, 2 );

Sobre el texto alternativo generado con IA: hay plugins que lo escriben automáticamente. Pueden ahorrarte trabajo con bibliotecas enormes, pero revisa lo que generan: a veces describen bien la imagen y mal su propósito, que es lo que importa.

¿Tienes dudas sobre cómo describir un tipo de imagen en particular? Comparte un ejemplo en el foro y lo pensamos juntos.