Cuando el actualizador automático del escritorio falla por un error de permisos, un corte de memoria o una pantalla blanca (White Screen of Death), saber cómo actualizar WordPress manualmente por FTP o desde el Administrador de Archivos de cPanel es la forma más segura de recuperar y poner al día tu sitio sin perder ni una sola página, imagen o configuración.
En esta guía técnica paso a paso aprenderás qué carpetas debes reemplazar exactamente (`wp-admin` y `wp-includes`), qué archivos jamás debes borrar (`wp-content` y `wp-config.php`) y cómo resolver el famoso bloqueo de «Temporalmente no disponible por mantenimiento programado».
¿Cuándo es necesario actualizar WordPress manualmente?
Aunque el actualizador de un clic funciona bien en la mayoría de los casos, existen escenarios frecuentes donde la actualización manual es obligatoria:
- Fallo a mitad de una actualización automática: El servidor agotó el `max_execution_time` y dejó los archivos del núcleo incompletos.
- Archivos del core infectados o modificados: Si sufriste un incidente de seguridad (revisa nuestra guía sobre cómo eliminar virus de WordPress), reinstalar el núcleo limpio desde el paquete oficial de WordPress.org es un paso indispensable.
- Sin acceso a `/wp-admin/`: Una incompatibilidad de PHP o de un plugin impide entrar al panel de administración.
- Versiones muy antiguas de WordPress: Saltar desde WordPress 4.x o 5.0 directamente a la última versión suele ser mucho más estable por cPanel o FTP.
Paso 1: Haz una copia de seguridad antes de tocar archivos
Antes de reemplazar cualquier archivo del núcleo, realiza un respaldo completo de:
- La base de datos MySQL/MariaDB (puedes exportarla en
.sqldesde phpMyAdmin en menos de un minuto). - El archivo `wp-config.php` y la carpeta `wp-content/`, que es donde viven tu tema activo, tus plugins, las traducciones y todas las imágenes subidas (`uploads`).
Paso 2: Descarga la última versión limpia de WordPress
- Dirígete a la página oficial de descarga en es.wordpress.org/download/ (o `wordpress.org/download/` si tu instalación está en inglés).
- Descarga el archivo comprimido `.zip` en tu computador y descomprímelo en una carpeta local.
- Dentro de la carpeta descomprimida `wordpress/`, elimina la carpeta `wp-content` (y si existiera un `wp-config.php`, elimínalo también, aunque por defecto solo viene `wp-config-sample.php`). Hacer esto en tu computador evita cualquier riesgo de sobrescribir tus plugins o temas por accidente.
Paso 3: Qué borrar y qué conservar en tu servidor (Regla de Oro)
Conéctate a tu servidor mediante FileZilla (FTP/SFTP) o abre el Administrador de Archivos de cPanel / Hostinger hPanel y entra en el directorio raíz de tu web (generalmente `public_html`). Sigue esta tabla al pie de la letra:
| Archivo o Carpeta en el Servidor | ¿Qué hacer durante la actualización manual? |
|---|---|
wp-admin/ |
Eliminar la carpeta antigua y subir la nueva carpeta wp-admin/ limpia. |
wp-includes/ |
Eliminar la carpeta antigua y subir la nueva carpeta wp-includes/ limpia. |
wp-content/ |
CONSERVAR INTACTA (NO BORRAR). Aquí están tus temas, plugins y fotos. |
wp-config.php |
CONSERVAR INTACTO (NO BORRAR). Contiene la conexión a tu base de datos. |
.htaccess y robots.txt |
CONSERVAR INTACTOS. Contienen tus reglas de enlaces permanentes y SEO. |
Archivos raíz de WP (index.php, wp-login.php, wp-settings.php, etc.) |
Sobrescribir con los archivos nuevos del paquete oficial de WordPress. |
Paso 4: Subir los nuevos archivos por cPanel (Método rápido en 2 minutos)
Subir más de 2.500 archivos uno por uno por FTP puede tardar entre 15 y 30 minutos. Si tienes acceso a cPanel o hPanel, este método tarda menos de 2 minutos:
- En tu computador, dentro de la carpeta `wordpress` descomprimida (después de haber borrado su carpeta `wp-content`), selecciona `wp-admin`, `wp-includes` y todos los archivos `.php` sueltos y comprímelos en un archivo llamado `wp-core-limpio.zip`.
- En el Administrador de Archivos de cPanel, dentro de `public_html`, elimina las carpetas antiguas `wp-admin` y `wp-includes`.
- Sube `wp-core-limpio.zip` a `public_html` y haz clic derecho → Extract (Extraer).
- Elimina el archivo `wp-core-limpio.zip` cuando termine la extracción.
Paso 5: Actualizar la base de datos y limpiar la caché
Una vez reemplazados los archivos, abre tu navegador y entra en `https://tudominio.com/wp-admin/`. Si la nueva versión de WordPress incluye cambios en el esquema de tablas, verás una pantalla que dice «Es necesario actualizar la base de datos de WordPress». Haz clic en Actualizar la base de datos de WordPress y en pocos segundos podrás iniciar sesión con normalidad.
Por último, no olvides borrar el caché de WordPress, Elementor y tu servidor para asegurarte de que los nuevos scripts del panel se carguen sin conflictos.
Solución de errores frecuentes tras actualizar manualmente
1. Quedó bloqueado en «No disponible por mantenimiento programado»
Si tu web muestra ese mensaje, busca en la raíz (`public_html`) un archivo oculto llamado `.maintenance` (activa la opción Mostrar archivos ocultos / dotfiles en cPanel) y elimínalo. Tu web volverá a estar en línea al instante.
2. Error crítico tras actualizar: conflicto con un plugin
Si al actualizar el núcleo un plugin antiguo genera un error fatal de PHP, entra a `wp-content/plugins/` por FTP o cPanel y renombra temporalmente la carpeta del plugin sospechoso (por ejemplo, `plugin-antiguo-off`) para desactivarlo sin necesidad de entrar al escritorio.
¿Tu WordPress sigue dando error o necesitas soporte técnico urgente?
Si tu tienda WooCommerce o sitio corporativo quedó caído durante una actualización, tiene infecciones de malware o necesitas delegar las actualizaciones semanales en manos expertas, revisa nuestro servicio de Mantenimiento y Soporte WordPress en Colombia o contáctanos desde la página principal de DevCristian.