El archivo .htaccess permite aplicar configuraciones de Apache a una carpeta y sus subcarpetas. En WordPress se utiliza principalmente para que los enlaces permanentes funcionen sin mostrar index.php en cada URL. Un archivo dañado, una regla incompatible o una modificación accidental pueden causar errores 404, redirecciones inesperadas, bucles o errores 500.
Esta guía explica cómo restaurar el bloque estándar de una instalación individual de WordPress sin borrar configuraciones personalizadas importantes. No todos los servidores utilizan Apache ni procesan archivos .htaccess: en Nginx las reglas se configuran a nivel del servidor y este archivo normalmente no tiene efecto.
Cuándo conviene revisar .htaccess
El archivo puede estar relacionado con el problema si:
- la portada abre, pero entradas y páginas muestran error 404;
- el sitio devuelve un error 500 después de agregar una regla;
- aparece un bucle de redirecciones tras configurar HTTPS o cambiar el dominio;
- un plugin de caché o seguridad modificó el archivo;
- los enlaces permanentes dejaron de funcionar después de una migración.
No todos los errores 404 o 500 provienen de .htaccess. Antes de reemplazarlo, anotá cuándo comenzó la falla y qué cambio se realizó inmediatamente antes.
Antes de modificar .htaccess
- Descargá una copia desde el Administrador de archivos de cPanel.
- Generá un backup si el sitio es importante.
- Revisá reglas agregadas por caché, seguridad, redirecciones, SSL, CDN o aplicaciones propias.
- No copies bloques de Internet sin confirmar el servidor y la ubicación del sitio.
- Trabajá sobre una sola modificación por vez para poder revertirla.
El archivo comienza con un punto y suele estar oculto. En cPanel activá Mostrar archivos ocultos. La ubicación habitual es public_html/.htaccess, aunque un dominio adicional, un subdominio o WordPress instalado en una carpeta tendrá su archivo en la raíz correspondiente.
Confirmá la instalación buscando wp-config.php, wp-admin, wp-content y wp-includes. No reemplaces el .htaccess de otra aplicación alojada en la misma cuenta.
Reglas predeterminadas de WordPress
Para una instalación individual ubicada en la raíz del dominio, el bloque administrado por WordPress es:
# 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 WordPressEstas reglas envían a WordPress las solicitudes que no corresponden a un archivo o directorio real. Las condiciones !-f y !-d evitan que imágenes, hojas de estilo y otros archivos existentes sean procesados como páginas.
No agregues reglas propias dentro de # BEGIN WordPress y # END WordPress. WordPress o un plugin puede regenerar ese bloque y eliminar cualquier instrucción que no le pertenezca.
Método recomendado: regenerar desde WordPress
Si todavía podés ingresar al escritorio, abrí Ajustes > Enlaces permanentes. La visita a esa pantalla fuerza la regeneración de las reglas internas; al guardar, WordPress intentará escribir su bloque en .htaccess cuando los permisos lo permitan.
No cambies la estructura de enlaces solamente para regenerar reglas. Modificarla puede alterar las URLs públicas y provocar errores 404 o pérdida de señales SEO. Conservá la opción existente y verificá el mensaje que muestra WordPress después de guardar.
Cómo restaurarlo desde cPanel
- Ingresá a cPanel y abrí el Administrador de archivos.
- Activá la vista de archivos ocultos.
- Ubicá la carpeta exacta de WordPress.
- Descargá el archivo actual y renombralo, por ejemplo, como
.htaccess.respaldo. - Creá un archivo nuevo llamado exactamente
.htaccess. - Pegá el bloque estándar apropiado y guardá.
- Comprobá portada, una entrada, una página, medios y
/wp-admin/.
Si los enlaces siguen mostrando 404, ingresá a Ajustes > Enlaces permanentes y revisá el aviso. Si WordPress indica que el archivo no es escribible, mostrará las reglas que deben copiarse manualmente.
Permisos y escritura del archivo
Los permisos exactos dependen de cómo esté configurado el servidor. En muchos hostings, 644 es suficiente para un archivo propiedad del usuario correcto. No uses 777 para intentar resolver el problema: concede permisos innecesarios y puede empeorar la seguridad.
Si WordPress no puede escribir aunque el archivo parezca tener permisos correctos, el inconveniente puede estar en el propietario, la configuración de PHP o las directivas AllowOverride del servidor. En hosting compartido, pedí al proveedor que lo revise.
WordPress instalado en una subcarpeta
El ejemplo anterior corresponde a la raíz. Si WordPress se abre en https://tudominio.com/blog/, las rutas y RewriteBase cambian. No copies el bloque de raíz sin adaptarlo. La forma más segura es regenerar las reglas desde el escritorio de esa instalación.
También existe el caso en que los archivos de WordPress están en una subcarpeta pero la web se muestra desde la raíz. Esa configuración utiliza reglas específicas; conservá el archivo existente y revisá Dirección de WordPress y Dirección del sitio antes de sustituirlo.
Sitios WordPress Multisite
Las redes Multisite emplean reglas diferentes según su estructura de subdominios o subdirectorios. El bloque de una instalación individual no debe copiarse sobre un Multisite. Si observás constantes como MULTISITE en wp-config.php, utilizá las reglas específicas de esa red o pedí una revisión técnica.
Cómo conservar reglas personalizadas
Un mismo archivo puede incluir redirecciones 301, protección de archivos, control de acceso, compresión, caché o bloques agregados por plugins. Restaurar el bloque de WordPress no obliga a borrar todo lo demás.
Conservá las reglas personalizadas fuera de los marcadores de WordPress y documentá su propósito. Para diagnosticar, podés desactivar temporalmente un bloque y probar, pero no elimines varias secciones a la vez. Si al restaurarlas reaparece el error, ya tendrás identificado el conjunto que debe revisarse.
Diagnóstico según el síntoma
Error 404 en entradas y páginas
Comprobá que mod_rewrite esté disponible, que el bloque exista y que el servidor permita procesar reglas. Volvé a Enlaces permanentes sin cambiar la estructura.
Error interno 500
Suele indicar una directiva inválida, un módulo no disponible o un error de sintaxis. Renombrá temporalmente el archivo para recuperar acceso, revisá el registro de errores y compará el último cambio.
Bucle de redirecciones
Revisá reglas duplicadas de HTTP a HTTPS, dominio con o sin www, plugins SSL y configuración del CDN. No agregues otra redirección antes de identificar cuál ya está activa.
Los cambios no se reflejan
Purgá la caché del navegador, WordPress y CDN. Verificá también que estés editando el archivo de la instalación que responde al dominio.
Apache 2.4 y reglas antiguas
Un .htaccess creado para una configuración antigua puede incluir directivas obsoletas. Las reglas actuales de control de acceso suelen utilizar Require en lugar de la sintaxis histórica Order, Allow y Deny. No modernices automáticamente un bloque sin entender su función.
Guías relacionadas
- Cómo bloquear el acceso a archivos sensibles con .htaccess.
- Cómo activar caché y compresión con .htaccess.
- Cómo solucionar el aviso de mantenimiento de WordPress.
