Guía para solucionar el error de permalinks en WordPress con cPanel

¡Hola! Soy el soporte técnico de tu hosting. Si estás leyendo esto, probablemente te has encontrado con el temido error permalinks WordPress que provoca páginas 404. No te preocupes, es uno de los problemas más comunes y, con esta guía, lo solucionarás en minutos. Vamos paso a paso, usando cPanel permalinks para restaurar tus enlaces.

[INFO] Este artículo está pensado para usuarios que usan cPanel (o Syspanel) en su hosting. Si tienes dudas sobre qué panel usas, contacta con tu proveedor.

¿Qué es el error de permalinks y por qué aparece?

Cuando configuras WordPress enlaces permanentes en un formato distinto al predeterminado (por ejemplo, «Nombre de la entrada»), el sistema necesita un archivo llamado .htaccess para gestionar las URLs. Si este archivo se corrompe, se elimina o el servidor no tiene los módulos necesarios activos, al hacer clic en cualquier página que no sea la principal, verás un molesto error 404.

Las causas más frecuentes son:

• Actualización de WordPress que sobrescribe configuraciones.
• Cambio de servidor o migración a un nuevo hosting.
• Instalación de un plugin que modifica reglas de reescritura.
• El archivo .htaccess se borra o no tiene permisos correctos.
• El módulo mod_rewrite de Apache está desactivado (esto lo revisa tu hosting).

Solución 1: Restablecer los permalinks desde el escritorio de WordPress (La más sencilla)

Este es el primer paso que siempre debes probar. Muchas veces, el simple hecho de guardar la configuración actualiza las reglas.

1. Accede a tu Escritorio de WordPress.
2. Ve a Ajustes > Enlaces permanentes.
3. Verás varias opciones. No cambies nada de momento.
4. Simplemente, haz clic en el botón Guardar cambios (esté en la opción que esté).
5. WordPress regenerará las reglas del archivo .htaccess.

[TIP] Si esto no funciona, no te frustres. Es solo el primer paso. Continúa con la siguiente solución.

Solución 2: Forzar la regeneración del archivo .htaccess desde cPanel

Si guardar los ajustes no funcionó, el problema suele ser que el archivo .htaccess no existe o está dañado. Vamos a crearlo manualmente usando cPanel permalinks.

Paso 1: Accede al Administrador de Archivos de cPanel

1. Inicia sesión en tu cPanel (normalmente tudominio.com/cpanel o tudominio.com:2083).
   • Si usas Syspanel (HestiaCP): Accede a tudominio.com:2106 y busca la sección de archivos.
2. Dentro de cPanel, busca la sección Archivos y haz clic en Administrador de Archivos.
3. Se abrirá una ventana. Selecciona la carpeta donde está instalado WordPress. Normalmente es public_html (o el nombre de tu dominio si tienes varios). Haz clic en Ir.

Paso 2: Localiza o crea el archivo .htaccess

1. Dentro de la carpeta de tu sitio (ej: public_html), busca un archivo llamado .htaccess.
   • Si lo ves: Haz clic derecho sobre él y selecciona Editar. Luego, en la siguiente ventana, borra todo el contenido y pégalo con el código de más abajo. Guarda los cambios.
   • Si NO lo ves: Es posible que el archivo esté oculto. Busca un botón o ajuste que diga Mostrar archivos ocultos (normalmente un checkbox en la parte superior derecha). Si aun así no aparece, lo crearemos nosotros.

Paso 3: Crear el .htaccess desde cero

Si no aparece ni siquiera mostrando archivos ocultos, créalo manualmente:

1. En el Administrador de Archivos, haz clic en + Archivo (o Nuevo archivo).
2. Nómbralo exactamente como .htaccess (con el punto al inicio). Sin espacios, sin mayúsculas.
3. Ahora, haz clic derecho sobre el archivo recién creado y selecciona Editar.
4. Pega el siguiente código estándar de WordPress:

# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress

5. Haz clic en Guardar cambios y cierra el editor.

Paso 4: Vuelve a guardar los permalinks en WordPress

Regresa a tu escritorio de WordPress y repite el Paso 1 de la Solución 1: ve a Ajustes > Enlaces permanentes y haz clic en Guardar cambios.

[WARNING] Si después de esto sigues viendo el error 404, el problema puede ser del servidor. Sigue leyendo.

Solución 3: Verificar que el módulo mod_rewrite esté activo (Avanzado)

El error de permalinks a veces no es culpa de WordPress, sino del servidor. El módulo mod_rewrite de Apache debe estar activo para que el archivo .htaccess funcione.

Si tienes acceso a cPanel (o Syspanel):

1. Ve a la sección Software > Seleccionar versión de PHP (o MultiPHP Manager).
2. Busca una pestaña que diga Opciones o Extensiones.
3. Asegúrate de que mod_rewrite esté marcado como ON o Activado.
4. Si no lo ves, contacta a tu proveedor de hosting y pídeles que activen mod_rewrite para tu cuenta.

[TIP] En Syspanel (HestiaCP), esta opción puede estar en la sección de Configuración del servidor web o Apache. Si no la encuentras, no te preocupes, es algo que debe hacer tu equipo de soporte.

Solución 4: Comprobar la configuración de Nginx (Si tu hosting usa este servidor)

Algunos hostings modernos usan Nginx en lugar de Apache. En ese caso, el archivo .htaccess no sirve de nada. Aquí la solución es diferente.

1. En cPanel: Busca la sección Software > Nginx Manager o Configuración de Nginx.
2. En Syspanel (HestiaCP): Ve a la sección de Servidores web y busca Nginx Proxy o Nginx Helper. Deberías tener una opción para habilitar las reglas de reescritura de WordPress.
3. Si no ves estas opciones, contacta a tu soporte y diles: «Necesito que activen las reglas de reescritura de WordPress en Nginx para mi dominio».

[INFO] La mayoría de los hostings con Nginx ya tienen configuraciones predeterminadas para WordPress, pero a veces se desactivan.

Solución 5: Desactivar plugins que modifican enlaces

Algunos plugins de caché, seguridad o SEO (como Yoast SEO, Rank Math, W3 Total Cache) pueden crear sus propias reglas en el .htaccess o interferir con las de WordPress.

1. Ve a Plugins > Plugins instalados en tu escritorio de WordPress.
2. Desactiva temporalmente TODOS los plugins (puedes seleccionarlos todos y elegir «Desactivar» en la acción en lote).
3. Vuelve a Ajustes > Enlaces permanentes y guarda los cambios.
4. Si el error desaparece, reactiva los plugins uno por uno y ve guardando los permalinks cada vez. Así sabrás cuál es el culpable.

Solución 6: Revisar la base de datos (Caso extremo)

Si nada funciona, puede haber una corrupción en la tabla de opciones de WordPress. Para esto necesitarás acceso a phpMyAdmin desde cPanel.

1. En cPanel, busca Bases de datos > phpMyAdmin.
2. Selecciona la base de datos de tu WordPress.
3. Busca la tabla wp_options (el prefijo wp_ puede ser diferente, como miwp_options).
4. Localiza la fila donde option_name es rewrite_rules.
5. Bórrala (haz clic en Eliminar).
6. Vuelve a WordPress y guarda los permalinks. La tabla se regenerará automáticamente.

[WARNING] Ten mucho cuidado al borrar datos en la base de datos. Si no estás seguro, mejor pide ayuda a un técnico.

Preguntas Frecuentes (FAQ)

¿Por qué veo un error 404 en todas las páginas excepto en la principal?

Es el síntoma clásico del error permalinks WordPress. El archivo .htaccess no está presente o no tiene las reglas correctas. Sigue la Solución 2.

¿Qué hago si no encuentro el archivo .htaccess en cPanel?

Activa la opción Mostrar archivos ocultos en el Administrador de Archivos. Si aun así no aparece, créalo manualmente con el código que te proporcionamos.

¿El error de permalinks puede afectar al SEO?

Sí, totalmente. Los WordPress enlaces permanentes rotos generan cientos de errores 404, lo que perjudica tu posicionamiento en Google. Solucionarlo es urgente.

¿Cada vez que actualizo WordPress tengo que hacer esto?

No debería. Si ocurre constantemente, puede ser que tu hosting no permita la escritura del archivo .htaccess o que tengas un plugin conflictivo. Revisa los permisos del archivo (debe ser 644 o 604) y considera cambiar de hosting si el problema persiste.

¿Funciona igual en Syspanel (HestiaCP) que en cPanel?

Sí, el proceso es muy similar. La principal diferencia es que en Syspanel el puerto de acceso es el 2106 (ej: tudominio.com:2106) y la interfaz es ligeramente distinta, pero las opciones de archivos y bases de datos son equivalentes.

Conclusión

El error permalinks WordPress que causa páginas 404 es frustrante, pero casi siempre se soluciona con un simple guardado de ajustes o regenerando el archivo .htaccess desde cPanel permalinks. Si has seguido todos los pasos de esta guía y el problema persiste, es muy probable que sea un tema de configuración del servidor. No dudes en contactar a tu proveedor de hosting y mencionarles que necesitas que activen mod_rewrite o las reglas de reescritura de WordPress.

Recuerda, mantener tus enlaces limpios y funcionales es clave para una buena experiencia de usuario y para tu solucionar 404 WordPress de forma definitiva. ¡Espero que te haya servido!