Cómo solucionar el error 'Permalinks no funcionan' en WordPress con cPanel
¿Qué significa exactamente que los "Permalinks no funcionan" en WordPress?
Cuando hablamos de que los permalinks wordpress no funcionan, nos referimos a que las URLs de tu sitio web no se están generando o cargando correctamente. Es un problema muy común que se manifiesta de varias formas:
- Haces clic en una entrada o página y te aparece un error 404 Not Found.
- Entras al panel de administración (wp-admin) pero las páginas internas, como "Ajustes" o "Entradas", te dan error.
- La página de inicio carga, pero cualquier enlace interno te lleva a una página de error o te redirige a la página principal.
- Al cambiar la estructura de enlaces permanentes, la página se queda en blanco o no guarda los cambios.
Este problema es especialmente frecuente después de migrar un sitio, cambiar de hosting, actualizar WordPress o modificar la configuración de los archivos del servidor. Pero no te preocupes, porque tiene solución y en este artículo te voy a explicar paso a paso cómo arreglar permalinks cpanel de una forma sencilla y sin necesidad de ser un experto en programación.
¿Por qué ocurre este error? La importancia del archivo .htaccess
Para entender cómo solucionarlo, primero necesitas saber qué es lo que falla. WordPress utiliza un archivo llamado .htaccess para gestionar las reglas de reescritura de URLs. Este archivo le dice al servidor cómo debe interpretar las direcciones web amigables (como tusitio.com/mi-articulo) y convertirlas en las consultas internas que WordPress entiende.
Cuando este archivo no existe, está corrupto, tiene permisos incorrectos o el módulo de reescritura de Apache (mod_rewrite) no está activo, los enlaces permanentes dejan de funcionar. Por eso, la mayoría de las soluciones pasan por regenerar o reparar este archivo.
¿Qué necesitas para empezar?
- Acceso a tu panel de control de hosting (cPanel, Syspanel o similar).
- Credenciales de acceso a tu cuenta de hosting.
- Acceso al panel de administración de WordPress (wp-admin). Si no puedes acceder, también te explicaré qué hacer.
[INFO] Si tu hosting usa Syspanel (antes conocido como HestiaCP), el acceso se realiza a través del puerto 2106. Por ejemplo:
https://tudominio.com:2106. El proceso es muy similar al de cPanel, pero con una interfaz diferente.
Método 1: La solución más rápida y efectiva desde el panel de WordPress
Este es el primer paso que debes probar, ya que es el más sencillo y en la mayoría de los casos resuelve el problema de inmediato.
Paso 1: Accede a tu panel de administración
Entra a tudominio.com/wp-admin e inicia sesión con tu usuario y contraseña. Si no puedes acceder, salta directamente al Método 2.
Paso 2: Ve a la configuración de enlaces permanentes
En el menú lateral izquierdo, busca la opción Ajustes y haz clic en Enlaces permanentes. Se abrirá una página con varias opciones de estructura de URL.
Paso 3: Guarda los cambios sin modificar nada
No cambies la configuración actual. Simplemente haz clic en el botón Guardar cambios que está al final de la página. WordPress regenerará las reglas del archivo .htaccess y las reescribirá.
Paso 4: Verifica que el problema se haya solucionado
Vuelve a tu sitio web y prueba a navegar por algunas entradas o páginas internas. Si los enlaces ya funcionan, ¡felicidades! Has resuelto el problema en menos de un minuto.
[TIP] Este método funciona porque WordPress "toca" el archivo
.htaccessy lo regenera con las reglas correctas. Es como reiniciar el sistema de enlaces.
Método 2: Regenerar el archivo .htaccess manualmente desde cPanel
Si el método anterior no funcionó o no puedes acceder a wp-admin, tendrás que editar el archivo .htaccess directamente desde el panel de control de tu hosting.
Paso 1: Accede al administrador de archivos
Entra a tu cPanel y busca la sección Archivos. Haz clic en Administrador de archivos. Si usas Syspanel, busca la opción similar, normalmente llamada "Administrador de archivos" o "Gestor de archivos".
Paso 2: Navega hasta la raíz de tu sitio
En el administrador de archivos, busca la carpeta donde está instalado WordPress. Normalmente es la carpeta public_html. Si tienes el sitio en un subdirectorio (como public_html/blog), navega hasta allí.
Paso 3: Localiza el archivo .htaccess
En la raíz de tu instalación de WordPress, busca un archivo llamado .htaccess. Es un archivo oculto, así que puede que necesites activar la opción de "Mostrar archivos ocultos" en la configuración del administrador de archivos.
Paso 4: Edita o crea el archivo
- Si el archivo existe: Haz clic derecho sobre él y selecciona Editar. Si te pide confirmación, acéptala.
- Si el archivo no existe: Haz clic en + Archivo o Nuevo archivo y nómbralo
.htaccess.
Paso 5: Pega el código correcto
En el editor, elimina todo el contenido y pega el siguiente código estándar de WordPress:
# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress
Paso 6: Guarda los cambios
Haz clic en Guardar o Guardar cambios y cierra el editor. Ahora vuelve a tu sitio web y comprueba si los enlaces funcionan.
[WARNING] Asegúrate de no tener espacios en blanco o caracteres extraños antes de
# BEGIN WordPress. Esto podría causar errores adicionales. El archivo debe comenzar exactamente con esa línea.
Método 3: Verificar y corregir los permisos del archivo .htaccess
A veces el archivo .htaccess existe y tiene el contenido correcto, pero los permisos no son los adecuados, lo que impide que el servidor lo lea correctamente.
¿Qué permisos debería tener?
Los permisos correctos para .htaccess suelen ser 644 (lectura y escritura para el propietario, lectura para el grupo y para otros). Si los permisos son demasiado restrictivos (como 600) o demasiado abiertos (como 777), pueden causar problemas.
Cómo cambiarlos desde cPanel
- En el Administrador de archivos, localiza el archivo
.htaccess. - Haz clic derecho sobre él y selecciona Permisos o Cambiar permisos.
- Introduce el valor
644o marca las casillas correspondientes: Lectura y Escritura para el propietario, solo Lectura para grupo y público. - Haz clic en Guardar o Cambiar.
[TIP] Si después de cambiar los permisos sigues teniendo problemas, prueba con
664en algunos servidores. Pero en la mayoría de los casos,644es lo correcto.
Método 4: Activar el módulo mod_rewrite de Apache
En algunos servidores, especialmente en configuraciones de VPS o servidores dedicados, el módulo mod_rewrite de Apache puede estar desactivado. Sin él, WordPress no puede reescribir las URLs.
Si usas cPanel
Normalmente, mod_rewrite está activado por defecto en cPanel. Pero si no es así, puedes intentar lo siguiente:
- Ve a la sección Software y busca Seleccionar versión de PHP o MultiPHP Manager.
- No es aquí donde se activa directamente, pero a veces cambiar la versión de PHP puede resolver el problema.
Si usas Syspanel (HestiaCP)
En Syspanel, puedes verificar la configuración de Apache en la sección de Servicios Web. Asegúrate de que Apache está corriendo y que el módulo de reescritura está habilitado.
[INFO] Si no te sientes cómodo tocando esta configuración, contacta con tu proveedor de hosting y pídeles que verifiquen que
mod_rewriteestá activo. Es una tarea sencilla para ellos.
Método 5: Reinstalar WordPress (solo si todo lo demás falla)
Si has probado todos los métodos anteriores y aún así los enlaces permanentes wordpress no funcionan, puede haber un problema más profundo en la instalación. En este caso, una reinstalación limpia puede ser la solución.
Paso 1: Haz una copia de seguridad
Antes de hacer cualquier cosa, asegúrate de tener una copia de seguridad completa de tu sitio (archivos y base de datos). Puedes usar plugins como UpdraftPlus o hacerlo manualmente desde cPanel.
Paso 2: Descarga una copia nueva de WordPress
Ve a es.wordpress.org y descarga la última versión de WordPress en tu ordenador.
Paso 3: Sube los archivos nuevos
Descomprime el archivo descargado y sube el contenido de la carpeta wordpress a tu servidor, sobrescribiendo los archivos existentes. No borres la carpeta wp-content para no perder tus medios y plugins.
Paso 4: Actualiza la base de datos
Ve a tudominio.com/wp-admin y WordPress te pedirá que actualices la base de datos. Sigue las instrucciones y listo.
Preguntas frecuentes (FAQ) sobre permalinks de WordPress
¿Por qué mis enlaces permanentes dejan de funcionar después de migrar el sitio?
Las migraciones suelen cambiar la estructura de directorios o el servidor, y el archivo .htaccess puede no haberse transferido correctamente o tener rutas antiguas. Regenerar los enlaces permanentes desde wp-admin suele solucionarlo.
¿Qué es el archivo .htaccess y por qué es tan importante?
Es un archivo de configuración del servidor Apache que controla cómo se comporta el servidor en el directorio donde está. Para WordPress, es esencial para las URLs amigables.
¿Puedo usar "enlaces permanentes wordpress" con estructuras personalizadas?
Sí, WordPress te permite crear estructuras personalizadas, como /%category%/%postname%/. Pero asegúrate de que el servidor soporte mod_rewrite.
¿Qué hago si no puedo acceder a wp-admin?
Si no puedes acceder al panel de administración, usa el Método 2 para editar el .htaccess directamente desde cPanel o Syspanel. También puedes acceder por FTP con un programa como FileZilla.
¿Los plugins de caché pueden causar este problema?
Sí, a veces los plugins de caché guardan una versión "vieja" de las URLs. Si después de arreglar los permalinks sigues viendo errores, limpia la caché del plugin y la del navegador.
Consejos finales para evitar que esto vuelva a ocurrir
- Haz copias de seguridad periódicas de tu sitio, especialmente antes de hacer cambios importantes.
- No edites el archivo
.htaccesssin saber lo que estás haciendo, y siempre guarda una copia del original. - Mantén WordPress, los temas y los plugins actualizados para evitar conflictos.
- Si usas un plugin de caché, asegúrate de configurarlo correctamente y de limpiar la caché después de cambios en la estructura de URLs.
- Si cambias de hosting, verifica que el nuevo servidor tiene
mod_rewriteactivado y que los archivos se transfieren correctamente.
Conclusión
El error de permalinks wordpress no funcionan es uno de los más comunes, pero también uno de los más fáciles de solucionar si sigues los pasos adecuados. La mayoría de las veces, un simple "Guardar cambios" en la configuración de enlaces permanentes resuelve el problema. Si no, editar o regenerar el archivo .htaccess desde cPanel o Syspanel es la solución definitiva.
Recuerda que siempre debes trabajar con calma, hacer copias de seguridad y, si te sientes perdido, no dudar en contactar con el soporte técnico de tu hosting. Ellos están para ayudarte y tienen acceso a herramientas que tú no ves.
Espero que esta guía te haya sido de gran ayuda. Si has seguido todos los pasos y aún tienes problemas, déjame un comentario y estaré encantado de ayudarte a encontrar una solución personalizada. ¡Buena suerte con tu sitio web!
