{"id":6719,"date":"2024-05-02T13:47:24","date_gmt":"2024-05-02T11:47:24","guid":{"rendered":"https:\/\/www.nicalia.com\/nicapedia\/guias\/wordpress\/configuracion-de-wordpress\/modificar-la-ruta-de-subida-de-los-archivos-multimedia-en-wordpress\/"},"modified":"2026-06-12T10:13:11","modified_gmt":"2026-06-12T08:13:11","slug":"modificar-la-ruta-de-subida-de-los-archivos-multimedia-en-wordpress","status":"publish","type":"docs","link":"https:\/\/www.nicalia.com\/nicapedia\/modificar-la-ruta-de-subida-de-los-archivos-multimedia-en-wordpress\/","title":{"rendered":"Modificar la ruta de subida de los archivos multimedia en WordPress"},"content":{"rendered":"<p>A veces es necesario modificar la ruta donde WordPress sube sus archivos debido a movimientos o migraciones. En caso contrario, los usuarios no pueden subir archivos multimedia a WordPress.<\/p>\n<p>El s\u00edntoma m\u00e1s habitual es este error al intentar subir una imagen:<\/p>\n<pre><code>Ha habido un error al subir \u00abIMG-20190918-WA0004.jpg\u00bb\nUnable to create directory uploads\/2019\/09. Is its parent directory writable by the server?<\/code><\/pre>\n<p>Este error significa que la ruta de subida configurada en WordPress no existe en el servidor, no es accesible o contiene una ruta absoluta incorrecta (por ejemplo, una ruta del servidor anterior tras una migraci\u00f3n).<\/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: ENCONTRAR LA RUTA CORRECTA\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>C\u00f3mo encontrar la ruta correcta en Nicalia<\/h2>\n<p>Antes de modificar la ruta, necesitas saber cu\u00e1l es la ruta absoluta correcta de tu <code>public_html<\/code> en el servidor de Nicalia. Hay dos formas r\u00e1pidas:<\/p>\n<h3>Desde cPanel \u2014 Informaci\u00f3n del servidor<\/h3>\n<p>En cPanel, busca la secci\u00f3n <strong>\u00abInformaci\u00f3n del servidor\u00bb<\/strong> (en el panel lateral derecho). Ver\u00e1s el <strong>\u00abDirectorio ra\u00edz\u00bb<\/strong> de tu cuenta, que tiene un formato similar a <code>\/home\/usuario\/<\/code>. La ruta de uploads ser\u00eda <code>\/home\/usuario\/public_html\/wp-content\/uploads<\/code>.<\/p>\n<h3>Desde el Administrador de Archivos<\/h3>\n<p>Abre el <a href=\"https:\/\/www.nicalia.com\/nicapedia\/acceder-al-administrador-de-archivos\/\">Administrador de Archivos de cPanel<\/a>, navega a <code>public_html\/wp-content\/uploads<\/code> y copia la ruta que aparece en la barra de navegaci\u00f3n. Esa es la ruta absoluta correcta.<\/p>\n<h3>Desde SSH<\/h3>\n<p>Conecta por SSH, navega a <code>public_html\/wp-content\/uploads<\/code> y ejecuta <code>pwd<\/code>. La salida te dar\u00e1 la ruta absoluta completa.<\/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: M\u00c9TODO 1 \u2014 AJUSTES MEDIOS\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>M\u00e9todo 1 \u2014 Cambiar la ruta desde Ajustes \u2192 Medios en wp-admin<\/h2>\n<p>Este es el m\u00e9todo m\u00e1s sencillo si tienes acceso al panel de administraci\u00f3n de WordPress.<\/p>\n<ol>\n<li>Accede a <strong>wp-admin<\/strong>.<\/li>\n<li>Ve a <strong>Ajustes \u2192 Medios<\/strong>.<\/li>\n<li>En el apartado <strong>\u00abSubida de archivos\u00bb<\/strong>, localiza el campo <strong>\u00abGuardar los archivos subidos en esta carpeta\u00bb<\/strong>.<\/li>\n<li>Introduce la ruta correcta. Por ejemplo, en los servidores de Nicalia:<\/li>\n<\/ol>\n<pre><code>\/home2\/usuario\/public_html\/wp-content\/uploads<\/code><\/pre>\n<p>Sustituye <code>usuario<\/code> por el nombre de usuario de tu cuenta de cPanel, y <code>home2<\/code> por <code>home<\/code> seg\u00fan la configuraci\u00f3n de tu servidor (puedes comprobarlo con el m\u00e9todo de SSH descrito arriba).<\/p>\n<ol start=\"5\">\n<li>Haz clic en <strong>\u00abGuardar cambios\u00bb<\/strong>.<\/li>\n<\/ol>\n<p>\u2139\ufe0f Este cambio no modificar\u00e1 la ruta de los archivos ya subidos \u2014 solo afecta a las nuevas subidas a partir de ese momento. Las im\u00e1genes existentes seguir\u00e1n en su ruta original.<\/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: M\u00c9TODO 2 \u2014 WP-CONFIG.PHP\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>M\u00e9todo 2 \u2014 Cambiar la ruta mediante wp-config.php<\/h2>\n<p>Si no dispones de acceso a wp-admin, puedes configurar la ruta de subida directamente en el archivo <strong>wp-config.php<\/strong>. Consulta la gu\u00eda <a href=\"https:\/\/www.nicalia.com\/nicapedia\/modificar-archivo-de-configuracion-de-wordpress\/\">c\u00f3mo editar wp-config.php<\/a> si necesitas acceder a \u00e9l.<\/p>\n<p>Para cambiar la carpeta de uploads (por ejemplo, de <code>wp-content\/uploads<\/code> a <code>wp-content\/media<\/code>), a\u00f1ade la siguiente l\u00ednea en <code>wp-config.php<\/code> <strong>antes<\/strong> de <code>\/* That's all, stop editing! *\/<\/code>:<\/p>\n<pre><code>define( 'UPLOADS', 'wp-content\/'.'media' );<\/code><\/pre>\n<p>Si el directorio de destino no existe todav\u00eda, a\u00f1ade tambi\u00e9n la siguiente l\u00ednea para que WordPress lo cree autom\u00e1ticamente:<\/p>\n<pre><code>require_once(ABSPATH.'wp-settings.php');<\/code><\/pre>\n<p>\u2139\ufe0f Al igual que en el M\u00e9todo 1, este cambio no modificar\u00e1 la ruta de los archivos ya subidos \u2014 solo afecta a las nuevas subidas.<\/p>\n<p>\u2139\ufe0f La constante <code>UPLOADS<\/code> acepta rutas relativas a la carpeta ra\u00edz de WordPress, no rutas absolutas del servidor. Si quieres usar una ruta absoluta, usa la constante <code>UPLOADS<\/code> combinada con <code>WP_CONTENT_DIR<\/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: M\u00c9TODO 3 \u2014 WP-CLI\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>M\u00e9todo 3 \u2014 Cambiar la ruta con WP-CLI<\/h2>\n<p>Si tienes acceso SSH, puedes actualizar la opci\u00f3n directamente desde la terminal con WP-CLI:<\/p>\n<pre><code>wp option update upload_path '\/home\/usuario\/public_html\/wp-content\/uploads'<\/code><\/pre>\n<p>Para verificar el valor actual antes y despu\u00e9s del cambio:<\/p>\n<pre><code>wp option get upload_path<\/code><\/pre>\n<p>Este m\u00e9todo es equivalente al M\u00e9todo 1 (modifica la misma opci\u00f3n de la base de datos que se configura desde <em>Ajustes \u2192 Medios<\/em>) pero sin necesidad de acceder al panel de administraci\u00f3n.<\/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: 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 al modificar la ruta de uploads<\/h2>\n<h3>El error persiste despu\u00e9s de cambiar la ruta<\/h3>\n<p>Verifica que la carpeta <code>wp-content\/uploads<\/code> existe f\u00edsicamente en el servidor y tiene permisos de escritura. Los permisos correctos son <code>755<\/code> para la carpeta. Desde el Administrador de Archivos de cPanel, haz clic derecho sobre la carpeta <code>uploads<\/code> \u2192 <strong>Change Permissions<\/strong> y verifica que el propietario tiene permisos de escritura.<\/p>\n<h3>La ruta introducida en Ajustes \u2192 Medios no se guarda o vuelve a vac\u00edo<\/h3>\n<p>Si el campo \u00abGuardar los archivos subidos en esta carpeta\u00bb est\u00e1 vac\u00edo, WordPress usa la ruta por defecto (<code>wp-content\/uploads<\/code>). Si introduces una ruta y se borra al guardar, puede ser que un plugin est\u00e9 sobrescribiendo el valor. Tambi\u00e9n puede ocurrir que la constante <code>UPLOADS<\/code> en <code>wp-config.php<\/code> est\u00e9 sobreescribiendo la configuraci\u00f3n de Ajustes \u2192 Medios \u2014 en ese caso el campo de Ajustes queda bloqueado por la constante.<\/p>\n<h3>Las im\u00e1genes antiguas muestran error 404 despu\u00e9s de cambiar la ruta<\/h3>\n<p>Las im\u00e1genes antiguas siguen apuntando a la ruta anterior en la base de datos. Cambiar la ruta de subida solo afecta a los nuevos archivos. Para actualizar las URLs de las im\u00e1genes existentes usa un plugin como <strong>Better Search Replace<\/strong> o el comando WP-CLI: <code>wp search-replace '\/ruta-antigua\/uploads' '\/ruta-nueva\/uploads'<\/code>.<\/p>\n<h3>\u00abUnable to create directory\u00bb sigue apareciendo aunque la ruta sea correcta<\/h3>\n<p>El servidor web no tiene permisos para escribir en esa carpeta. Verifica que el usuario del servidor web (normalmente <code>nobody<\/code> o el usuario de PHP-FPM) tiene permisos de escritura sobre la carpeta <code>uploads<\/code>. En los servidores de Nicalia con PHP-FPM, los permisos de carpeta <code>755<\/code> con propietario del usuario de cPanel son suficientes.<\/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>\u00bfQu\u00e9 significa el error \u00abUnable to create directory uploads\u00bb en WordPress?<\/h3>\n<p>Significa que WordPress no puede crear la carpeta de destino para las subidas porque la ruta configurada no existe en el servidor, no tiene permisos de escritura, o contiene una ruta absoluta incorrecta (frecuente tras migraciones de hosting). La soluci\u00f3n es corregir la ruta desde <em>Ajustes \u2192 Medios<\/em> o en <code>wp-config.php<\/code>.<\/p>\n<h3>\u00bfCu\u00e1l es la ruta de uploads correcta en los servidores de Nicalia?<\/h3>\n<p>El formato habitual es <code>\/home\/usuario\/public_html\/wp-content\/uploads<\/code> (o <code>\/home2\/usuario\/...<\/code> dependiendo del servidor). Puedes verlo exactamente desde <em>cPanel \u2192 Informaci\u00f3n del servidor \u2192 Directorio ra\u00edz<\/em>, o ejecutando <code>pwd<\/code> desde SSH dentro de la carpeta <code>uploads<\/code>.<\/p>\n<h3>\u00bfSi cambio la ruta de uploads se pierden las im\u00e1genes existentes?<\/h3>\n<p>No se pierden \u2014 los archivos siguen en el servidor. Sin embargo, los registros de la base de datos siguen apuntando a la ruta anterior, por lo que las im\u00e1genes mostrar\u00e1n error 404 en el frontend. Para actualizar las URLs usa Better Search Replace o el comando WP-CLI <code>wp search-replace<\/code>.<\/p>\n<h3>\u00bfCu\u00e1l es la diferencia entre cambiar la ruta desde Ajustes \u2192 Medios y con la constante UPLOADS?<\/h3>\n<p><em>Ajustes \u2192 Medios<\/em> guarda el valor en la base de datos (opci\u00f3n <code>upload_path<\/code>). La constante <code>UPLOADS<\/code> en <code>wp-config.php<\/code> sobreescribe ese valor a nivel de c\u00f3digo y tiene prioridad sobre lo configurado en Ajustes. Si defines <code>UPLOADS<\/code> en <code>wp-config.php<\/code>, el campo de <em>Ajustes \u2192 Medios<\/em> queda bloqueado y no se puede modificar desde wp-admin.<\/p>\n<h3>\u00bfSe puede dejar el campo de ruta vac\u00edo en Ajustes \u2192 Medios?<\/h3>\n<p>S\u00ed. Si el campo est\u00e1 vac\u00edo, WordPress usa la ruta por defecto: <code>wp-content\/uploads<\/code> dentro de la ra\u00edz de WordPress. Es la configuraci\u00f3n correcta para la mayor\u00eda de instalaciones que no han sido migradas ni movidas.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>A veces es necesario modificar la ruta donde WordPress sube sus archivos debido a movimientos o migraciones. En caso contrario, los usuarios no pueden subir archivos multimedia a WordPress. El s\u00edntoma m\u00e1s habitual es este error al intentar subir una imagen: Ha habido un error al subir \u00abIMG-20190918-WA0004.jpg\u00bb Unable to create directory uploads\/2019\/09. Is its [&hellip;]<\/p>\n","protected":false},"author":4,"featured_media":0,"parent":6705,"menu_order":6,"comment_status":"open","ping_status":"closed","template":"","doc_tag":[],"doc_badge":[],"class_list":["post-6719","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\/6719","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=6719"}],"version-history":[{"count":7,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/docs\/6719\/revisions"}],"predecessor-version":[{"id":10137,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/docs\/6719\/revisions\/10137"}],"up":[{"embeddable":true,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/docs\/6705"}],"wp:attachment":[{"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/media?parent=6719"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/doc_tag?post=6719"},{"taxonomy":"doc_badge","embeddable":true,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/doc_badge?post=6719"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}