{"id":6741,"date":"2024-05-02T18:14:52","date_gmt":"2024-05-02T16:14:52","guid":{"rendered":"https:\/\/www.nicalia.com\/nicapedia\/guias\/wordpress\/configuracion-de-wordpress\/wp-cli\/anadir-un-usuario-con-wp-cli\/"},"modified":"2026-06-11T16:18:06","modified_gmt":"2026-06-11T14:18:06","slug":"anadir-un-usuario-con-wp-cli","status":"publish","type":"docs","link":"https:\/\/www.nicalia.com\/nicapedia\/anadir-un-usuario-con-wp-cli\/","title":{"rendered":"A\u00f1adir un usuario en WordPress con WP-CLI: gu\u00eda"},"content":{"rendered":"<p>Con <strong>WP-CLI<\/strong> puedes crear, listar, actualizar y eliminar usuarios de WordPress directamente desde la terminal, sin necesidad de entrar al panel de administraci\u00f3n. Es especialmente \u00fatil durante migraciones, en scripts de automatizaci\u00f3n o cuando necesitas crear un usuario de emergencia sin acceso a wp-admin.<\/p>\n<p>Para usar WP-CLI necesitas acceso SSH al servidor. Consulta la gu\u00eda <a href=\"https:\/\/www.nicalia.com\/nicapedia\/acceder-mediante-ssh-a-un-usuario\/\">c\u00f3mo acceder por SSH a tu hosting de Nicalia<\/a>.<\/p>\n<p><!-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n     H2: REFERENCIA R\u00c1PIDA\n     \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550 --><\/p>\n<h2>Referencia r\u00e1pida de comandos<\/h2>\n<table>\n<thead>\n<tr>\n<th>Operaci\u00f3n<\/th>\n<th>Comando<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Crear usuario (contrase\u00f1a autom\u00e1tica)<\/td>\n<td><code>wp user create usuario email@dominio.com --role=administrator<\/code><\/td>\n<\/tr>\n<tr>\n<td>Crear usuario (contrase\u00f1a personalizada)<\/td>\n<td><code>wp user create usuario email@dominio.com --role=administrator --user_pass=contrase\u00f1a<\/code><\/td>\n<\/tr>\n<tr>\n<td>Listar todos los usuarios<\/td>\n<td><code>wp user list<\/code><\/td>\n<\/tr>\n<tr>\n<td>Actualizar contrase\u00f1a<\/td>\n<td><code>wp user update ID --user_pass=nuevacontrase\u00f1a<\/code><\/td>\n<\/tr>\n<tr>\n<td>Cambiar rol de un usuario<\/td>\n<td><code>wp user set-role ID nuevo-rol<\/code><\/td>\n<\/tr>\n<tr>\n<td>Eliminar usuario<\/td>\n<td><code>wp user delete ID<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p><!-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n     H2: CREAR USUARIO\n     \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550 --><\/p>\n<h2>Crear un usuario con WP-CLI<\/h2>\n<h3>Con contrase\u00f1a generada autom\u00e1ticamente<\/h3>\n<p>Ejecuta el siguiente comando para crear un usuario con rol de administrador. WordPress generar\u00e1 una contrase\u00f1a segura autom\u00e1ticamente:<\/p>\n<pre><code>wp user create USUARIO tutorial@nicalia.com --role=administrator<\/code><\/pre>\n<p>Si todo va bien, recibir\u00e1s un mensaje como este:<\/p>\n<pre><code>Success: Created user 2.\nPassword: 0S4FBioDxU<\/code><\/pre>\n<p>\u2139\ufe0f Anota la contrase\u00f1a generada \u2014 WordPress no la enviar\u00e1 por email cuando se usa WP-CLI. Si no la guardas, tendr\u00e1s que cambiarla despu\u00e9s con <code>wp user update<\/code>.<\/p>\n<h3>Con contrase\u00f1a personalizada<\/h3>\n<p>Si prefieres asignar t\u00fa la contrase\u00f1a desde el inicio, a\u00f1ade la opci\u00f3n <code>--user_pass=<\/code> al comando:<\/p>\n<pre><code>wp user create USUARIO tutorial@nicalia.com --role=administrator --user_pass=TuContrase\u00f1a<\/code><\/pre>\n<p>Con esto el nuevo usuario quedar\u00e1 creado con la contrase\u00f1a que indiques.<\/p>\n<h3>Opciones adicionales del comando wp user create<\/h3>\n<p>El comando admite varios par\u00e1metros opcionales \u00fatiles:<\/p>\n<pre><code>wp user create USUARIO email@dominio.com \\\n  --role=editor \\\n  --user_pass=MiContrase\u00f1a \\\n  --first_name=Nombre \\\n  --last_name=Apellido \\\n  --display_name=\"Nombre Apellido\" \\\n  --send-email<\/code><\/pre>\n<ul>\n<li><code>--first_name<\/code> y <code>--last_name<\/code>: nombre y apellido del usuario.<\/li>\n<li><code>--display_name<\/code>: nombre que aparece en el sitio.<\/li>\n<li><code>--send-email<\/code>: env\u00eda un email de bienvenida al nuevo usuario con sus credenciales.<\/li>\n<\/ul>\n<p><!-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n     H2: ROLES DISPONIBLES\n     \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550 --><\/p>\n<h2>Roles disponibles en WordPress<\/h2>\n<table>\n<thead>\n<tr>\n<th>Rol<\/th>\n<th>Valor en WP-CLI<\/th>\n<th>Permisos<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Administrador<\/td>\n<td><code>administrator<\/code><\/td>\n<td>Acceso completo al sitio \u2014 gesti\u00f3n de usuarios, plugins, temas y configuraci\u00f3n.<\/td>\n<\/tr>\n<tr>\n<td>Editor<\/td>\n<td><code>editor<\/code><\/td>\n<td>Puede publicar y gestionar entradas y p\u00e1ginas propias y de otros usuarios.<\/td>\n<\/tr>\n<tr>\n<td>Autor<\/td>\n<td><code>author<\/code><\/td>\n<td>Puede publicar y gestionar sus propias entradas.<\/td>\n<\/tr>\n<tr>\n<td>Colaborador<\/td>\n<td><code>contributor<\/code><\/td>\n<td>Puede escribir y editar sus propias entradas, pero no publicarlas.<\/td>\n<\/tr>\n<tr>\n<td>Suscriptor<\/td>\n<td><code>subscriber<\/code><\/td>\n<td>Solo puede gestionar su propio perfil.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p><!-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n     H2: OTROS COMANDOS \u00daTILES\n     \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550 --><\/p>\n<h2>Otros comandos \u00fatiles para gestionar usuarios<\/h2>\n<h3>Listar todos los usuarios<\/h3>\n<pre><code>wp user list<\/code><\/pre>\n<p>Para ver solo administradores:<\/p>\n<pre><code>wp user list --role=administrator<\/code><\/pre>\n<h3>Actualizar la contrase\u00f1a de un usuario<\/h3>\n<pre><code>wp user update 1 --user_pass='nueva_contrase\u00f1a'<\/code><\/pre>\n<p>Sustituye <code>1<\/code> por el ID del usuario. Puedes ver los IDs con <code>wp user list<\/code>.<\/p>\n<h3>Cambiar el rol de un usuario<\/h3>\n<pre><code>wp user set-role 2 editor<\/code><\/pre>\n<h3>Eliminar un usuario<\/h3>\n<pre><code>wp user delete 2<\/code><\/pre>\n<p>Para reasignar el contenido del usuario eliminado a otro usuario:<\/p>\n<pre><code>wp user delete 2 --reassign=1<\/code><\/pre>\n<p><!-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n     H2: ERRORES COMUNES\n     \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550 --><\/p>\n<h2>Errores frecuentes<\/h2>\n<h3>\u00abError: This does not appear to be a WordPress installation\u00bb<\/h3>\n<p>El directorio desde el que ejecutas el comando no es la ra\u00edz de WordPress. Navega con <code>cd<\/code> a la carpeta ra\u00edz (normalmente <code>public_html<\/code>) o usa el par\u00e1metro <code>--path<\/code>: <code>wp user create usuario email@dominio.com --role=administrator --path=\/home\/usuario\/public_html<\/code>.<\/p>\n<h3>\u00abError: Sorry, that username already exists\u00bb<\/h3>\n<p>El nombre de usuario ya existe en WordPress. Elige un nombre diferente o usa <code>wp user list<\/code> para ver los usuarios existentes antes de crear uno nuevo.<\/p>\n<h3>\u00abError: The email address is already registered\u00bb<\/h3>\n<p>El email ya est\u00e1 asociado a otro usuario de WordPress. Cada usuario debe tener un email \u00fanico. Si necesitas restablecer el acceso a esa cuenta, usa <code>wp user update<\/code> para cambiar la contrase\u00f1a en lugar de crear un nuevo usuario.<\/p>\n<h3>El usuario se crea pero no puede acceder a wp-admin<\/h3>\n<p>Verifica que el rol asignado es correcto. Un usuario con rol <code>subscriber<\/code> puede autenticarse pero no tiene acceso al panel de administraci\u00f3n. Para acceso completo usa <code>--role=administrator<\/code>. Tambi\u00e9n verifica que la contrase\u00f1a no contiene caracteres especiales que hayan sido interpretados por el shell \u2014 envu\u00e9lvela entre comillas simples: <code>--user_pass='MiContrase\u00f1a123!'<\/code><\/p>\n<p><!-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n     H2: FAQ\n     \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550 --><\/p>\n<h2>Preguntas frecuentes<\/h2>\n<h3>\u00bfC\u00f3mo crear un usuario administrador en WordPress con WP-CLI?<\/h3>\n<p>Ejecuta: <code>wp user create nombre_usuario email@dominio.com --role=administrator<\/code>. Si quieres asignar la contrase\u00f1a directamente: <code>wp user create nombre_usuario email@dominio.com --role=administrator --user_pass=TuContrase\u00f1a<\/code>.<\/p>\n<h3>\u00bfPara qu\u00e9 sirve crear un usuario con WP-CLI en lugar de hacerlo desde wp-admin?<\/h3>\n<p>Es \u00fatil cuando no tienes acceso a wp-admin (lo perdiste, hay un error en el sitio, o simplemente est\u00e1s automatizando el proceso). Tambi\u00e9n es m\u00e1s r\u00e1pido para crear m\u00faltiples usuarios en scripts de aprovisionamiento o despliegue.<\/p>\n<h3>\u00bfC\u00f3mo ver todos los usuarios de WordPress con WP-CLI?<\/h3>\n<p>Ejecuta <code>wp user list<\/code> para ver todos los usuarios con su ID, nombre, email y rol. Para filtrar por rol: <code>wp user list --role=administrator<\/code>.<\/p>\n<h3>\u00bfPuedo cambiar la contrase\u00f1a de un usuario de WordPress con WP-CLI?<\/h3>\n<p>S\u00ed. Usa <code>wp user update ID --user_pass='nueva_contrase\u00f1a'<\/code> sustituyendo ID por el n\u00famero de usuario (obtenido con <code>wp user list<\/code>).<\/p>\n<h3>\u00bfCu\u00e1les son los roles disponibles al crear un usuario con WP-CLI?<\/h3>\n<p>Los roles est\u00e1ndar de WordPress son: <code>administrator<\/code>, <code>editor<\/code>, <code>author<\/code>, <code>contributor<\/code> y <code>subscriber<\/code>. Algunos plugins a\u00f1aden roles personalizados adicionales. Consulta la <a href=\"https:\/\/www.nicalia.com\/nicapedia\/anadir-un-usuario-a-wordpress\/\">gu\u00eda para a\u00f1adir un usuario en WordPress desde wp-admin<\/a> para m\u00e1s detalles sobre los permisos de cada rol.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Con WP-CLI puedes crear, listar, actualizar y eliminar usuarios de WordPress directamente desde la terminal, sin necesidad de entrar al panel de administraci\u00f3n. Es especialmente \u00fatil durante migraciones, en scripts de automatizaci\u00f3n o cuando necesitas crear un usuario de emergencia sin acceso a wp-admin. Para usar WP-CLI necesitas acceso SSH al servidor. Consulta la gu\u00eda [&hellip;]<\/p>\n","protected":false},"author":4,"featured_media":0,"parent":6730,"menu_order":10,"comment_status":"open","ping_status":"closed","template":"","doc_tag":[],"doc_badge":[],"class_list":["post-6741","docs","type-docs","status-publish","hentry","no-post-thumbnail"],"acf":[],"author_avatar":"https:\/\/secure.gravatar.com\/avatar\/4471485c4e49f46218d6b6d125f80f4cde1f86f045fd896202eefddaf4d4510a?s=96&d=mm&r=g","author_name":"Francisco Garvi","_links":{"self":[{"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/docs\/6741","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/comments?post=6741"}],"version-history":[{"count":5,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/docs\/6741\/revisions"}],"predecessor-version":[{"id":10125,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/docs\/6741\/revisions\/10125"}],"up":[{"embeddable":true,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/docs\/6730"}],"wp:attachment":[{"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/media?parent=6741"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/doc_tag?post=6741"},{"taxonomy":"doc_badge","embeddable":true,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/doc_badge?post=6741"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}