Si trabajas una web en varios idiomas con WPML, actualizar el texto alternativo de las imágenes puede convertirse rápidamente en una tarea bastante pesada. Sobre todo cuando tienes muchas imágenes ya subidas y necesitas traducir o revisar los ALT por idioma.
Porque cuando una biblioteca multimedia crece, editar ALT manualmente deja de ser una tarea… y empieza a parecer castigo administrativo.
La forma más rápida de hacerlo es trabajar con un CSV: exportas las imágenes del idioma que quieras editar, modificas los ALT en bloque y vuelves a importarlos en WordPress.
En este ejemplo vamos a usar Bubuku Media Library para exportar e importar los ALT masivamente desde CSV, trabajando directamente con los idiomas de WPML.
Si además quieres profundizar más sobre accesibilidad, SEO de imágenes o gestión masiva de ALT en WordPress, puedes echar un vistazo a nuestro artículo sobre cómo añadir texto alternativo masivamente en WordPress.
Vídeo rápido del proceso
También hemos preparado una versión visual rápida del proceso para quienes prefieran verlo en vídeo.
Paso 0: Configura correctamente WPML
Antes de exportar o importar los ALT, revisa la configuración en WPML que debe estar activa. Sin ella, los textos alternativos no se gestionan correctamente por idioma y el proceso no funcionará como se espera.
Ve a «WPML → Ajustes → Media Translation» y activa la opción «Automatically detect best options for translating image texts (alt, caption, title)». Esta opción está marcada como Recommended por WPML y evita duplicados innecesarios y traducciones que no aparecen en el front-end.
Cómo funciona el flujo: exportar, editar e importar
El plugin Bubuku Media Library añade en Herramientas dos funcionalidades clave: exportar las imágenes a CSV e importar los cambios desde ese mismo CSV. La clave del flujo multiidioma es que el idioma activo del administrador de WordPress determina qué ALT text se exporta y cuál se importa.
Por eso el proceso correcto es trabajar idioma por idioma.
La clave está en no mezclar idiomas: cambia siempre el idioma del administrador antes de exportar o importar cada CSV.
Paso 1: Exporta las imágenes del idioma que quieras editar
El primer paso es exportar las imágenes del idioma sobre el que quieras trabajar.
La parte importante aquí es que WPML utiliza el idioma activo del administrador de WordPress para decidir qué ALT exporta e importa después en el CSV.
Por ejemplo, si el administrador está en inglés, exportarás los ALT del inglés. Si cambias el idioma del administrador a español, trabajarás sobre los ALT en español.
Desde Herramientas → BBK Media Library, selecciona el idioma correspondiente y exporta el archivo CSV.
La barra superior de WordPress mostrará el idioma activo del administrador.
Usa el filtro «Without ALT» para ver solo las imágenes sin texto alternativo en ese idioma, y pulsa Export CSV.
Obtendrás un CSV por idioma. Ambos hacen referencia a las mismas imágenes (mismo ID, misma URL), pero el campo Alt Text estará vacío o con el valor actual en el idioma correspondiente.
Estructura del CSV exportado
El archivo exportado incluye varias columnas con información de la imagen: nombre, URL, tamaño, formato, fecha, título de la página donde aparece y URL de esa página. Toda esa información es de referencia para que puedas identificar fácilmente qué imagen es cuál y escribir un ALT adecuado.
La idea es trabajar un CSV independiente por idioma para evitar mezclar traducciones o sobrescribir ALT que ya estaban correctos.
Aunque el CSV exportado incluye campos como el nombre de la imagen, el tamaño o el título de la página, al importar solo se actualiza el campo Alt Text. El resto de columnas no se modifican. Si modificas otras columnas por error, no te preocupes: únicamente se aplicará el campo ALT text.
A continuación puedes ver un ejemplo con los dos CSV lado a lado, uno en inglés.
| ID | Filename | URL | ALT text |
|---|---|---|---|
| 1255 | wood-table.jpg | https://dominio.com/uploads/wood-table.jpg | Natural wooden dining table |
| 1256 | office-chair.jpg | https://dominio.com/uploads/office-chair.jpg | Black ergonomic office chair |
Paso 2: Edita la columna ALT text del CSV
Una vez exportado el CSV, solo tienes que editar la columna ALT text con los textos alternativos del idioma correspondiente.
Puedes hacerlo desde: Excel, Google Sheets, Numbers o cualquier editor CSV.
La recomendación aquí es sencilla: mantener descripciones claras, naturales y coherentes con el idioma que estés trabajando.
Recuerda:
- El texto alternativo debe describir qué aporta la imagen al contenido, no simplemente lo que se ve.
- Si una imagen es puramente decorativa, deja el campo vacío (alt=»» es lo correcto).
- No superes los 125 caracteres aproximadamente: concisión y claridad son clave.
Si tienes muchas imágenes, puedes utilizar IA para generar una primera propuesta de ALT y después revisarla antes de importar el CSV. Cuanto más contexto tenga la IA, mejores resultados suele dar. Por eso es útil mantener columnas como: Post Title y Post URL.
Aunque la IA acelera bastante el trabajo es necesario revisar los textos antes de importarlos, porque tiene cierta facilidad a veces de irse por los cerros de Úbeda.
Paso 3: Importar el CSV (con el idioma correcto activo)
Este es el paso más crítico: el idioma del admin de WordPress debe coincidir con el idioma del CSV que vas a importar. Si importas el CSV en inglés con el admin en español, los textos se asignarán al idioma incorrecto.
Para importarlo, cambia el idioma en la barra superior del admin de WordPress, ve a Herramientas → BBK Media Library → sección Import ALT text from CSV → sube el archivo CSV → pulsa Import ALT text.
El plugin actualizará automáticamente los ALT de las imágenes utilizando los IDs del CSV, así que no hace falta editar nada manualmente dentro de la biblioteca multimedia.
Una vez termine el proceso, puedes repetir exactamente el mismo flujo para el resto de idiomas.
Paso 4: Verificar que funciona
Una vez importados todos los CSVs, puedes comprobar el resultado de dos formas:
- Cambia el idioma del admin y accede a Medios → Biblioteca. Haz clic en una imagen: el campo «Texto alternativo» debe mostrar el ALT en el idioma activo.
- Visita la página en cada idioma y revisa el código fuente (
Ctrl+U): busca el atributoalt="..."en las imágenes para confirmar que el texto es el correcto en cada versión.
Si ves que el ALT sigue mostrando el idioma original en vez del traducido, vuelve al Paso 0 y asegúrate de que la opción de detección automática en WPML está activada. Es el error más frecuente.
Una forma mucho más rápida de mantener los ALT traducidos
Trabajar los ALT desde CSV cambia bastante la forma de gestionar una biblioteca multimedia grande en WordPress, especialmente en proyectos multidioma con WPML.
En lugar de editar imágenes una por una, puedes:
- exportar por idioma,
- revisar o traducir los ALT en bloque,
- apoyarte en IA si necesitas acelerar el proceso,
- e importar todos los cambios de una sola vez.
El flujo es bastante más rápido, más cómodo y mucho más fácil de mantener cuando el proyecto empieza a crecer.
Además, separar los CSV por idioma ayuda a evitar muchos problemas típicos de sincronización entre traducciones y medios en WPML.
Si quieres profundizar más sobre accesibilidad, SEO de imágenes o gestión masiva de texto alternativo en WordPress, puedes echar un vistazo a nuestra guía sobre cómo añadir texto alternativo masivamente en WordPress.
Y si trabajas habitualmente con bibliotecas multimedia grandes en WordPress, Bubuku Media Library está pensado precisamente para simplificar este tipo de tareas repetitivas sin acabar peleándote imagen por imagen con la biblioteca multimedia.
