Problemas con Gutenberg en WordPress: Cómo solucionarlos

¡Hola! Soy el técnico de soporte amigable. Sé que el editor de bloques Gutenberg de WordPress puede ser un poco complicado a veces, especialmente cuando deja de funcionar como esperamos. Pero no te preocupes, porque hoy vamos a resolver los problemas más comunes paso a paso. Este artículo es como tu manual de emergencia: fácil de seguir, sin tecnicismos raros y con soluciones que puedes aplicar aunque no seas un experto.

Vamos allá.

¿Por qué falla el editor de bloques Gutenberg? Causas principales

Antes de lanzarnos a solucionar, es bueno entender por qué ocurren los problemas Gutenberg. Las causas más frecuentes suelen ser:

Conflictos con plugins (especialmente los que modifican el editor o añaden campos personalizados).
Temas que no son 100% compatibles con el editor de bloques.
Caché del navegador o del servidor que guarda versiones antiguas de los archivos.
Errores de JavaScript (el editor depende mucho de este lenguaje).
Límites de memoria en PHP (cuando tu web tiene poco recurso asignado).

Ahora veamos cómo atacar cada uno de estos puntos.

## Solución rápida: El editor no carga o se queda en blanco

Este es el problema más temido. Abres una entrada y solo ves una pantalla blanca o un mensaje de error. Aquí tienes los pasos para solucionarlo:

1. Activar el modo de depuración (solo para identificar el error)

Añade estas líneas al archivo wp-config.php (lo encuentras en la raíz de tu instalación de WordPress, accediendo por FTP o el gestor de archivos de tu panel de control):

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Luego, accede al editor de bloques otra vez. El error se escribirá en un archivo debug.log dentro de la carpeta /wp-content/. Ábrelo y busca líneas con la palabra "error". Eso te dará pistas sobre qué plugin o tema está causando el fallo Gutenberg.

[WARNING] No olvides desactivar el modo debug cuando termines, o tu web mostrará errores a los visitantes. Simplemente borra esas líneas o cambia true por false.

2. Desactivar todos los plugins (prueba de conflicto)

Esta es la prueba reina. Ve a Plugins > Plugins instalados, selecciona todos y en "Acciones en bloque" elige "Desactivar". Luego vuelve al editor. Si funciona, el problema está en uno de tus plugins.

Actívalos de uno en uno, y después de cada activación, revisa el editor. Cuando vuelva a fallar, ¡ya sabes quién es el culpable!

[TIP] Los plugins de caché, seguridad (como Wordfence) y los que añaden botones extra al editor (como Advanced Custom Fields o Elementor) son los que más suelen generar problemas Gutenberg.

3. Cambiar temporalmente a un tema por defecto (Twenty Twenty-Four)

Los temas pueden tener estilos o scripts que interfieran. Ve a Apariencia > Temas y activa uno de los temas por defecto de WordPress (Twenty Twenty-Four, Twenty Twenty-Three...). Si el editor funciona, tu tema anterior es el problema. Contacta al desarrollador o busca una actualización.

## El editor de bloques WordPress se ve raro: botones que no responden o se duplican

A veces el editor carga, pero los botones no funcionan, los bloques se duplican o ves mensajes como "Error al guardar". Aquí las soluciones:

1. Limpiar la caché del navegador y de WordPress

En tu navegador (Chrome, Firefox, Edge), presiona Ctrl + Mayús + Supr y selecciona "Caché e imágenes". Limpia solo eso (no contraseñas ni cookies).
Si usas un plugin de caché (como WP Rocket, W3 Total Cache o LiteSpeed Cache), ve a su configuración y pulsa "Borrar caché".
Si tu hosting tiene su propio sistema de caché (como el que ofrece Syspanel), accede a tu panel de control (puerto 2106) y busca la opción "Limpiar caché". Esto es especialmente útil si usas Syspanel para gestionar tu servidor.

2. Desactivar el modo de edición clásica (si usas plugin)

Algunos plugins como "Classic Editor" pueden forzar a WordPress a usar el editor antiguo. Ve a Ajustes > Escritura y asegúrate de que está seleccionado "Editor de bloques (Gutenberg)". Si tienes el plugin "Classic Editor", desactívalo o configúralo para que permita el editor de bloques.

3. Aumentar la memoria de PHP

Si el editor se queda colgado al cargar muchos bloques, es posible que falte memoria. Añade esta línea a wp-config.php (justo antes del comentario "Eso es todo"):

define('WP_MEMORY_LIMIT', '256M');

Si no funciona, pide a tu hosting que aumente el límite a 256 MB o más. En Syspanel puedes hacerlo desde Ajustes de PHP > Memory Limit.

[INFO] No es necesario ser un experto en servidores. La mayoría de los hostings permiten hacer esto desde el panel de control.

## El editor no guarda los cambios: "Error al guardar" o "Fallo en la conexión"

Este es otro clásico. Puede deberse a problemas de permisos de archivos, bloqueo de seguridad o conflictos con el plugin de seguridad.

1. Revisar los permisos de la carpeta wp-content

Conéctate por FTP o desde el gestor de archivos de Syspanel (puerto 2106). Busca la carpeta wp-content. Haz clic derecho > "Permisos de archivo" y asegúrate de que tenga 755 para carpetas y 644 para archivos. Si no, cámbialo.

2. Desactivar temporalmente el plugin de seguridad

Plugins como Wordfence, iThemes Security o Sucuri pueden bloquear las peticiones AJAX del editor. Desactívalos, prueba a guardar y, si funciona, agrega una excepción en la configuración del plugin para que permita las rutas de administración de WordPress.

3. Verificar el límite de tiempo de ejecución (max_execution_time)

Si tu web es lenta, el servidor puede cortar la conexión antes de que termine de guardar. En Syspanel, ve a Ajustes de PHP y aumenta max_execution_time a 300 (5 minutos). También puedes añadir esto en wp-config.php:

set_time_limit(300);

## Los bloques no se ven igual en el editor y en la web

Esto suele pasar cuando el tema o algún plugin sobreescribe los estilos de Gutenberg. No es un error como tal, pero es molesto.

1. Desactivar "Reducir CSS/JS" en plugins de optimización

Plugins como Autoptimize o WP Rocket a veces minimizan los estilos del editor y los rompen. En su configuración, busca opciones como "Optimizar código CSS del editor" o "Combinar JS del administrador" y desactívalas.

2. Usar el bloque "Grupo" con clase personalizada

Si el estilo se ve diferente, añade una clase CSS personalizada al bloque (en la barra lateral derecha > Avanzado > Clase CSS adicional) y luego ajusta el estilo en el archivo style.css de tu tema hijo.

[TIP] Siempre es mejor usar un tema hijo para no perder las personalizaciones al actualizar el tema padre.

## Preguntas frecuentes (FAQ) sobre problemas Gutenberg

¿Puedo volver al editor clásico si Gutenberg me da muchos problemas?

Sí. Instala el plugin "Classic Editor" y, en Ajustes > Escritura, elige "Editor clásico" como predeterminado. Pero te recomiendo que primero intentes solucionar el fallo Gutenberg, porque el editor de bloques es el futuro y tiene muchas ventajas.

¿Los problemas Gutenberg afectan al SEO?

No directamente, pero si el editor no guarda cambios o se ve mal, puede que no puedas publicar contenido nuevo o actualizar el existente, lo que sí perjudica tu SEO. Además, un editor roto puede generar errores 500 o contenido duplicado si no se guarda bien.

¿Cómo sé si mi hosting es compatible con Gutenberg?

La mayoría de los hostings modernos lo son. Si usas Syspanel (puerto 2106), asegúrate de tener PHP 7.4 o superior y al menos 256 MB de memoria. También es bueno tener activado allow_url_fopen para que el editor cargue recursos externos.

¿Qué hago si después de todo el editor sigue sin funcionar?

Prueba a reinstalar WordPress manualmente (sin borrar tus datos). Descarga la última versión desde wordpress.org, descomprime y sube la carpeta wp-admin y wp-includes por FTP, reemplazando los archivos. Esto no toca tu contenido ni los plugins.

## Conclusión: No temas al editor de bloques

Los problemas Gutenberg tienen solución, y la mayoría de las veces son fáciles de arreglar con un poco de paciencia y siguiendo estos pasos. Recuerda:

Siempre empieza por desactivar plugins y cambiar de tema.
Limpia la caché (navegador, WordPress y servidor).
Aumenta la memoria PHP si es necesario.
Si todo falla, pide ayuda a tu hosting (especialmente si usas Syspanel, que tiene soporte técnico incluido).

Ahora ya estás listo para enfrentarte al editor de bloques WordPress sin miedo. Si te surge otra duda, aquí estoy para ayudarte. ¡A crear contenido de calidad!