Cómo importar y exportar usuarios de WordPress con WP-CLI

La pantalla de importación está bien para un fichero de vez en cuando. Pero cuando el fichero tiene 50.000 usuarios, cuando la importación tiene que ejecutarse después de un despliegue o cuando gestionas veinte webs desde la terminal, una pestaña del navegador es lo último que quieres. Quieres un comando.

WordPress trae algunos comandos de WP-CLI para usuarios, pero solo manejan los campos básicos. En esta guía te explicamos qué puede hacer cada opción y cómo importar y exportar usuarios con todos sus datos desde la línea de comandos: metadatos, direcciones de WooCommerce y los datos de tus plugins, con el mismo motor que la pantalla de importación de nuestro plugin gratuito.

La respuesta corta: si solo necesitas el usuario, el email, el nombre y el rol, te bastan los comandos de WordPress (wp user import-csv y wp user list). Si necesitas todo lo demás, instala el plugin gratuito Import and export users and customers (versión 3.2 o posterior) y usa wp acui import y wp acui export.

Lo que necesitasComandos de WordPresswp acui
Usuario, email, nombre y rolSíSí
Cualquier metadato del usuarioNoSí
Direcciones de facturación y envío de WooCommerceNoSí
Columnas con cualquier nombre, reconocidas solasNoSí (--auto-map)
Comprobar el fichero sin guardar nadaNoSí (--dry-run)
Borrar o cambiar el rol de los usuarios que no están en el ficheroNoSí
Ficheros de Excel, LibreOffice y XMLNoCon el addon File Formats

Lo que WordPress puede hacer por sí solo

wp user import-csv crea y actualiza usuarios desde un CSV con las columnas user_login, user_email, display_name y role, y wp user list los lista en formato CSV:

wp user import-csv usuarios.csv
wp user list --fields=user_login,user_email,display_name --format=csv > usuarios.csv

Para un listado rápido o un puñado de usuarios nuevos es perfecto. Pero el teléfono, la empresa, la dirección de facturación, el nivel de suscripción o cualquier otro campo guardado como metadato se queda fuera, y las columnas tienen que llamarse exactamente así.

Los comandos wp acui

Desde la versión 3.2, nuestro plugin gratuito Import and export users and customers añade estos comandos. Instálalo como cualquier otro plugin (o con wp plugin install import-users-from-csv-with-meta --activate) y tendrás:

ComandoQué hace
wp acui importImporta usuarios desde un fichero o una URL
wp acui exportExporta usuarios a un fichero o a la salida estándar
wp acui columnsLista las columnas que puedes usar, también las de tus plugins
wp acui historyMuestra las últimas importaciones y exportaciones
wp acui cron runEjecuta ahora la importación programada, de una vez

wp help acui import muestra todas las opciones. Los comandos se ejecutan con el usuario que elijas con --user; sin él, usan el primer administrador y te lo indican.

Importar usuarios desde la línea de comandos

La importación más sencilla es un CSV con una columna para el usuario y otra para el email. Todas las demás columnas se guardan: campos de WordPress como first_name o role, campos de WooCommerce como billing_phone y cualquier otra columna como metadato con su nombre:

wp acui import usuarios.csv --role=subscriber
Success: Created: 1250. Updated: 34. Deleted: 0. Ignored: 0.

El fichero también puede ser una URL, por ejemplo una hoja de Google Sheets publicada como CSV. Las opciones más útiles:

  • --update-existing=no: crea los usuarios nuevos y deja como están los que ya existen.
  • --update-roles=yes o --update-roles=yes_no_override: sustituye los roles de los usuarios que ya existen, o les añade los nuevos.
  • --empty-cells=delete: una celda vacía borra el valor anterior en lugar de dejarlo.
  • --send-email: envía a los usuarios nuevos el correo que diseñaste en el plugin. Sin ella, nadie recibe ningún correo.
  • --delete-not-present o --change-role-not-present=<rol>: el fichero es la lista de usuarios activos, así que los que no están en él se borran o pasan a otro rol. Los administradores nunca se tocan, y no se borra nada si la importación ha tenido errores o avisos.

Ficheros con sus propios nombres de columna

Los ficheros exportados de un CRM, de otra plataforma o de una hoja de cálculo casi nunca tienen los nombres de columna de WordPress. Con --auto-map, el comando reconoce las columnas igual que el asistente de importación del plugin, en varios idiomas, y te enseña lo que ha decidido antes de importar:

wp acui import export-crm.csv --auto-map --map="Notas internas=__skip"

column          import_as         match
Usuario         user_login        suggested
Correo          user_email        suggested
Nombre          first_name        suggested
Teléfono        billing_phone     suggested
Ciudad          billing_city      suggested
Notas internas  (skipped)         manual

Con --map eliges a mano el campo de cualquier columna ("Correo=user_email,Notas=__skip"), y el resto conservan su nombre o se adivinan con --auto-map.

Comprobar el fichero antes de importarlo

--dry-run recorre todo el fichero y te dice qué pasaría con cada fila, sin crear ni cambiar nada: usuarios que se crearían o actualizarían, emails que no son válidos, roles que no existen, filas repetidas en el fichero y los problemas que detectan los addons, como una opción que no existe en un campo del perfil:

wp acui import export-crm.csv --auto-map --dry-run

row  type     message
3    warning  Ultimate Member: "Diseño" is not an option of "Sector"
7    error    Invalid email "maria@"
Success: Dry run, nothing has been saved. Would be created: 1198. Updated: 34. Skipped: 0. With errors: 1.

Exportar usuarios desde la línea de comandos

wp acui export exporta todos los usuarios con todos sus metadatos, o solo lo que elijas:

wp acui export --file=usuarios.csv
wp acui export --role=customer --columns=user_email,first_name,billing_city --file=clientes.csv
wp acui export --from=2026-01-01 --delimiter=SEMICOLON > usuarios-nuevos.csv

Sin --file, el fichero sale por la salida estándar, así que puedes mandarlo a otro comando, comprimirlo o subirlo a otro servidor. Puedes filtrar por rol, por IDs de usuario y por fecha de registro, elegir las columnas y su orden, el delimitador, el orden de los usuarios y el formato de las fechas, e incluir los clientes invitados de WooCommerce. Con el addon File Formats tienes además --format=xlsx, ods o xml.

El fichero exportado usa las mismas columnas que entiende la importación, así que mover los usuarios entre dos webs son dos comandos:

wp acui export --file=usuarios.csv --path=/var/www/web-antigua
wp acui import usuarios.csv --path=/var/www/web-nueva

Automatízalo con un cron

Un cron del servidor puede lanzar cualquiera de estos comandos. Por ejemplo, importar cada noche el fichero que deja tu ERP y exportar cada lunes los clientes nuevos:

30 2 * * * cd /var/www/web && wp acui import /datos/erp/usuarios.csv --update-roles=yes
0 7 * * 1 cd /var/www/web && wp acui export --role=customer --from="$(date -d '7 days ago' +\%F)" --file=/copias/clientes-nuevos.csv

Si tienes configurada la importación programada del plugin, wp acui cron run la ejecuta ahora de una vez, con su fichero y sus ajustes. Te sirve para lanzarla desde el crontab del servidor en lugar de depender de las visitas que necesita WP-Cron.

¿No tienes acceso SSH, o prefieres configurarlo desde el escritorio de WordPress? Los addons Recurring Import y Recurring Export programan todas las importaciones y exportaciones que quieras, desde ficheros, URLs, FTP o SFTP, y te envían el resultado por correo.

Con tus plugins y addons

Los comandos usan el mismo motor que la pantalla de importación, así que todo lo que hacen el plugin y sus addons funciona también desde la terminal: WooCommerce, BuddyPress, LearnDash, Ultimate Member, Paid Memberships Pro y las demás integraciones. wp acui columns lista las columnas disponibles en tu web, también las que añaden tus plugins, para que sepas qué cabecera necesita cada campo. Y cada importación y exportación hecha con WP-CLI se guarda en el historial del plugin, junto a las hechas desde el escritorio, y se puede listar con wp acui history.

Preguntas frecuentes

¿Mis usuarios recibirán un correo al importarlos?

No. La importación no envía ningún correo salvo que añadas --send-email (y --send-email-updated para los usuarios que ya existían).

¿Hay un límite de filas?

Desde la terminal no existe el límite de 30 segundos de las peticiones web, así que el fichero se importa entero de una vez, con una barra de progreso. El tiempo depende de tu servidor y de los plugins que actúan al crear o actualizar un usuario.

¿Puedo conservar las contraseñas al mover usuarios a otra web?

Sí. La exportación incluye el hash de la contraseña en la columna user_pass y la importación lo guarda tal cual, así que los usuarios siguen entrando con la misma contraseña. Si no quieres exportarlos, añade --no-password-hashes.

¿Puedo importar ficheros de Excel?

Sí, con el addon File Formats, que añade los ficheros XLSX, XLS, ODS y XML a la importación y a la exportación, también desde WP-CLI.

¿Funciona en multisitio?

Sí. Elige el sitio con el parámetro --url de WP-CLI y los usuarios se importan en ese sitio.

Conclusión

Los comandos de WordPress bastan para los campos básicos. Para todo lo demás, wp acui import y wp acui export te dan en la terminal la importación y la exportación completas de Import and export users and customers: cualquier columna, columnas reconocidas solas, una prueba antes de tocar nada, y scripts y crons que hacen el trabajo por ti.

Nota: Hay una valoración incrustada en esta entrada, por favor, visita esta entrada para valorarla.

Almacenamos las IPs desde la que se envían las valoraciones para evitar fraudes

Francisco Javier Carazo Gil

Entradas recientes

Cómo sincronizar el stock entre dos (o más) tiendas WooCommerce

Mantener el stock sincronizado entre tiendas WooCommerce: una sola tienda, exportar e importar un CSV,…

hace % días

PayGold de RedSys: qué es, cómo funciona y una alternativa más flexible

Qué es PayGold, cómo crear enlaces de pago desde el panel de RedSys, cuánto duran…

hace % días

Cómo sincronizar usuarios entre dos (o más) webs WordPress

Una tienda online y una plataforma de cursos. Una web principal y las de sus…

hace % días

Portal de comercios de Ceca: cómo entrar en la Consola TPV Virtual y configurar la URL online

Si tienes un TPV virtual de Ceca (Cecabank), tarde o temprano vas a necesitar entrar…

hace % días

Curso gratuito WPML – Menú multilingüe

En la anterior ... Llegamos a la séptima entrega de este curso. Tras la introducción…

hace % días

No se puede realizar la operación. Error de autenticación (SIS0601)

Si vendes con RedSys, es posible que algún cliente te haya enviado una captura con…

hace % días