Lista completa de comandos WP-CLI explicados

WP-CLI se ha convertido en una herramienta esencial para administradores, desarrolladores y perfiles DevOps que trabajan con WordPress. Si en artículos anteriores ya viste Qué es WP-CLI, sus primeros comandos básicos o cómo gestionar WordPress con WP-CLI, ahora toca ir un paso más allá.

En esta guía reunimos los comandos más útiles organizados por categorías, con explicaciones claras y orientadas a uso real. No se trata de memorizar sintaxis sin contexto, sino de entender qué hace cada comando, cuándo usarlo y qué impacto tiene sobre tu instalación de WordPress.

Cómo pensar la estructura de WP-CLI

Antes de entrar en la lista, conviene recordar que WP-CLI sigue una lógica modular. El patrón general es wp + subcomando + acción + argumentos. Por ejemplo, un comando como wp plugin install pertenece al área de plugins, mientras que wp user list actúa sobre usuarios.

Esta estructura hace que la herramienta sea fácil de ampliar y muy consistente. Si ya aprendiste a instalar y activar plugins con WP-CLI o a cambiar temas, verás que la lógica se repite en casi todos los módulos.

Comandos esenciales para diagnosticar y navegar

wp help

El comando wp help funciona como punto de partida. Muestra ayuda general o específica sobre cualquier subcomando. Es útil cuando necesitas recordar argumentos, opciones o ejemplos sin salir de la terminal.

# Ayuda general
wp help

# Ayuda específica sobre plugins
wp help plugin

# Ayuda específica sobre una acción concreta
wp help plugin install

wp cli version

Este comando muestra la versión instalada de WP-CLI. Es especialmente útil en entornos gestionados o cuando trabajas con scripts, despliegues automáticos o varias máquinas al mismo tiempo.

Si estás trabajando con varias instalaciones, puedes complementar esto con estrategias de gestión múltiple de WordPress con WP-CLI.

Comandos para la instalación y mantenimiento del núcleo

wp core download

Descarga los archivos del núcleo de WordPress en el directorio actual. Suele usarse en instalaciones nuevas o en procesos de recuperación.

wp core install

Instala WordPress indicando parámetros como título del sitio, usuario administrador, contraseña y correo. En artículos anteriores ya viste cómo instalar WordPress desde consola con WP-CLI, así que aquí solo conviene recordar que este comando automatiza el arranque completo de una web.

wp core update

Actualiza el núcleo de WordPress. Es uno de los comandos más relevantes en mantenimiento, y suele formar parte de rutinas que también incluyen plugins y temas. Si quieres ampliar este bloque, puedes revisar cómo actualizar WordPress, plugins y temas con WP-CLI.

wp core version

Devuelve la versión instalada de WordPress. Es útil para auditorías rápidas, soporte técnico y comprobaciones antes de aplicar cambios.

Comandos para plugins

wp plugin list

Lista todos los plugins instalados, incluyendo su estado. Es uno de los comandos más prácticos para obtener una visión rápida del stack de funcionalidad activa en un sitio.

wp plugin install

Instala uno o varios plugins desde el repositorio oficial o desde un archivo ZIP. Puede ejecutarse con o sin activación posterior, según el flujo de trabajo.

wp plugin activate

Activa plugins de forma manual o en lote. En entornos de staging y producción, este comando facilita despliegues más controlados que el panel de administración.

wp plugin deactivate

Desactiva uno o varios plugins. Es muy útil para depuración, auditoría de compatibilidad o limpieza de instalaciones problemáticas.

wp plugin update

Actualiza plugins instalados. Si buscas automatizar seguridad y mantenimiento, este tipo de comando es clave, aunque conviene probar primero en un entorno de pruebas. En ese sentido, también puede interesarte detectar plugins vulnerables con WP-CLI.

Comandos para temas

wp theme list

Muestra los temas instalados y cuál está activo. Sirve para revisar rápidamente el estado del frontend sin entrar al escritorio de WordPress.

wp theme install

Instala un tema desde el repositorio o desde un archivo local. Este comando es muy usado en automatización de despliegues y configuraciones replicables.

wp theme activate

Define el tema activo en el sitio. Es fundamental cuando migras, clonas o preparas entornos nuevos.

wp theme update

Actualiza uno o varios temas. Igual que con plugins, conviene acompañarlo de copias de seguridad y validación posterior.

Comandos para usuarios y roles

wp user list

Lista usuarios registrados y permite filtrar por diferentes campos. Es una herramienta muy útil para auditorías o para localizar cuentas administrativas olvidadas.

wp user create

Crea un usuario nuevo con el rol que indiques. En flujos de onboarding o migración reduce mucho el trabajo manual.

wp user update

Actualiza datos del usuario, como correo, nombre o rol. También puede utilizarse para correcciones urgentes en sitios con varias cuentas editoriales.

wp user delete

Elimina usuarios del sitio. Es especialmente delicado, así que debe usarse con cuidado y, si corresponde, reasignando contenido antes de borrar.

Si quieres profundizar en este bloque, puedes leer también cómo crear y gestionar usuarios con WP-CLI.

Comandos para base de datos y contenido

wp db export

Exporta la base de datos en un archivo SQL. Es uno de los comandos más importantes para backup, migración y recuperación. Ya lo vimos de forma práctica en cómo exportar e importar la base de datos con WP-CLI.

wp db import

Importa un volcado SQL en la base de datos activa. Conviene acompañarlo de una verificación posterior para confirmar que tablas y datos se han cargado correctamente.

wp search-replace

Busca y reemplaza contenido en la base de datos. Se usa mucho para cambiar dominios, rutas o URLs en migraciones. Si este es tu caso, revisa cómo buscar y reemplazar URLs en WordPress con WP-CLI.

wp db optimize

Optimiza tablas de la base de datos. Puede ayudar a mantener la instalación en buen estado, aunque su impacto real depende del tamaño y uso de la web.

Comandos para limpiar, reparar y resetear

wp cache flush

Vacía la caché de WordPress cuando el sitio usa caché interna o complementos compatibles. Suele ser el primer paso tras cambios de contenido o configuración.

wp transient delete –all

Elimina transients almacenados en la base de datos. Es útil cuando necesitas depurar datos temporales o refrescar información cacheada por plugins y temas.

wp db repair

Ejecuta tareas de reparación en la base de datos si están habilitadas. No sustituye un diagnóstico más amplio, pero puede resolver incidencias puntuales.

wp reset

Restablece la instalación de WordPress. Es un comando destructivo y debe reservarse para entornos de pruebas o limpiezas controladas. Si te interesa este escenario, puedes ampliar con cómo resetear WordPress usando WP-CLI.

Comandos para cron y automatización

wp cron event list

Lista los eventos cron programados en WordPress. Es muy útil para comprobar si tareas internas están registradas correctamente.

wp cron event run

Ejecuta un evento concreto o todos los pendientes. Este comando es clave cuando automatizas mantenimiento, actualizaciones o tareas periódicas.

Si estás montando flujos recurrentes, te puede interesar cómo automatizar tareas de WordPress con WP-CLI y cron.

Comandos avanzados que conviene conocer

Además de los más conocidos, WP-CLI incluye comandos orientados a inspección, depuración y operaciones avanzadas. Aquí entran acciones sobre red multisite, configuración, opciones del sitio o incluso ejecución remota según el entorno.

En contextos de mantenimiento profesional, también conviene revisar comandos avanzados de WP-CLI que debes conocer, especialmente si ya gestionas varios proyectos o despliegues repetitivos.

wp option get y wp option update

Estos comandos permiten consultar y modificar opciones almacenadas en la base de datos. Son útiles para ajustes rápidos de configuración sin entrar al panel.

wp config get

Permite leer valores del archivo de configuración de WordPress de forma segura y directa. Es muy práctico para automatización y auditoría técnica.

# Obtener el valor de DB_NAME
wp config get DB_NAME

# Leer una opción del sitio
wp option get siteurl

# Actualizar una opción
wp option update blogdescription "Nuevo eslogan del sitio"

Buenas prácticas al usar la lista completa de comandos wp-cli

La lista de comandos es amplia, pero el verdadero valor está en usarlos con criterio. Antes de ejecutar acciones destructivas, conviene validar el entorno, revisar si trabajas sobre staging o producción y tener un backup reciente. Esto aplica especialmente a operaciones como importaciones, reemplazos masivos y reseteos.

También es recomendable construir rutinas repetibles. WP-CLI no solo ahorra tiempo: reduce errores humanos cuando se usa dentro de scripts, cron jobs o pipelines de despliegue. Por eso sigue siendo una pieza clave en administraciones modernas de WordPress.

Si vas a profundizar en automatización, te serán útiles artículos como cómo usar WP-CLI en scripts bash, despliegues automáticos de WordPress con WP-CLI y cómo ejecutar WP-CLI remotamente por SSH.

Conclusión

Dominar la lista completa de comandos WP-CLI no significa conocer cada opción de memoria, sino saber qué comando usar en cada situación. Desde instalar, actualizar y depurar hasta exportar bases de datos o automatizar tareas, la herramienta cubre buena parte del trabajo operativo de WordPress.

Si ya has leído la guía de instalación, los primeros pasos y los artículos de mantenimiento, este contenido funciona como mapa general para consolidar tu flujo de trabajo. A partir de aquí, el siguiente paso natural es combinar comandos con scripts, aliases y despliegues automatizados.

Fuentes y lecturas recomendadas

Documentación oficial de WP-CLI

Referencia de comandos en Developer Resources de WordPress

Noticias y actualizaciones oficiales de WordPress