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 necesitas | Comandos de WordPress | wp acui |
|---|---|---|
| Usuario, email, nombre y rol | Sí | Sí |
| Cualquier metadato del usuario | No | Sí |
| Direcciones de facturación y envío de WooCommerce | No | Sí |
| Columnas con cualquier nombre, reconocidas solas | No | Sí (--auto-map) |
| Comprobar el fichero sin guardar nada | No | Sí (--dry-run) |
| Borrar o cambiar el rol de los usuarios que no están en el fichero | No | Sí |
| Ficheros de Excel, LibreOffice y XML | No | Con el addon File Formats |
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í.
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:
| Comando | Qué hace |
|---|---|
wp acui import | Importa usuarios desde un fichero o una URL |
wp acui export | Exporta usuarios a un fichero o a la salida estándar |
wp acui columns | Lista las columnas que puedes usar, también las de tus plugins |
wp acui history | Muestra las últimas importaciones y exportaciones |
wp acui cron run | Ejecuta 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.
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.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.
--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. 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 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.
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.
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).
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.
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.
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.
Sí. Elige el sitio con el parámetro --url de WP-CLI y los usuarios se importan en ese sitio.
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.
Mantener el stock sincronizado entre tiendas WooCommerce: una sola tienda, exportar e importar un CSV,…
Qué es PayGold, cómo crear enlaces de pago desde el panel de RedSys, cuánto duran…
Una tienda online y una plataforma de cursos. Una web principal y las de sus…
Si tienes un TPV virtual de Ceca (Cecabank), tarde o temprano vas a necesitar entrar…
En la anterior ... Llegamos a la séptima entrega de este curso. Tras la introducción…
Si vendes con RedSys, es posible que algún cliente te haya enviado una captura con…